常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
插件未加载并提示缺少依赖
安装与服务端版本匹配的 PacketEvents；plugin.yml 把 packetevents 声明为硬依赖。
玩家有钥匙但不能开箱
核对宝箱 permission、玩家 fotiacrates.use、钥匙绑定的 crate ID，以及玩家数据是否仍在加载。
模型重复或残留
检查同一位置是否被重复登记，确认只启用一个模型 provider，并执行 /crate remove 后重新 set。
背包满时奖励不见了
先执行 /crate claim；若使用 SweetMail，确认插件已安装且 overflow-mail.enabled 为 true。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。