Repository navigation
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 <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,@aor@e[type=zombie]. -
levelis optional. Without it the level is 1. - It sets exactly the level you write. Unlike
/enchant, it can also lower a level, and0removes 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.
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
The main command of the plugin. It also answers to /menchants and /mench.
| 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%. |
| 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. |
| 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>. |
| 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.
/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.
| 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. |