Disenchantment Custom Enchantment Support - Disenchantment

简介

Disenchantment 是一款轻量级的 Spigot/Paper/Folia 插件，它通过为原版铁砧添加强大而直观的机制，来增强原版的附魔系统。为您的玩家提供高效管理附魔的工具，无需添加任何新的方块或复杂系统。

💡功能特性

拆解附魔：回收您的附魔

是否曾为一件即将损坏但带有稀有附魔的工具感到惋惜？拆解附魔机制提供了一个简单的解决方案。

• 简单的铁砧操作 — 将附魔物品放入铁砧的第一个格子，将书放入第二个格子。
• 可控的转移 — 根据可配置的经验值消耗，附魔会从物品上移除并转移到书上，原物品则变得洁净。玩家可以从磨损或过时的装备中挽救宝贵的附魔。

书本拆分：分离您的附魔书

需要从一本包含多个附魔的书中提取单一附魔吗？书本拆分功能允许您精确、策略性地使用附魔书。

• 直观的拆分 — 在铁砧上将一本多附魔书与一本空白书结合，即可从原书上提取一个附魔。
• 策略性应用 — 结果是两本书：原书减少一个附魔，新书则包含被拆分出的单一附魔。这实现了附魔的定向应用，并促进了更动态的服务器经济。

经济系统集成

服务器所有者可以选择要求玩家为每次拆解或拆分操作支付游戏内货币费用，此费用可附加于（或替代）经验值消耗。

• 需要 Vault 及任何兼容的经济插件（如 EssentialsX、CMI、PlayerPoints 等）。
• 可为拆解附魔和书本拆分分别配置独立的固定费用。
• 当玩家在铁砧中准备好操作结果时，费用会预览在快捷栏上方的提示信息中。
• 默认禁用 — 如果未安装 Vault，则无任何影响。

❓为何选择此插件？

• 真正的原版友好 — 没有新的机器或令人困惑的界面。所有功能都通过标准铁砧处理。
• 轻量且高效 — 添加了有价值的功能，但不会导致服务器卡顿或性能问题。
• 完全可定制 — 可配置经验值消耗、经济费用、按世界/附魔/材料类型的限制、事件优先级等。
• 经济系统就绪 — 可选的 Vault 集成允许服务器所有者为每次操作添加货币成本。
• 支持 Folia — 兼容 Folia 服务器软件，支持区域化多线程。

✨安装

要求

• Java 21 或更高版本
• 运行 Minecraft 1.18 – 1.21.+ 的 Spigot、Paper 或 Folia 服务器

安装步骤

• 从上方任意来源下载 Disenchantment-<version>.jar 文件。
• 将 JAR 文件放入服务器的 plugins/ 目录。
• 重启服务器。
• 编辑 plugins/Disenchantment/config.yml 以自定义设置，或使用游戏内管理员界面 /disenchantment gui。

支持的自定义附魔插件

• AdvancedEnchantments — 1.18 – 1.21.11+ ✓
• EcoEnchants — 1.18 – 1.21.11+ ✓
• EnchantsSquared — 1.18 – 1.21.11+ ✓
• UberEnchant — 1.18 – 1.21.11+ ✓
• ExcellentEnchants — 1.21 – 1.21.11+ ✓
• Vane — 1.21 – 1.21.11+ ✓
• Zenchantments — 1.21 – 1.21.11+ ✓

EcoEnchants 注意事项

EcoEnchants 需要一个修补版本。详情请参阅 [EcoEnchants#417](EcoEnchants#417)，或从 [v6.2.2 发布页面](v6.2.2 release) 下载预构建的 v12.24.0 版本。

🔧文档

• Commands — 完整的命令参考，包含用法和权限
• Permissions — 所有权限节点及其默认值
• Configuration — 完整的配置参考
• FAQ — 常见问题与故障排除

🎮从源代码构建

运行以下命令

mvn clean package

输出的 JAR 文件将写入 target/Disenchantment-<version>.jar。有关先决条件和开发设置，请参阅 CONTRIBUTING.md。

⭐许可证

本项目采用 [MIT 许可证](MIT License)。