# Menu and Messages Everything players read from MetaEnchants is in two places: the messages in the `plugins/MetaEnchants/lang` folder (one file per language), and the menus in the `plugins/MetaEnchants/menus` folder. Edit them and run `/metaenchants reload`: no restart needed. Texts support colors and styles. See [Text and Colors](../Text-And-Colors). ## Settings ```yaml passive-interval: 20 ``` | Setting | Meaning | |---|---| | `passive-interval` | How many ticks pass between runs of the [`passive`](../Passive) triggers of enchantments. 20 ticks is one second. From 1 to 1200. It only affects enchantments: MetaJobs has its own. See [Triggers for Enchantments](Triggers-For-Enchantments#events). | | `disabled-worlds` | Worlds where no MetaEnchants enchantment does anything. See [`disabled-worlds`](Creating-An-Enchantment#disabled-worlds). | | `tooltip` | How enchantments look in item tooltips. See [Tooltips](Tooltips). | | `books` | The default look, stacking and rates of books. See [Enchanted Books](Books). | | `apply` | Dragging books, the maximum enchantments per item and rates. See [Applying Enchantments](Applying-Enchantments). | | `enchanting-table` | Fewer enchantments per roll. See [Where Enchantments Appear](Where-Enchantments-Appear#fewer-enchantments-per-roll). | | `anvil` | Anvil costs and colored renames. See [The anvil](Applying-Enchantments#the-anvil). | | `advancedenchantments` | Converting items enchanted by AdvancedEnchantments. See [Items players already have](Migrating-From-AdvancedEnchantments#items-players-already-have). | | `sets`, `kits`, `enchanter` | Turn [armor sets](Armor-Sets-And-Weapons), [kits](Kits) and the [Enchanter](Enchanter-Tinkerer-Alchemist#the-enchanter) on or off. | | `tinkerer`, `alchemist` | The [Tinkerer and the Alchemist](Enchanter-Tinkerer-Alchemist). | | `language` | The file of the `lang/` folder the messages come from. See [Languages](#languages). | ## The menus The menus live in the `menus/` folder and are [shaped menus](../Shaped-Menus): you draw them with letters. - `menus/enchants.yml` is the list that `/metaenchants` opens. - `menus/enchant-info.yml` is the detail of one enchantment. It opens when you click an enchantment in the list, and with `/metaenchants info `. - `menus/enchanter.yml` is the [Enchanter](Enchanter-Tinkerer-Alchemist#the-enchanter) shop. - `menus/kits.yml` is the [kit](Kits) menu. ### The list: `enchants.yml` | Part | Meaning | |---|---| | `content: enchants` | The character where the enchantments go. If they don't fit, the menu makes pages. | | `action: filter` | Changes the rarity shown, one by one, and then back to all. | | `action: filter-type` | Changes the [type](Types) shown, one by one, and then back to all. Both filters work together. | | `enchant-lore` | Lines added under the description of each enchantment. | Clicking an enchantment opens its detail. Shift + click gives a book at the maximum level (permission `metaenchants.menu.take`). In the title and the icons you can use `%page%`, `%pages%`, `%rarity%` and `%type%` (the current filters). ### The detail: `enchant-info.yml` | Part | Meaning | |---|---| | `content: enchant` | The icon of the enchantment, with its description. | | `content: description` | The `item` of the icon with the description added to its lore. | | `content: levels` | The books from level 1 to the maximum, placed in the `order` of the menu. Clicking one gives that book (permission `metaenchants.menu.take`). | | `level-lore` | The lines of each book. `%level%` is its level. | | `action: back` | Goes back to the list, on the same page and filter. | ### Words you can use In `enchant-lore`, `level-lore` and in every text of the detail menu, these words are replaced: | Word | Replaced by | |---|---| | `%name%` | The name, with its color. | | `%id%` | The full id, like `metaenchants:vampirism`. | | `%rarity%` | The rarity name, with its color. | | `%max_level%` | The maximum level. | | `%weight%` | The weight. | | `%anvil_cost%` | The anvil cost. | | `%slots%` | The slots, separated by commas. | | `%items%` | The supported items. | | `%incompatible%` | The incompatible enchantments. | | `%obtain%` | Where it can be found, in words, with the chance when it is below 100% (for example `villagers (30%)`). | | `%treasure%` | `yes` or `no`. | | `%curse%` | `yes` or `no`. | You can also use `{player}` for the player who opens the menu. Enchantments are listed from the last rarity in `rarities.yml` to the first, and alphabetically inside each rarity. That way the rarest are the first you see. ## Messages All the messages live in the language file, under `messages:`. Each one is a text with colors, and some have words that are replaced. ```yaml messages: prefix: "[MetaEnchants] " players-only: "Only a player can use this." give-success: "Gave %name% to %count% player(s)." ``` The `prefix` is written at the start of most messages. In `list`, `info` and `inspect`, only the first line has it. | Message | When | Replaced words | |---|---|---| | `prefix` | Before most messages. | | | `players-only` | A command that needs a player is used from the console. | | | `unknown-enchant` | `info` is used with an enchantment that does not belong to this plugin. | `%name%` | | `unknown-rarity` | `randombook` with a rarity that does not exist. | `%rarity%` | | `list-header` | The title of `/metaenchants list`. | `%count%` | | `list-entry` | Each line of `/metaenchants list`. | Every word of the menu table above. | | `info-header` | The first line of `/metaenchants info`. | Every word of the menu table above. | | `give-success` | After `/metaenchants give` and `randombook`. | `%name%`, `%count%` | | `random-book-name` | The `%name%` of `give-success` after `randombook`. | | | `random-book-received` | The player who gets a random book. | `%name%` | | `random-book-none` | `randombook` found no enchantment of that rarity. | | | `item-empty` | `item` or `apply` without an item in the main hand. | | | `remove-success` | After a successful `/metaenchants remove`. | `%name%`, `%count%` | | `remove-missing` | `remove` found nothing to remove. | `%name%`, `%count%` | | `inspect-empty` | `inspect` with an item without enchantments of this plugin. | | | `inspect-header` | The first line of `inspect`. | `%count%`, `%tracked%` | | `inspect-entry` | Each enchantment in `inspect`. | `%name%`, `%level%`, `%max_level%` | | `reload-started` | A reload starts. | | | `reload-busy` | A reload is requested while another is running. | | | `reloaded` | A reload went well. | `%triggers%`, `%warnings%` | | `reload-failed` | A reload found errors. | `%errors%` | | `convert-done` | After `/metaenchants convert`. | `%count%` | | `convert-none` | `/metaenchants convert` found nothing on the item. | `%count%`, `%line%` (the data keys of the item) | | `lastchanged-none` | `lastchanged` with nothing to show. | | | `lastchanged-header` | The title of `lastchanged`. | `%count%` | | `lastchanged-entry` | Each line of `lastchanged`. | `%line%` | | `descriptions-on`, `descriptions-off` | After `/metaenchants descriptions`. | | | `apply-success` | A book was applied by dragging it, or with `apply`. | `%name%`, `%item%` | | `apply-failed` | A book failed because of its success rate. | `%item%` | | `apply-destroyed` | A book failed and the item broke. | `%item%` | | `apply-price` | The player cannot pay the price of a book. | `%price%` | | `apply-not-supported` | The item does not accept the enchantment. | `%name%` | | `apply-incompatible` | The item has an incompatible enchantment. | `%name%` (the one on the item) | | `apply-requires` | The item is missing an enchantment it `requires`. | `%name%` (the one it needs) | | `apply-limit` | The item has the most enchantments it can have. | `%name%`, `%limit%` | | `apply-type-limit` | The item has the most enchantments of that [type](Types). | `%name%` (the type), `%limit%` | | `apply-max-level` | The item already has that level or a higher one. | `%name%` | | `menu-all` | The word shown when no rarity filter is active. | | | `menu-taken` | When a player takes a book from the menu. | `%name%` | | `price-money`, `price-levels`, `price-exp`, `price-item`, `price-free` | The pieces of every `%price%`: money, levels, experience points, each item, and a price of nothing. They are joined with commas. | `%amount%`, and `%name%` in `price-item` | | `feature-off` | A command of something turned off in `config.yml`, or whose menu has errors. | | The messages of the [special items](Special-Items), [souls](Souls-And-Trackers), [kits](Kits), [sets](Armor-Sets-And-Weapons) and the [Enchanter, Tinkerer and Alchemist](Enchanter-Tinkerer-Alchemist) are listed on their pages. Messages and the `enchant-lore` and `level-lore` lines of the menus also accept values of the player who receives them, like `{player}` or `{player.level}`, and PlaceholderAPI placeholders like `%vault_eco_balance%` if PlaceholderAPI is installed. From the console there is no player, so those values are left empty. (`%tracked%` is the number of enchanted items the plugin is currently following. It is mostly useful for admins.) If you delete a message from the file, the plugin uses its original text. ## Languages The plugin comes with English (`lang/en-us.yml`) and Spanish (`lang/es-es.yml`). Choose one in `config.yml`: ```yaml language: es-es ``` Each message is looked up in this order, and the first one found wins: 1. `messages:` in `config.yml`. Use it to change one or two messages without touching the language file. 2. The language file in `plugins/MetaEnchants/lang/`, like `lang/es-es.yml`. 3. The same language inside the plugin, for messages your file does not have. 4. English inside the plugin. To add a language, copy `lang/en-us.yml` to a new file, like `lang/fr-fr.yml`, translate it, and write `language: fr-fr`. The `name` and `description` of your enchantments, the menus and `items.yml` are written by you, so they are in the language you write them in. The names of the commands do not change.