❓常见问题

附魔颜色没有显示？

请尝试重启服务器。

安装插件后服务器无法启动

这通常是附魔配置存在问题，导致服务器在注册新附魔时崩溃。请回想刚刚修改过哪些文件，并仔细检查这些文件。

我想在物品 Lore 中显示附魔描述

请使用 EnchantmentSlots。

我想让怪物也能使用附魔

由于让同一套附魔同时对怪物和玩家生效的实现不够可靠，此功能已被拆分到 EnchantedMobs 中。

为什么重载后没有出现新附魔？

Minecraft 会在启动阶段冻结附魔注册表。新增或删除文件，以及修改键、适用物品、等级、费用、互斥关系、由稀有度决定的注册表值或原版附魔覆盖后，都必须完整重启服务器。

为什么 YAML 可以加载，但效果从未触发？

请按照以下顺序进行检查：

1. 附魔已启用并成功注册；

2. 物品确实拥有该附魔；

3. 物品位于 active-slots 指定的槽位中；

4. 使用的触发器存在于触发器参考中；

5. 每个能力条件都能获得它所需要的上下文；

6. 能力修改器与触发器提供的可修改结果兼容；

7. 能力能够解析出有效的 SOURCE、SKILL、TARGET、方块、物品或位置；

8. 概率、冷却、使用次数限制、保护和经济检查均已通过。

只在排查问题时启用 debug，请求支持时请提供完整日志。

为什么 Paper 示例无法在 Spigot 上使用？

部分注册表操作和事件仅由 Paper 提供。装备激活与停用、较新的事件类型，以及部分注册表行为在 Spigot 上可能使用兼容方案，也可能完全不可用。

为什么 break_blocks 会跳过受保护或特殊的方块？

此能力会应用默认安全黑名单、全局方块数量上限、可选的白名单或黑名单规则、区块加载规则、工具与耐久检查，以及受支持的保护插件挂钩。请同时检查该能力的配置说明和 config.yml -> powers.break-block。

可以根据附魔等级使用表达式吗？

可以。受支持的数值字段可以使用 level、顶层变量、1~3 形式的范围、等级选择映射、运行时上下文占位符，以及在存在玩家上下文时使用 PlaceholderAPI。

创建附魔时应该从哪里开始？

复制一个使用相似触发器的内置附魔，修改其命名空间 key、适用物品、名称、描述和能力配置，然后重启服务器并通过 /er gui 检查注册结果。