Disenchantment

# Disenchantment (https://img.shields.io/github/v/release/H7KZ/Disenchantment?style=flat-square)](https://github.com/H7KZ/Disenchantment/releases/latest) (https://img.shields.io/github/license/H7KZ/Disenchantment?style=flat-square)](LICENSE) (https://img.shields.io/badge/Minecraft-1.18--1.21.+-brightgreen?style=flat-square)](https://www.spigotmc.org/resources/110741) (https://img.shields.io/badge/Java-21%2B-orange?style=flat-square)](https://adoptium.net/) (https://img.shields.io/modrinth/dt/disenchantment?style=flat-square&label=Modrinth)](https://modrinth.com/plugin/disenchantment) (https://img.shields.io/spiget/downloads/110741)](https://www.spigotmc.org/resources/110741) (https://img.shields.io/bstats/players/19058)](https://bstats.org/plugin/bukkit/Disenchantment/19058) (https://img.shields.io/bstats/servers/19058)](https://bstats.org/plugin/bukkit/Disenchantment/19058) !(https://raw.githubusercontent.com/H7KZ/Disenchantment/refs/heads/master/assets/event.png) A lightweight Spigot/Paper/Folia plugin that enhances the vanilla enchanting system by adding powerful, intuitive mechanics to the standard anvil. Give your players the tools to manage their enchantments efficiently, without adding any new blocks or complex systems. ## 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 clean. 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. This 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 shatter operation, in addition to (or instead of) the XP cost. - Requires (https://www.spigotmc.org/resources/34315/) 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.+** ### Download Get the latest release from any of these sources: - (https://github.com/H7KZ/Disenchantment/releases/latest) - (https://www.spigotmc.org/resources/110741) - (https://modrinth.com/plugin/disenchantment) ### Setup 1. Download the `Disenchantment-<version>.jar` file. 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 ingame admin UI with `/disenchantment gui`. ## Supported Custom Enchantment Plugins | Plugin | 1.21.8 - 1.21.11+ | 1.21.7 - 1.21.5 | 1.21.4 - 1.21 | 1.20.6 - 1.20.5 | 1.20.4 - 1.18 | |------------------------------------------------------------------|:-----------------:|:---------------:|:-------------:|:---------------:|:-------------:| | (https://www.spigotmc.org/resources/43058) | ✓ | ✓ | ✓ | ✓ | ✓ | | (https://www.spigotmc.org/resources/79573) | ✓ | ✓ | ✓ | ✓ | ✓ | | (https://www.spigotmc.org/resources/86747) |