# Enchanter, Tinkerer and Alchemist Three menus where players get, trade and improve books: | Menu | Command | What players do | |---|---|---| | Enchanter | `/metaenchants enchanter` | Buy random books and special items for money, levels, experience or items. | | Tinkerer | `/metaenchants tinkerer` | Hand in enchanted items for experience, and books for dust. | | Alchemist | `/metaenchants alchemist` | Join two equal books into one of the next level, or two dusts into a stronger one. | Each one has its own permission (`metaenchants.command.enchanter`, `.tinkerer`, `.alchemist`, everyone by default) and its own switch in `config.yml`. To open them for players in other ways, run the command from an NPC plugin, a sign or a [menu](../Shaped-Menus) with `command:`. ## The Enchanter The shop is the menu `menus/enchanter.yml`, a [shaped menu](../Shaped-Menus). Turn it off with: ```yaml enchanter: enabled: false ``` The offers are listed under `offers:` and appear, in order, where the menu has `content: offers`: ```yaml layout: - "#########" - "#OOOOOOO#" - "#OOOOOOO#" - "####X####" icons: O: content: offers offer-lore: - "" - "Price: %price%" - "Click to buy" offers: - item: {material: BOOK, name: "Rare Book", glint: true} give: "metaenchants:random-book/rare" price: {levels: 20} - item: {material: MAP, name: "White Scroll"} give: "metaenchants:item/white-scroll" amount: 2 price: {money: 500, items: [DIAMOND 2]} ``` | Option | Meaning | |---|---| | `item` | The icon in the menu. Same format as any item; see [Items](../Items). | | `give` | What the player gets: `metaenchants:random-book/`, `metaenchants:book//`, `metaenchants:item/` ([special items](Special-Items)), `metaenchants:set//`, a material, or an item of another plugin like `oraxen:ruby`. | | `amount` | How many. 1 by default. | | `price` | What it costs. Same format as the [price of books](Applying-Enchantments#price): `money`, `levels`, `exp` (experience points) and `items`. Without it, the offer is free. | `offer-lore` is added under the icon of every offer: `%price%` is its price and `%amount%` how many the player gets. A random book is chosen when the player buys it, so every purchase is a surprise. Players in creative mode do not pay. ## The Tinkerer A chest of six rows. Players put enchanted items and enchanted books in the top five rows and click **Accept**. The button shows what they will get before they accept. Things the Tinkerer does not take go back to the player, and closing the menu gives everything back. ```yaml tinkerer: enabled: true title: "Tinkerer" experience: default: 20 vanilla: 10 legendary: 60 books: default: "metaenchants:item/secret-dust" ``` | Setting | Meaning | |---|---| | `title` | The title of the chest. | | `experience` | Experience points paid for each level of each enchantment on an **item**, by [rarity](Rarities). `vanilla` is for vanilla enchantments and `default` for rarities not listed. A sword with Vampirism III of an epic rarity pays 3 × 20 = 60 points. | | `books` | What each enchanted **book** is traded for, by the rarity of its enchantment (the rarest one, if it has several). Anything that can be given, like in the Enchanter. `none` means the Tinkerer does not take books of that rarity. | Items without enchantments, items that would pay nothing and [special items](Special-Items) are given back. ## The Alchemist A small chest with two slots for the player's items, a preview of the result in the middle and a **Combine** button below. ```yaml alchemist: enabled: true title: "Alchemist" books: true book-price: levels: 2 per-level: true dusts: true max-dust: 100 dust-price: levels: 1 ``` | Setting | Meaning | |---|---| | `books` | Two books with the same single enchantment at the same level become one book of the next level. It does not go above the maximum level. If both books have [success and destroy rates](Books#success-and-destroy-rates), the new book has the average of each. | | `book-price` | What combining books costs. With `per-level: true` it is multiplied by the new level: two Vampirism II books cost 2 × 3 = 6 levels. | | `dusts` | Two [dusts](Special-Items#magic-dust) of the same kind become one with both values added. | | `max-dust` | The highest value a joined dust can have. | | `dust-price` | What joining dusts costs. | Only one book or dust goes in each slot; stacks are not combined. The result goes to the player's inventory, and closing the menu gives back what is still in the slots. ## Messages | Message | When | Replaced words | |---|---|---| | `enchanter-bought` | Something was bought. | `%name%` | | `enchanter-price` | The player cannot pay. | `%price%` | | `tinkerer-accept` | The name of the Accept button. | `%amount%` (experience), `%count%` (items) | | `tinkerer-accept-lore` | The line under the Accept button. | `%amount%`, `%count%` | | `tinkerer-cancel` | The name of the Cancel button. | | | `tinkerer-done` | After accepting. | `%amount%`, `%count%` | | `tinkerer-empty` | Accept with nothing in the chest. | | | `tinkerer-returned` | Some things were given back. | | | `alchemist-combine` | The name of the Combine button when the two items can be joined. | | | `alchemist-combine-lore` | The line under the Combine button. | `%price%` | | `alchemist-waiting` | The name of the button while the two items cannot be joined. | | | `alchemist-done` | After combining. | `%name%` (the result) | | `alchemist-invalid` | Combine with two items that cannot be joined. | | | `alchemist-price` | The player cannot pay. | `%price%` | | `feature-off` | The command of something turned off, or a menu file with errors. | |