YuChat PlaceholderAPI

YuChat 可注册自己的 PlaceholderAPI 扩展，标识符为 yuchat。开启 placeholder.expansion.enabled: true 且服务器安装 PlaceholderAPI 后，TAB、菜单、计分板、称号栏等插件可以读取 %yuchat_*% 变量。

常用变量

变量	说明
%yuchat_nickname%	渲染后的昵称。
%yuchat_nick%	%yuchat_nickname% 的别名。
%yuchat_nickname_plain%	去色昵称。
%yuchat_nick_plain%	去色昵称别名。
%yuchat_realname%	玩家原名。
%yuchat_name%	玩家原名别名。
%yuchat_title%	已激活称呼，带颜色。
%yuchat_titles%	%yuchat_title% 的别名。
%yuchat_active_titles%	%yuchat_title% 的别名。
%yuchat_title_plain%	去色称呼。
%yuchat_selected_title%	当前选择的称呼 ID。

前后缀与 meta

变量	说明
%yuchat_prefix%	前缀，尊重玩家“前缀显示”开关。
%yuchat_suffix%	后缀，尊重玩家“后缀显示”开关。
%yuchat_prefix_raw%	原始前缀，忽略显示开关。
%yuchat_suffix_raw%	原始后缀，忽略显示开关。
%yuchat_prefix_plain%	去色前缀。
%yuchat_suffix_plain%	去色后缀。
%yuchat_prefix_display%	GUI 友好的前缀显示文本。
%yuchat_suffix_display%	GUI 友好的后缀显示文本。
%yuchat_meta_<key>%	读取 LuckPerms meta，例如 %yuchat_meta_clan%。
%yuchat_meta:<key>%	冒号形式的 meta 读取。

聊天和显示预览

变量	说明
%yuchat_message_effect%	当前聊天颜色或消息效果名称。
%yuchat_chat_color%	%yuchat_message_effect% 的别名。
%yuchat_message_effect_id%	当前消息效果 ID。
%yuchat_chat_color_id%	当前消息效果 ID 别名。
%yuchat_tab%	按 display.tab.format 渲染后的完整 TAB 文本。
%yuchat_tab_plain%	去色 TAB 文本。
%yuchat_nameplate%	按 display.nameplate.format 渲染后的头顶名文本。
%yuchat_displayname%	按 display.bukkit-display-name.format 渲染后的 displayName。
%yuchat_display_name%	%yuchat_displayname% 的别名。
%yuchat_displayname_plain%	去色 displayName。
%yuchat_chat_preview%	聊天格式预览，不包含实际消息内容。

血量变量

变量	说明
%yuchat_health%	当前血量。
%yuchat_health_int%	当前血量整数。
%yuchat_max_health%	最大血量。
%yuchat_max_health_int%	最大血量整数。
%yuchat_health_percent%	血量百分比。
%yuchat_health_bar%	配置化血量条。

开关状态

变量	说明
%yuchat_title_visible%	称呼显示开关。
%yuchat_nickname_visible%	昵称显示开关。
%yuchat_prefix_visible%	前缀显示开关。
%yuchat_suffix_visible%	后缀显示开关。
%yuchat_signature%	个性签名。

TAB 插件示例

如果服务器安装了 TAB 插件，TAB 可能会覆盖 Bukkit 的 Player#setPlayerListName。推荐直接在 TAB 配置中使用 YuChat 变量：

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

如果需要只显示昵称：

customtabname: "%yuchat_nickname%"
customtagname: "%yuchat_nickname%"

菜单插件示例

lore:
  - "&7昵称: &f%yuchat_nickname%"
  - "&7称呼: &f%yuchat_title%"
  - "&7签名: &f%yuchat_signature%"