常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
频道消息没有跨服
确认 cross-server.enabled 为 true、每台服 server-name 唯一，并检查目标频道 cross-server 为 true；LOCAL 频道不会跨服。
玩家看不到某个颜色
检查 colors.yml 中该颜色 permission，并给玩家对应权限或 fotiachat.color.*。
MySQL 配置后仍像单服
确认 storage.type 已改为 mysql，数据库账号可连接，并查看控制台连接池报错。
消息里的颜色代码无效
确认 chat.allow-color-codes 开启，并给玩家 fotiachat.color.format；颜色选择本身使用 /chatcolor。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。