Repository navigation
Enchanter Tinkerer 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 shop is the menu menus/enchanter.yml, a shaped menu. Turn it off with:
enchanter:
enabled: falseThe 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.
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.
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.
| 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. |