常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
插件未加载并提示缺少依赖
先安装与服务端版本匹配的 PacketEvents。plugin.yml 把名称为 packetevents 的插件声明为硬依赖。
CraftEngine 时装显示成原版物品或紫黑模型
确认 CraftEngine 26.8 已启用、source 写成 CRAFTENGINE、id 在 CraftEngine 中真实存在，并让客户端重新接收最新资源包。
填写 item-model 或 modeldata 后没有变化
正确键名是 item-model 或 custom-model-data。前者填写 namespace:model，后者填写整数；同时确认字段位于 icon、visual-item 或 actual-item 内，并与客户端资源包映射一致。
玩家打开菜单后看不到任何时装
菜单只显示玩家已经拥有的时装。先检查节点 enabled、target 分类，再使用 /fc grant 发放。
某个世界里时装突然不显示
按世界、服务器、global 顺序检查 display-rules.yml；HIDDEN 会保留选择，但停止渲染。
切换 ACTUAL 后重载失败
对应时装必须提供可构建的 actual-item；同时检查该实际物品的类型、CraftEngine ID 和兼容材质。
数据库切换后玩家资料没有共享
确认各服连接同一数据库、账号有建表和读写权限，并检查 config.yml 的 database.type 与连接池错误。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。