Disenchantment

一个轻量级的 Spigot/Paper/Folia 插件,通过向标准铁砧添加强大且直观的功能来增强原版附魔系统。为你的玩家提供高效管理附魔的工具,无需添加任何新方块或复杂系统。
功能
解除附魔:回收你的附魔
是否曾发现一件即将损坏的工具上带有你想保留的稀有附魔?解除附魔机制提供了一个简单的解决方案。
- 简单的铁砧流程 - 将附魔物品放入第一个铁砧槽位,将书放入第二个槽位。
- 可控转移 - 对于可配置的 XP 消耗,附魔会从物品上移除并转移到书上,使原物品恢复干净。玩家可以挽救磨损或过时装备上的珍贵附魔。
书本拆分:分割你的附魔书
需要从一本包含多个附魔的书里只提取一个吗?书本拆分允许你精确、策略性地使用附魔书。
- 直观的拆分 - 在铁砧上将多附魔书与空白书结合,从原书中分离出一个单独的附魔。
- 策略性应用 - 结果得到两本书:原书少一个附魔,新书则包含被分离出的单个附魔。这实现了精准应用,并促进更动态的服务器经济。
经济集成
服务器管理员可选择要求玩家在每次解除附魔或拆分操作时支付游戏内货币费用,除了(或替代)XP 消耗。
- 需要 Vault 及任何兼容的经济插件(EssentialsX、CMI、PlayerPoints 等)。
- 可配置每项操作的固定费用,解除附魔和书本拆分的费用独立设置。
- 当玩家在铁砧中准备好结果时,费用会在动作栏中预览。
- 默认禁用 — 如果未安装 Vault,则无任何影响。
为什么选择此插件?
- 真正兼容原版 - 没有新机器或令人困惑的界面。所有功能均通过标准铁砧处理。
- 轻量且高效 - 添加有价值功能的同时不会导致服务器卡顿或性能问题。
- 完全可定制 - 可配置 XP 消耗、经济费用、按世界/按附魔/按材质限制、事件优先级等。
- 支持经济 - 可选的 Vault 集成让服务器管理员可以为每项操作添加货币成本。
- 支持 Folia - 兼容用于区域化多线程的 Folia 服务器软件。
安装
要求
- Java 21 或更高版本
- 运行 Minecraft 1.18 - 1.21.+ 的 Spigot、Paper 或 Folia 服务器
下载
从以下任一来源获取最新版本:
设置
- 下载
Disenchantment-<version>.jar文件。 - 将 JAR 文件放入服务器的
plugins/目录。 - 重启服务器。
- 编辑
plugins/Disenchantment/config.yml以自定义设置,或使用/disenchantment gui命令在游戏内使用管理员界面。
支持的自定义附魔插件
| 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 | ✓ | ✓ | ✓ | - | - |
注意: EcoEnchants V13.0.0 在 Disenchantment 6.4.0+ 中原生支持。无需修补构建。
文档
完整文档位于 docs/ 目录中。
| 目标用户 | 从这里开始 |
|---|---|
| 服务器管理员与玩家 | docs/user/ — 安装、命令、配置、权限、常见问题解答 |
| 插件开发者(API) | docs/api/ — 公开事件、PlaceholderAPI |
| 贡献者与工程师 | docs/engineering/ — 架构、环境搭建、贡献指南 |
| 深入内部机制 / LLM 智能体 | docs/internals/ — NMS、事件、GUI、配置系统 |
快速链接:
| 文档 | 描述 |
|---|---|
| Commands | 完整的命令参考,包含用法与权限说明 |
| Permissions | 所有权限节点及其默认值 |
| Configuration | 完整的配置参考 |
| FAQ | 常见问题解答与故障排除 |
从源代码构建
mvn clean package
输出的 JAR 文件位于 target/Disenchantment-<version>.jar。有关前置条件和开发环境搭建,请参阅 CONTRIBUTING.md。
贡献
欢迎贡献!请在提交拉取请求之前阅读 Contributing Guidelines。
链接
许可证
本项目采用 MIT License 许可。
依赖与致谢
内置库
以下库包含在分发的插件 JAR 中:
| Library | License | Author | Purpose |
|---|---|---|---|
| bStats | MIT | Bastian Oppermann | 匿名插件使用统计(可选,可在配置中禁用) |
运行时依赖项(由服务器提供)
这些 API 由 Minecraft 服务器提供,不随插件捆绑:
| 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 |
可选运行时依赖项
这些插件不是必需的,但在存在时会解锁额外功能:
| Plugin | License | Link | Purpose |
|---|---|---|---|
| Vault | LGPL-3.0 | github.com/MilkBowl/Vault | 经济集成 — 每次操作向玩家收取货币费用 |
自定义附魔插件适配器(仅编译时)
Disenchantment 包含以下插件的适配器。这些插件未随 Disenchantment 捆绑或分发。它们仅用作编译时依赖项以创建集成适配器。如果希望使用集成特性,服务器管理员必须单独获取并安装这些插件。
| 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 |
注意: Disenchantment 创建的适配器仅与这些插件的公开 API 进行交互,不包含任何来自插件本身的代码。每个插件均保留其独立的许可证。
构建工具
以下工具在构建过程中使用,但不会包含在最终的插件中:
| 工具 | 许可证 | 链接 |
|---|---|---|
| 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 |
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>.jarfile. - Place the JAR in your server's
plugins/directory. - Restart the server.
- Edit
plugins/Disenchantment/config.ymlto 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
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 |
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Disenchantment
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新功能
限制模式
- 世界的允许列表/禁止列表模式 — 世界级列表现在可以用作禁止列表(仅阻止列出的世界)或允许列表(仅允许列出的世界)。配置迁移 12 会自动添加此新设置。
- 材质的允许列表/禁止列表模式 — 将相同的允许列表/禁止列表模型应用于材质级别的限制列表。
mode子命令 —/disenchantment worlds mode、/disenchantment materials mode以及破碎(shatter)变体可从聊天切换限制模式。- 限制模式 GUI 切换 — “世界”和“材质”GUI 新增了面板内控件,用于在允许列表和禁止列表之间切换。
- 国际化字符串 — 所有限制模式控制项的新增英文和捷克语本地化条目。
修复内容
- 铁砧结果槽物品重复生成 — 修复了铁砧结果槽的重复生成漏洞;共享的防护逻辑已集中到
AnvilEventGuards中。 - 单一源物品强制执行 — 附魔去除和破碎操作现在会拒绝堆叠的源物品,仅对单个物品进行操作,防止意外的多物品处理。
内部改进
- 日志重构 — 调试消息现采用延迟构建方式,Webhook 载荷序列化为安全的 JSON 格式,并移除了重复的启动日志行。
- 诊断工具 —
DiagnosticUtils已更新,可报告当前激活的限制模式。 - 添加了针对铁砧防护和单物品执行的回归测试(
AnvilEventGuardsTest、EventUtilsDisenchantTest、EventUtilsShatterTest)。 - 在用户文档和工程文档中记录了限制模式模型。
完整更改日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧