Disenchantment [1.18 - 26.+] Custom Enchantment Support

Features

Disenchanting: Reclaim Your Enchantments

Ever found a nearly-broken tool with a rare enchantment you wish you could save? The disenchanting mechanic provides a straightforward solution.

• Simple Anvil Process — Place the enchanted item in the first anvil slot and a book in the second.
• Controlled Transfer — For a configurable XP cost, the enchantment is removed from the item and transferred to the book, leaving the original item intact. Players can salvage valuable enchantments from worn-out or obsolete gear.

Book Splitting: Divide Your Enchanted Books

Need just one enchantment from a book with many? Book Splitting allows for precise, strategic use of your enchanted books.

• Intuitive Splitting — Combine a multi-enchantment book with a blank book on the anvil to lift a single enchantment off the original.
• Strategic Application — Results in two books: the original with one less enchantment, and a new book with the single enchantment that was split off. Enables targeted application and a more dynamic server economy.

Economy Integration

Server owners can optionally require players to pay an in-game currency cost for each disenchant or book splitting operation, in addition to (or instead of) the XP cost.

• Requires Vault and any compatible economy plugin (EssentialsX, CMI, PlayerPoints, etc.).
• Configurable flat cost per operation, independently for disenchanting and book splitting.
• Cost is previewed in the action bar while the player has a result ready in the anvil.
• Disabled by default — zero impact if Vault is not installed.

Why Choose This Plugin?

• Truly Vanilla-Friendly — No new machines or confusing UIs. All functions are handled through the standard anvil.
• Lightweight & Efficient — Adds valuable features without causing server lag or performance issues.
• Fully Customizable — Configure XP costs, economy costs, per-world/per-enchantment/per-material restrictions, event priorities, and more.
• Economy Ready — Optional Vault integration lets server owners add a currency cost to every operation.
• Folia Support — Compatible with the Folia server software for regionized multithreading.

Installation

Requirements

• Java 21 or newer
• Spigot, Paper, or Folia server running Minecraft 1.18 – 1.21.+

Setup

1. Download the Disenchantment-<version>.jar file from any source above.
2. Place the JAR in your server's plugins/ directory.
3. Restart the server.
4. Edit plugins/Disenchantment/config.yml to customize settings, or use the in-game admin UI with /disenchantment gui.

Supported Custom Enchantment Plugins

• AdvancedEnchantments — 1.18 – 1.21.11+ ✓
• EcoEnchants — 1.18 – 1.21.11+ ✓
• EnchantsSquared — 1.18 – 1.21.11+ ✓
• UberEnchant — 1.18 – 1.21.11+ ✓
• ExcellentEnchants — 1.21 – 1.21.11+ ✓
• Vane — 1.21 – 1.21.11+ ✓
• Zenchantments — 1.21 – 1.21.11+ ✓

Documentation

• Commands — Full command reference with usage and permissions
• Permissions — All permission nodes and their defaults
• Configuration — Complete configuration reference
• FAQ — Frequently asked questions and troubleshooting
• API Docs — Public events and PlaceholderAPI (for plugin developers)

Building from Source

The output JAR is written to target/Disenchantment-<version>.jar. See CONTRIBUTING.md for prerequisites and development setup.

License

This project is licensed under the MIT License.