Skip to content
neoramm edited this page Nov 5, 2026 · 5 revisions

MetaEnchants Wiki

MetaEnchants lets you create your own enchantments: things like Vampirism, Seismic Slam or Frost, with the behavior you choose.

They are not fake. Your enchantments are real enchantments of the game:

  • They show up in the enchanting table, in villager trades and in loot chests, just like Sharpness or Mending, and you decide how often.
  • You can use the normal /enchant command with them, and they work on the anvil.
  • They have levels, a rarity, a maximum level and incompatibilities with other enchantments, like any other.
  • One item can carry as many of them as you want, together with the vanilla ones, or as many as you allow.
  • Item tooltips show what each enchantment does, and players can apply books by dragging them onto items.

What an enchantment does is written as small rules in a text file: "when the player hits something, with a 20% chance, push it up and deal extra damage." No programming needed.

What can an enchantment do?

Anything you can describe with the rule language: heal, hurt, push, give potion effects, repair or damage items, send messages, play sounds, run commands, change how much damage is dealt, react when you are hit, when you shoot a bow, or just keep working in the background while you wear it.

Where to start

New here? Follow these pages in order:

  1. Getting Started: installing and the folders.
  2. Creating an Enchantment: every option of an enchantment file.
  3. Triggers for Enchantments: what an enchantment does and when.
  4. Rarities: the categories that give a color and default numbers.
  5. Where Enchantments Appear: table, villagers, chests and more.
  6. Items, Slots and Incompatibilities: which items accept it and where it works.
  7. Commands and Permissions: /forceenchant, /metaenchants and the menu.
  8. Levels Above the Maximum: how higher levels work.
  9. Menu and Messages: customize the menu and every message.
  10. Tooltips: descriptions, numerals and order in item tooltips.
  11. Enchanted Books: what books look like, stacking books, success and destroy rates, random books.
  12. Applying Enchantments: dragging books onto items, prices, requirements, limits, anvil, grindstone and table.
  13. Types: limits per kind of enchantment.
  14. Changing Vanilla Enchantments: new maximum levels, names and descriptions for vanilla enchantments.
  15. PlaceholderAPI: MetaEnchants values in other plugins.

Optional systems, each one can be turned off:

  1. Special Items: white, holy and black scrolls, transmog, magic dust, orbs, boxes and rename tags.
  2. Souls and Trackers: items that count kills, blocks and fish, and souls that enchantments spend.
  3. Enchanter, Tinkerer and Alchemist: buy books, trade items and books, combine books and dust.
  4. Armor Sets and Custom Weapons: bonuses for wearing a full set or holding a special weapon.
  5. Kits: packs of books and items with a waiting time.

Messages can be in several languages.

Handy references:

The rule language

What an enchantment does is written in the same language used by other plugins that share the Trigger Engine. Events, conditions, actions, values and calculations are all explained in the Trigger Engine Wiki. This wiki shows how those pieces fit inside an enchantment and covers what is special about them.

For plugin developers

You can also define enchantments directly in code. See the Dev Guides.

Clone this wiki locally