Skip to content

Enchanter Tinkerer Alchemist

neoramm edited this page Nov 5, 2026 · 1 revision

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 with command:.

The Enchanter

The shop is the menu menus/enchanter.yml, a shaped menu. Turn it off with:

enchanter:
  enabled: false

The offers are listed under offers: and appear, in order, where the menu has content: offers:

layout:
  - "#########"
  - "#OOOOOOO#"
  - "#OOOOOOO#"
  - "####X####"

icons:
  O:
    content: offers

offer-lore:
  - ""
  - "<gray>Price: <white>%price%"
  - "<yellow>Click to buy"

offers:
  - item: {material: BOOK, name: "<aqua>Rare Book", glint: true}
    give: "metaenchants:random-book/rare"
    price: {levels: 20}
  - item: {material: MAP, name: "<white>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.
give What the player gets: metaenchants:random-book/<rarity>, metaenchants:book/<enchantment>/<level>, metaenchants:item/<id> (special items), metaenchants:set/<set>/<piece>, 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: 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.

tinkerer:
  enabled: true
  title: "<dark_gray>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. 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 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.

alchemist:
  enabled: true
  title: "<dark_gray>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, 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 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.

Clone this wiki locally