EnchantmentPlus - 高效附魔插件

💡简介

Enchantments+ 是一款自定义附魔插件，它在原版附魔系统的基础上，新增了超过 70 种功能各异的附魔，例如追踪箭矢、伐木斧、方块破坏激光等。这些附魔可通过正常的附魔流程获取，并能像原版附魔一样进行合并与组合。本插件无需任何客户端模组或资源包，并提供高度可配置的文件，允许您精细调整每个附魔以适应服务器的游戏风格。本分支版本专注于稳定性和未来兼容性，致力于为生产级服务器提供可靠支持。

🎮版本支持与注意事项

• 1.15.2 支持：版本 3.1.0 至 3.1.6 原生支持。后续版本不再包含此支持。
• 1.16.5 支持：完全支持。
• 4.0.0 及以后版本：代码层面仍支持 1.16.5，但为了获得完整功能，您需要深度调整 magicCompat.yml 文件。一个简单的办法是从您已安装的 3.1.6 版本中直接复制此文件。

主要特点

• 重新平衡并优化了源自 Zenchantments 的附魔，使其更稳定、面向未来。
• 引入了诸如可着色激光（虽然没什么用）等小特性。
• 提供 magicCompat.yml 文件以应对未来版本变化，以及 patches.yml 文件供您深度自定义游戏体验（也可能搞坏插件！）。
• 完全不依赖 NMS (net.minecraft.server)，因此具备出色的向上兼容性。新的 Spigot 版本发布后，本插件通常能以某种程度立即支持。

🔧命令列表

所有命令均以 /ench 为基础。

• /ench - 插件的主命令，所有功能均由此处理。
• /ench give <玩家> <材料> <附魔名> <?等级> ... - 给予目标玩家指定材料和附魔的物品。
• /ench version - 显示插件版本信息。
• /ench lasercol - 设置手中物品的激光颜色。
• /ench <附魔名> <?等级> <?修饰符> <?是否通知> - 为执行者或指定玩家手中的物品附魔。
• /ench help - 列出所有可用命令。
• /ench reload - 重载插件配置（慎用，可能导致内存泄漏）。
• /ench list - 列出所有可用附魔。
• /ench info - 查看某个附魔的详细信息。
• /ench onoff - 启用或禁用某个特定附魔。

✨权限节点

• enchplus.enchant.get - 允许玩家在附魔时有几率获得已启用的自定义附魔。
• enchplus.enchant.use - 允许玩家在物品上使用给定的自定义附魔。
• enchplus.command.reload - 允许使用 /ench reload 命令。
• enchplus.command.give - 允许使用 /ench give 命令。
• enchplus.command.list - 允许使用 /ench list 命令。
• enchplus.command.info - 允许使用 /ench info 命令。
• enchplus.command.onoff - 允许使用 /ench onoff 命令。
• enchplus.command.enchant - 允许使用 /ench <附魔名> 命令（可为他人物品附魔，请谨慎使用）。
• enchplus.command.lasercol - 允许使用 /ench lasercol 命令。

❓常见问题解答

如何获取支持？

您可以通过多种方式获取支持

• 通过 SpigotMC 站内私信。
• 通过 Internet Relay Chat (IRC)。
• 通过 Github Issues 和 Discussions。

开发者会尽可能在所有平台保持活跃，但在 Github 和 IRC 上最为活跃。

为什么选择 Enchantments+ 而不是其他自定义附魔插件？

• 稳定性优先：虽然可能存在漏洞，但我们致力于几乎不引入新漏洞。
• 向上兼容：由于不依赖 NMS，新 Spigot 版本发布后即可获得支持。
• 兼容性：如果使用 Lore 获取器，本插件与 Zenchantments 兼容。
• 开源与响应：如果您发现漏洞，请报告，我们会尽力修复。

它支持 1.8.x / 1.12.x / 1.15.x 吗？

不支持。这些版本无法很好地运行本插件所需的 Java 16 环境。

你们能实现某个功能（XYZ）吗？

可以。请在 https://github.com/Geolykt/EnchantmentsPlus/issues 提交功能请求。

附魔获取器（Lore getters 或 NBT getters）有什么区别？

插件目前支持 4 类附魔获取器

第一类（轻量级获取器）

• 包括 lwNBT 和 PR47-lore。
• 性能更高，但缺少一些功能。

第二类（重量级获取器）

• 包括 advLore 和 NBT。
• 性能低于轻量级获取器，仅在需要其特定功能时使用。

第三类（Lore 获取器）

• 据信比 NBT 获取器更快（这一点存在争议）。
• 优点是非常灵活，可以兼容您旧的 Zenchantments 附魔。
• 警告：如果您更改或清空 Lore 名称，它将失效。

第四类（PDC 获取器）

• 即持久化数据容器获取器（常被称为 NBT 获取器）。
• 最稳定，据 Spigot 社区反馈，其速度可能超过 Lore 获取器。
• 支持“隐形”附魔和附魔名称更改，但无法从其他获取器转换附魔。如需转换，请暂时使用旧的 1.1.x 版本。

性能提示：最大的延迟来源通常是您的反作弊插件和权限处理插件（取决于它们是否监听 Bukkit 事件）。如果想节省 CPU 资源，请关闭或正确配置它们。

⭐兼容性

• 当前插件版本完全兼容 Spigot 1.17 和 1.16.5。
• 高于 1.17 的版本可能可以运行，但无法完全保证。

🎮附魔列表与变更记录

• 完整的附魔列表：请访问 https://github.com/Geolykt/EnchantmentsPlus/wiki/List-of-Enchantments（由于开发者懒惰，列表可能暂未完全更新）。
• 查看此分支的变更：要了解与原始 NMS-less Zenchantments 相比的改动，请访问：

https://github.com/Geolykt/EnchantmentsPlus/wiki/What-changes-were-performed-in-this-fork-compared-to-nms-less-zenchantments