Repository navigation
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.
passive-interval: 20| Setting | Meaning |
|---|---|
passive-interval |
How many ticks pass between runs of the 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. |
disabled-worlds |
Worlds where no MetaEnchants enchantment does anything. See disabled-worlds. |
tooltip |
How enchantments look in item tooltips. See Tooltips. |
books |
The default look, stacking and rates of books. See Enchanted Books. |
apply |
Dragging books, the maximum enchantments per item and rates. See Applying Enchantments. |
enchanting-table |
Fewer enchantments per roll. See Where Enchantments Appear. |
anvil |
Anvil costs and colored renames. See The anvil. |
advancedenchantments |
Converting items enchanted by AdvancedEnchantments. See Items players already have. |
sets, kits, enchanter
|
Turn armor sets, kits and the Enchanter on or off. |
tinkerer, alchemist
|
The Tinkerer and the Alchemist. |
language |
The file of the lang/ folder the messages come from. See Languages. |
The menus live in the menus/ folder and are shaped menus: you draw them with letters.
-
menus/enchants.ymlis the list that/metaenchantsopens. -
menus/enchant-info.ymlis the detail of one enchantment. It opens when you click an enchantment in the list, and with/metaenchants info <enchantment>. -
menus/enchanter.ymlis the Enchanter shop. -
menus/kits.ymlis the kit menu.
| 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 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).
| 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. |
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.
All the messages live in the language file, under messages:. Each one is a text with colors, and some have words that are replaced.
messages:
prefix: "<dark_purple>[MetaEnchants]</dark_purple> "
players-only: "<red>Only a player can use this."
give-success: "<green>Gave %name% <green>to <white>%count%</white> 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. |
%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, souls, kits, sets and the Enchanter, Tinkerer and 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.
The plugin comes with English (lang/en-us.yml) and Spanish (lang/es-es.yml). Choose one in config.yml:
language: es-esEach message is looked up in this order, and the first one found wins:
-
messages:inconfig.yml. Use it to change one or two messages without touching the language file. - The language file in
plugins/MetaEnchants/lang/, likelang/es-es.yml. - The same language inside the plugin, for messages your file does not have.
- 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.