常见问题
先确认控制台第一条错误、对应配置文件和行号，再按下面的原因逐项排查。
玩家一直停在队首
核对代理模块是否加载、Paper 与代理协议一致、组名一致，并检查 RouteTimeoutSeconds 后是否有重试日志。
动态 /hub 不存在
确认 server-groups.yml 的组 Enabled 为 true、Command 非空，并执行 reload 或重启。
路由回到了当前服
检查 General.CurrentServerName 是否与代理服务名完全一致，代理需要据此排除正在关闭/当前服务器。
Hotbar 没有出现
确认 Hotbar.Enabled、CurrentServerGroup、组内 Hotbar 映射及模板 ID；槽位只能是 0-8。
修改 YAML 后插件无法重载
检查控制台最早出现的 YAML 行号。常见原因是使用 Tab、缩进层级错误、冒号后的文本未加引号或列表项缺少 “-”。
升级后新功能没有配置项
不要整份覆盖新版本默认配置。先备份旧目录，让插件生成新文件，再逐项迁移旧值。