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:

• GitHub Releases
• SpigotMC
• Modrinth

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

Links

• SpigotMC
• Modrinth
• bStats
• GitHub

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 |