> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/cn-er/xin-xi/faq.md).

# 常见问题

## 附魔颜色没有显示？

请尝试重启服务器。

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

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

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

请使用 [EnchantmentSlots](https://www.spigotmc.org/resources/enchantmentslots-add-enchantment-slot-feature-to-your-server-1-20-5.113048/)。

## 我想让怪物也能使用附魔

由于让同一套附魔同时对怪物和玩家生效的实现不够可靠，此功能已被拆分到 [EnchantedMobs](https://www.spigotmc.org/resources/enchantedmobs-dynamic-mob-abilities-and-player-scaling-difficulty-61-built-in-power-1-21-3.133242/) 中。

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

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

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

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

1. 附魔已启用并成功注册；
2. 物品确实拥有该附魔；
3. 物品位于 `active-slots` 指定的槽位中；
4. 使用的触发器存在于[触发器参考](/cn-er/pei-zhi/triggers.md)中；
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` 检查注册结果。