YuChat 常见问题
YuChat 支持哪些服务端？
目标适配范围与 YuRandomTeleport 一致：Minecraft 1.8.x-1.26.x，Spigot、Paper、Paper 衍生端，以及 Mohist、Arclight、Youer 等 Bukkit API 混合端。混合端聊天、TAB、实体头顶名和第三方插件改写链路更复杂，上线前建议重点测试聊天格式、TAB 插件、群组互联、死亡消息和 MySQL 同步。
玩家输入颜色没有效果？
先检查权限：
| 颜色能力 | 权限 |
|---|---|
& / § legacy 颜色 | yuchat.chat.color |
| MiniMessage 标签 | yuchat.chat.minimessage |
| Hex 颜色 | yuchat.chat.hex |
| 聊天内容 PAPI | yuchat.chat.placeholder |
低版本客户端会自动降级颜色表现，1.16+ 才能原生显示 Hex 与渐变。
TAB 或头顶名没有显示 YuChat 内容？
如果安装了 TAB、计分板或头顶名插件，它们可能覆盖 Bukkit 原生显示。推荐在这些插件中直接使用 YuChat 变量：
customtabname: "%yuchat_tab%"
customtagname: "%yuchat_prefix%%yuchat_title% %yuchat_nickname%%yuchat_suffix%"同时确认 placeholder.expansion.enabled: true，并且 PlaceholderAPI 已安装。
LuckPerms 前缀或后缀没有读取到？
按顺序检查：
- LuckPerms 是否已安装并正常启用。
- 玩家所在组是否真的设置了 prefix、suffix 或 meta。
prefix-suffix.enabled是否为true。prefix-suffix.prefix.parts与suffix.parts是否包含需要的片段。- 若使用 PAPI 兜底，PlaceholderAPI 与 LuckPerms 扩展是否可用。
排查时可临时在菜单、TAB 或聊天中展示 %yuchat_prefix_raw% 与 %yuchat_suffix_raw%。
群组互联或聊天记录插件收不到消息？
保持默认配置时，YuChat 会尽量保留 Bukkit 原始聊天事件。如果你开启了聊天内悬浮，YuChat 可能会取消原事件并使用 TextComponent 广播。
优先检查：
chat-format:
component-broadcast:
enabled: false
hover:
enabled: false需要悬浮时可以只开启 prefix、suffix、nickname 或 title，尽量避免开启 hover.message。
首次启动下载依赖失败怎么办？
YuChat 会从 Maven Central 下载 HikariCP、SQLite JDBC、MySQL JDBC、SLF4J 等依赖到 plugins/YuChat/libs/。如果服务器无法访问 Maven Central：
- 在可联网环境下载对应 jar。
- 放入
plugins/YuChat/libs/。 - 保持文件名为
artifact-version.jar。 - 重启服务端。
不建议关闭 library.verify-checksum，除非你确认依赖来源可靠且校验源不可访问。
MySQL 模式下数据不同步？
检查所有子服是否使用：
| 项目 | 要求 |
|---|---|
| 同一插件版本 | 避免表结构或字段差异。 |
| 同一数据库 | host、port、database、username、password 一致。 |
| 同一表前缀 | storage.table-prefix 一致。 |
| 同一称呼/效果配置 | 避免某个子服没有对应 ID。 |
修改昵称、称呼和显示开关后，玩家重新进服或触发显示同步通常会看到最新状态。
经济扣费没有发生？
确认 economy 或称呼 payment 节点中 enabled: true，并且 mode 不是 none。Vault 模式需要安装 Vault 和实际经济插件；PlayerPoints 模式需要安装 PlayerPoints。
管理员 GUI 创建的称呼在哪里？
管理员 GUI 创建的称呼会保存到：
plugins/YuChat/custom_titles.yml内置称呼在 titles.yml。两个文件中的称呼 ID 不应重复。
死亡消息里的击杀者不准确？
YuChat 会从最后一次伤害事件解析真实伤害来源，包括生物、弹射物、TNT 等。若其他插件深度改写死亡事件或伤害来源，建议在测试服复现并检查控制台是否有相关报错。
修改配置后 GUI 没变化？
执行 /yc reload。如果 reload.gui.reopen-main-after-reload 为 true，正在查看 YuChat GUI 的玩家会自动关闭旧界面并打开主界面；否则需要玩家手动重新打开。