
Right Enchant, Wrong Item? Never Again.

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.
Ever found a nearly-broken tool with a rare enchantment you wish you could save? The disenchanting mechanic provides a straightforward solution.
Need just one enchantment from a book with many? Book Splitting allows for precise, strategic use of your enchanted books.
Get the latest release from any of these sources:
Disenchantment-<version>.jar file.plugins/ directory.plugins/Disenchantment/config.yml to customize settings or use ingame admin UI with /disenchantment gui.| Plugin | 1.21.+ - 1.21.8 | 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 | ✓ | ✓ | ✓ | ✓ | ✓ |
| Vane | ✓ | ✓ | ✓ | - | - |
| Zenchantments | ✓ | ✓ | ✓ | - | - |
| ExcellentEnchants | ✓ | ✓ | - | - | - |
Note: EcoEnchants requires a patched build. See EcoEnchants#417 for details, or download the pre-built v12.24.0 from the v6.2.2 release.
| 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 |
mvn clean package
The output JAR is written to target/Disenchantment-<version>.jar. See CONTRIBUTING.md for prerequisites and development setup.
Contributions are welcome! Please read the Contributing Guidelines before opening a pull request.
This project is licensed under the MIT License.
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) |
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 |
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.
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 |