Skip to content

Menu And Messages

neoramm edited this page Nov 5, 2026 · 1 revision

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.

Settings

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

The menus live in the menus/ folder and are 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 <enchantment>.
  • menus/enchanter.yml is the Enchanter shop.
  • menus/kits.yml is the kit 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 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.

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.

Languages

The plugin comes with English (lang/en-us.yml) and Spanish (lang/es-es.yml). Choose one in config.yml:

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.

Clone this wiki locally