Disenchantment

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 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.+

Download

Get the latest release from any of these sources:

Setup

Download the Disenchantment-<version>.jar file.
Place the JAR in your server's plugins/ directory.
Restart the server.
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
AdvancedEnchantments	✓	✓	✓	✓	✓
EcoEnchants	✓	✓	✓	✓	✓
EnchantsSquared	✓	✓	✓	✓	✓
UberEnchant	✓	✓	✓	✓	✓
ExcellentEnchants	✓	✓	✓	-	-
Vane	✓	✓	✓	-	-
Zenchantments	✓	✓	✓	-	-

Note: EcoEnchants V13.0.0 is supported natively with Disenchantment 6.4.0+. No patched build is required.

Documentation

Full documentation lives in the docs/ directory.

Audience	Start here
Server admins & players	`docs/user/` — installation, commands, config, permissions, FAQ
Plugin developers (API)	`docs/api/` — public events, PlaceholderAPI
Contributors & engineers	`docs/engineering/` — architecture, setup, contributing
Deep internals / LLM agents	`docs/internals/` — NMS, events, GUI, config system

Quick links:

Document	Description
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

Building from Source

mvn clean package

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

Contributing

Contributions are welcome! Please read the Contributing Guidelines before opening a pull request.

License

This project is licensed under the MIT License.

Dependencies and Attribution

Bundled Libraries

The following libraries are included in the distributed plugin JAR:

Library	License	Author	Purpose
bStats	MIT	Bastian Oppermann	Anonymous plugin usage statistics (optional, can be disabled in config)

Runtime Dependencies (Provided by Server)

These APIs are provided by the Minecraft server and are not bundled with the plugin:

API	License	Link
Spigot API	GPL-3.0	github.com/SpigotMC/Spigot-API
Paper API	GPL-3.0	github.com/PaperMC/Paper
Folia API	GPL-3.0	github.com/PaperMC/Folia

Optional Runtime Dependencies

These plugins are not required but unlock additional features when present:

Plugin	License	Link	Purpose
Vault	LGPL-3.0	github.com/MilkBowl/Vault	Economy integration — charge players a currency cost per operation

Custom Enchantment Plugin Adapters (Compile-time Only)

Disenchantment includes adapters for the following plugins. These plugins are NOT bundled or distributed with Disenchantment. They are used only as compile-time dependencies to create integration adapters. Server administrators must obtain and install these plugins separately if they wish to use the integration features.

Plugin	License	Author	Link
AdvancedEnchantments	Proprietary	GC-spigot	github.com/GC-spigot/AdvancedEnchantments
EcoEnchants	GPL-3.0	Auxilor	github.com/Auxilor/EcoEnchants
EnchantsSquared	No public license	Athlaeos	github.com/Athlaeos/EnchantsSquared
UberEnchant	GPL-3.0	sciguymjm	github.com/Sciguymjm/UberEnchant
ExcellentEnchants	GPL-3.0	NightExpress	github.com/nulli0n/ExcellentEnchants-spigot
Zenchantments	GPL-3.0	Zedly	github.com/Zedly/Zenchantments
Vane	MIT	oddlama	github.com/oddlama/vane

Note: The adapters created by Disenchantment merely interface with these plugins' public APIs and do not contain any code from the plugins themselves. Each plugin retains its own independent license.

Build Tools

The following tools are used during the build process but are not included in the final plugin:

Tool	License	Link
Maven Shade Plugin	Apache-2.0	maven.apache.org/plugins/maven-shade-plugin
Maven Compiler Plugin	Apache-2.0	maven.apache.org/plugins/maven-compiler-plugin