常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
Shopkeepers 或 Citizens 村民被寿命系统处理
确认 compatibility.shopkeepers/citizens.exclude-lifespan 为 true，插件名称和依赖均已正确加载。
村民头顶不显示寿命
检查寿命是否存在、display.mode、可见条件；DecentHolograms 未安装时会回退 AUTO。
交易突然被拒绝
依次检查经验、冷却、全局/职业/物品限额、额外绿宝石和权限组倍率。
服务器村民多时出现尖峰
调低 expiration.max-villagers-per-check 与 chunk-load-refresh.max-villagers-per-tick，并增加刷新间隔。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。