YuChat 插件联动

YuChat 当前主要通过 Bukkit 命令、PlaceholderAPI 变量、LuckPerms API、Vault、PlayerPoints、配置文件和数据库存储完成联动。对大多数服务器而言，这些入口已经能覆盖菜单展示、计分板、TAB、经济扣费、聊天转发和权限组显示。

PlaceholderAPI

安装 PlaceholderAPI 后，YuChat 可注册 %yuchat_*% 变量供外部插件读取。常用接入：

场景	推荐变量
TAB 列表	`%yuchat_tab%`、`%yuchat_nickname%`、`%yuchat_title%`
头顶名	`%yuchat_prefix%`、`%yuchat_title%`、`%yuchat_nickname%`、`%yuchat_suffix%`
菜单展示	`%yuchat_title%`、`%yuchat_nickname%`、`%yuchat_signature%`
排查显示	`%yuchat_prefix_raw%`、`%yuchat_suffix_raw%`、`%yuchat_selected_title%`

更多变量见 PlaceholderAPI。

YuChat 会优先通过 LuckPerms API 读取玩家 prefix、suffix 和 meta。prefix-suffix.prefix.parts 与 prefix-suffix.suffix.parts 可组合多个片段：

yaml

prefix-suffix:
  prefix:
    parts:
      - "prefix"
      - "meta:clan_prefix"
  suffix:
    parts:
      - "suffix"
      - "meta:rank_suffix"

如果 LuckPerms API 不可用，也可以在 placeholder-fallback 中配置 PAPI 兜底变量。

YuChat 可把昵称、昵称效果、消息效果、个性签名、死亡消息和称呼接入经济系统。

称呼价格可在 titles.yml 的 payment 节点中设置，通用功能价格可在 config.yml -> economy 中设置。

若外部 TAB 插件接管玩家列表或头顶名，Bukkit 原生同步可能被覆盖。推荐在外部插件中使用 YuChat PAPI 变量，而不是依赖 Bukkit displayName。

yaml

customtabname: "%yuchat_tab%"
customtagname: "%yuchat_prefix%%yuchat_title% %yuchat_nickname%%yuchat_suffix%"

默认配置会保留 Bukkit 原始聊天事件，适合 EasyBot、聊天记录、群组互联类插件继续监听 AsyncPlayerChatEvent。

需要聊天内悬浮时再开启：

yaml

chat-format:
  component-broadcast:
    enabled: true
  hover:
    enabled: true
    message: true

开启组件广播后，YuChat 可能取消原聊天事件并自行广播 TextComponent。若群组互联收不到消息，优先关闭 component-broadcast.enabled 或关闭所有 hover 细分项。

YuChat 支持 SQLite 与 MySQL。跨服共享时建议使用 MySQL，并保持所有子服：

外部程序读取数据库时只建议只读展示，不建议直接写入玩家数据表，避免与插件缓存、过期清理和保存流程冲突。

路径	说明
`plugins/YuChat/config.yml`	主配置。
`plugins/YuChat/messages.yml`	消息文本。
`plugins/YuChat/gui.yml`	GUI 布局。
`plugins/YuChat/titles.yml`	内置称呼。
`plugins/YuChat/custom_titles.yml`	管理员 GUI 创建的称呼。
`plugins/YuChat/effects.yml`	颜色与动态效果。
`plugins/YuChat/yuchat.db`	默认 SQLite 数据库。
`plugins/YuChat/libs/`	运行时依赖。
`plugins/YuChat/runtime/`	隔离 core jar。

YuChat 内置 bStats Bukkit 统计：