Skip to content

Commands And Permissions

neoramm edited this page Nov 5, 2026 · 1 revision

Commands and Permissions

MetaEnchants has two commands: /forceenchant and /metaenchants. The game's own /enchant command also works with your enchantments, and your enchantments appear when you press Tab.

/forceenchant

/forceenchant <targets> <enchantment> [level]

It works exactly like the normal /enchant command, with one big difference: it ignores the maximum level. You can give any enchantment, including vanilla ones, a level up to 255.

/forceenchant @s minecraft:sharpness 50
/forceenchant @s metaenchants:vampirism 20
/forceenchant Steve minecraft:protection 100

How it behaves:

  • It works on the item in the main hand of the targets (players, or any living thing holding an item).
  • <targets> can be a player name or a selector like @s, @a or @e[type=zombie].
  • level is optional. Without it the level is 1.
  • It sets exactly the level you write. Unlike /enchant, it can also lower a level, and 0 removes the enchantment.
  • The item must still be able to carry the enchantment (a sword cannot get Efficiency), and the enchantment must not be incompatible with the ones the item already has. If that is not true, you get the same error messages as /enchant.
  • The permission is metaenchants.command.forceenchant (operators by default).

Levels above the maximum are fully functional. See Levels Above the Maximum.

The normal /enchant

Vanilla /enchant works with your enchantments too, with the usual rule: the level cannot go above the enchantment's max-level.

/enchant @s metaenchants:vampirism 3

/metaenchants

The main command of the plugin. It also answers to /menchants and /mench.

For everyone (metaenchants.command.use)

Command What it does
/metaenchants or /metaenchants menu Opens the menu with all the enchantments.
/metaenchants item Opens the menu with only the enchantments that the item in your hand accepts.
/metaenchants list Lists all the enchantments in the chat, with rarity and maximum level.
/metaenchants info <enchantment> Opens the detail menu of an enchantment. From the console it writes the details in the chat: description, rarity, levels, weight, anvil cost, slots, items, incompatibilities and where it appears, with the chance when it is below 100%.

Descriptions (metaenchants.command.descriptions, everyone by default)

Command What it does
/metaenchants descriptions Hides the descriptions of enchantments in your item tooltips, or shows them again. It is remembered when you leave. Needs tooltip.descriptions.player-toggle: true.

Souls, shops and kits (everyone by default)

Command Permission What it does
/metaenchants souls metaenchants.command.souls Shows the souls of the held item.
/metaenchants souls withdraw <amount> metaenchants.command.souls Turns souls of the held item into a soul gem.
/metaenchants enchanter metaenchants.command.enchanter Opens the Enchanter shop.
/metaenchants tinkerer metaenchants.command.tinkerer Opens the Tinkerer.
/metaenchants alchemist metaenchants.command.alchemist Opens the Alchemist.
/metaenchants kit [kit] metaenchants.command.kit Opens the kit menu, or claims a kit. Each kit can also need metaenchants.kit.<id>.

For administrators (metaenchants.command.admin)

Command What it does
/metaenchants give <players> <enchantment> [level] Gives an enchanted book. The level is 1 by default and can be up to 255. The book has the look and rates of the enchantment.
/metaenchants randombook <players> [rarity] Gives each player a book of a random enchantment at a random level, optionally of one rarity. See Random books.
/metaenchants apply <enchantment> [level] Puts the enchantment on the item in your hand, following the rules (requirements, limits, incompatibilities), without price or rates.
/metaenchants remove <targets> <enchantment> Removes the enchantment from the item in the main hand of the targets.
/metaenchants open <players> [item] Opens the enchantment menu for other players. With item, only the enchantments that their held item accepts.
/metaenchants giveitem <players> <id> [amount] [value] Gives a special item of items.yml. value sets the value of dusts, orbs and soul gems.
/metaenchants giveset <players> <set> [piece] Gives the pieces of an armor set or weapon, or one piece.
/metaenchants givekit <players> <kit> Gives a kit without waiting time or permission.
/metaenchants resetkit <players> <kit> Lets the players claim a kit again right away.
/metaenchants souls set <amount> Sets the souls of the held item.
/metaenchants inspect Shows the enchantments of this plugin on the item in your hand.
/metaenchants convert [players] Turns enchantments of AdvancedEnchantments into MetaEnchants enchantments, on the item in your hand or in the inventories of players. See Items players already have.
/metaenchants lastchanged Lists what the last load or reload reported: things that need a restart, new or deleted files, unknown enchantments in requires...
/metaenchants reload Reloads config.yml, the language files, the menus, items.yml, sets, kits, and the descriptions, icons, placeholders and triggers of all enchantments.

<enchantment> accepts the full id (metaenchants:vampirism) and Tab completes it. info only accepts enchantments of this plugin, so Tab only suggests those; typing part of the name, like vamp, is enough to find it.

<players> and <targets> accept names and selectors. If nobody matches, the command stops with the usual error of the game ("No player was found") and does nothing.

If /metaenchants reload finds a mistake, it tells you the number of errors and keeps the previous version. The console has the details. See Fixing Problems.

The menu

/metaenchants opens the list of enchantments (with the default menu, 45 per page):

  • Hover an enchantment to see its description and details.
  • Click an enchantment to open its detail: what it does, its numbers and a book for each level. Clicking a book gives it to you.
  • Shift + click in the list gives you a book at the maximum level.
  • Taking books needs the permission metaenchants.menu.take (operators by default); without it the menu is only for looking. Books from the menu always have 100% success and 0% destroy rates.
  • The arrows change the page, the name tag filters by rarity and the comparator by type (click again for the next one, and once more to see all), and the barrier closes the menu.

You can change the look and every text of both menus in Menu and Messages.

Permissions

Permission Default What it allows
metaenchants.command.use Everyone /metaenchants, its menu, list and info.
metaenchants.command.admin Operators give, randombook, giveitem, giveset, givekit, resetkit, souls set, apply, remove, open, inspect, convert, lastchanged and reload.
metaenchants.command.descriptions Everyone /metaenchants descriptions.
metaenchants.command.souls Everyone /metaenchants souls and souls withdraw.
metaenchants.command.enchanter Everyone /metaenchants enchanter.
metaenchants.command.tinkerer Everyone /metaenchants tinkerer.
metaenchants.command.alchemist Everyone /metaenchants alchemist.
metaenchants.command.kit Everyone /metaenchants kit.
metaenchants.kit.<id> Nobody Claiming a kit with permission: true, like metaenchants.kit.starter.
metaenchants.limit.<number> Nobody Another maximum of enchantments per item, like metaenchants.limit.8. The highest one wins.
metaenchants.anvil.color Operators Colors in anvil renames, with anvil.color-renames: true.
metaenchants.command.forceenchant Operators /forceenchant.
metaenchants.menu.take Operators Taking books from the menu.

Clone this wiki locally