玩家名称样式器

PlayerName Styler

在聊天、标签列表和头顶名牌中添加可配置的昵称和样式化的玩家名称。

功能

• 每位玩家的昵称（/nickname）
• 可配置的聊天、标签列表和名牌格式（TOML）
• 占位符系统（内置占位符 + 供其他模组注册自己占位符的 API）
• 样式支持
  • Minecraft & 颜色/格式代码（&a、&6、&l、&r 等）
  • 十六进制颜色（&#RRGGBB 和 <#RRGGBB>）
  • 类似 <bold>、<red>、<reset> 的标签
  • <gradient:#RRGGBB:#RRGGBB>text</gradient> 和 <rainbow>text</rainbow>
• LuckPerms 前缀/后缀集成 （通过 %prefix% / %suffix% 可选；未安装 LuckPerms 时为空）
• 简单的 JSON 昵称存储，位于你的配置文件夹中（config/nicknames.json）
• 通过 /realname 查找真实用户名
• 名牌渲染器可配置（默认为 text_display，回退为 armor_stand）
• 计分板 below_name 支持 — 在自定义名牌下方将 below_name 显示槽位（例如生命值）显示为第二行，Minecraft 在名称标签被替换后通常会隐藏它

命令

• /nickname — 显示你当前的昵称
• /nickname <nickname> — 设置你的昵称
• /nickname clear — 清除你的昵称
• /nickname set <player> <nickname> — 管理员设置（OP 等级 2）
• /nickname clear <player> — 管理员清除（OP 等级 2）
• /nickname reload — 重新加载昵称文件（OP 等级 2）
• /nickname cleartags — 移除卡住/孤立的名牌实体并刷新在线玩家（OP 等级 2）
• /realname — 列出所有昵称
• /realname <search> — 搜索昵称/真实名称

配置

配置文件：config/playernamestyler-common.toml

• chatFormat、tabListFormat、nameplateFormat 接受如下占位符：
  • %displayname%、%username%、%prefix%、%suffix%、%chatmessage%
  • %world% / %dimension%、%biome%、%ping%、%x%/%y%/%z%、%health% 等
• nameplateRenderer 可以是 text_display 或 armor_stand
• showBelowName 切换自定义名牌下方的计分板 below_name 行（默认 true）

兼容性

• 加载器： NeoForge
• Minecraft： 1.21.1–1.21.11（每个列出的版本有单独构建）