SinceEnchantments Documentation
Anvils and Extractors
Anvils and Extractors
Anvil Book Combining
Two SinceEnchantments books can be combined if:
- Both books have the same enchantment ID.
- Both books have the same level.
- Next level does not exceed max level.
Result:
- Level increases by 1.
- Success rate is averaged.
- Destroy/failure rate is averaged.
- XP cost uses
settings.anvil-xp-combine-books.
Config:
settings:
anvil-xp-combine-books: 5
Anvil Book Application
Books can be applied through anvils when valid.
Validation includes:
- Target material
- Whitelist
- Requirements
- Conflicts
- Slot capacity
- Max level
Config:
settings:
anvil-xp-apply-book: 3
MMOCore Experience Sync
If MMOCore is hooked, SinceEnchantments syncs vanilla level state after anvil result take.
Logs:
Successfully hooked into MMOCore API (Latest Version) for Anvil EXP sync!
Successfully hooked into MMOCore API (Legacy Version)!
Random Extractor
Command:
/se giveextractor Steve random 1
Behavior:
- Drag extractor onto enchanted item.
- Plugin chooses one enchantment randomly.
- Removes it from the item.
- Gives an enchantment book with level preserved.
- Extractor is consumed.
Specific Extractor
Command:
/se giveextractor Steve specific 1
Behavior:
- Drag extractor onto enchanted item.
- Extractor is consumed temporarily.
- Player chooses an enchantment.
- Selected enchant is removed.
- Book is given.
- If cancelled, extractor is refunded.
Extractor Modes
settings:
extractor-mode: "DIALOG"
| Mode | Description |
|---|---|
DIALOG |
Modern Paper Dialog UI |
GUI |
Legacy chest GUI |
Dialog Config
File:
gui.yml
dialog:
extractor:
title: "<dark_gray><bold>Extract Enchantment"
body: "<gray>Choose an enchantment from your item below\n<gray>to extract it safely into a book."
columns: 3
Legacy GUI Config
gui:
extractor:
title: "&8Select Enchant (Page %page%)"
size: 54
GUI size must be a multiple of 9.
Extraction Safety
Extraction is blocked if:
- Item is stacked.
- Item is locked.
- Item has no enchantments.
- Selected enchant no longer exists by the time the player clicks.