# 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 [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). - `` 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](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 ` | 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](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](Souls-And-Trackers) of the held item. | | `/metaenchants souls withdraw ` | `metaenchants.command.souls` | Turns souls of the held item into a soul gem. | | `/metaenchants enchanter` | `metaenchants.command.enchanter` | Opens the [Enchanter](Enchanter-Tinkerer-Alchemist#the-enchanter) shop. | | `/metaenchants tinkerer` | `metaenchants.command.tinkerer` | Opens the [Tinkerer](Enchanter-Tinkerer-Alchemist#the-tinkerer). | | `/metaenchants alchemist` | `metaenchants.command.alchemist` | Opens the [Alchemist](Enchanter-Tinkerer-Alchemist#the-alchemist). | | `/metaenchants kit [kit]` | `metaenchants.command.kit` | Opens the [kit](Kits) menu, or claims a kit. Each kit can also need `metaenchants.kit.`. | ### For administrators (`metaenchants.command.admin`) | Command | What it does | |---|---| | `/metaenchants give [level]` | Gives an enchanted book. The level is 1 by default and can be up to 255. The book has the [look and rates](Books) of the enchantment. | | `/metaenchants randombook [rarity]` | Gives each player a book of a random enchantment at a random level, optionally of one rarity. See [Random books](Books#random-books). | | `/metaenchants apply [level]` | Puts the enchantment on the item in your hand, following the [rules](Applying-Enchantments) (requirements, limits, incompatibilities), without price or rates. | | `/metaenchants remove ` | Removes the enchantment from the item in the main hand of the targets. | | `/metaenchants open [item]` | Opens the enchantment menu for other players. With `item`, only the enchantments that their held item accepts. | | `/metaenchants giveitem [amount] [value]` | Gives a [special item](Special-Items) of `items.yml`. `value` sets the value of dusts, orbs and soul gems. | | `/metaenchants giveset [piece]` | Gives the pieces of an [armor set or weapon](Armor-Sets-And-Weapons), or one piece. | | `/metaenchants givekit ` | Gives a [kit](Kits) without waiting time or permission. | | `/metaenchants resetkit ` | Lets the players claim a kit again right away. | | `/metaenchants souls set ` | 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](Migrating-From-AdvancedEnchantments#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. | `` 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. `` and `` 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](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](Books#success-and-destroy-rates). - The arrows change the page, the name tag filters by rarity and the comparator by [type](Types) (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](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.` | Nobody | Claiming a kit with `permission: true`, like `metaenchants.kit.starter`. | | `metaenchants.limit.` | Nobody | Another [maximum of enchantments per item](Applying-Enchantments#maximum-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. |