常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
插件提示缺少 PacketEvents
安装匹配服务端版本的 PacketEvents。物品 Lore 重写依赖它，且当前 plugin.yml 为硬依赖。
附魔文件存在但没有加载
检查 YAML 缩进、ID 是否重复、触发器/条件/效果类型是否有效，并阅读 /fe reload 后的诊断。
物品 Lore 重复或显示旧内容
先确认只运行一个 JAR，执行 /fe reload 后重新拿取物品；若涉及其他改 Lore 插件，检查 PacketEvents 处理顺序。
玩家放置矿石可以刷自定义掉落
保持 mining.natural-ore-protection.enabled 为 true，并确保目标材料包含在 tracked-materials。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。