常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
称号没有显示在聊天中
安装 PlaceholderAPI 并把 %fotiatags_prefix% 加入现有聊天格式；或谨慎启用 player-display.chat。
头顶名牌与其他插件互相覆盖
关闭 player-display.name-tag.direct，改用现有名牌插件读取 PlaceholderAPI。
自定义称号按钮不可用
同时确认 custom-tags.enabled、玩家 fotiatags.custom，以及 Vault/PlayerPoints 依赖和余额。
多服称号不同步
所有子服必须使用同一 MySQL，并把 cross-server-sync-interval 设为大于 0。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。