LuckPerms GUI & NameTags

LuckPerms GUI & NameTags

通过游戏内 GUI 管理 LuckPerms 角色——并在头顶、Tab 列表和聊天中显示动态前缀。

Forge • Minecraft 1.20.1 • 需要 LuckPerms 5.4+ • 服务端（客户端可选，用于动画效果）

---

LuckPerms GUI & NameTags 为 LuckPerms 提供了可视化的游戏内管理界面，并最终将玩家的角色显示在头顶、Tab 列表和聊天中——带有流畅的动画（彩虹、流动渐变、脉冲、辉光）。创建和编辑分组、使用调色板和实时预览设计前缀/后缀，以及将玩家分配到角色——全程无需输入任何命令。

角色显示在头顶、Tab 列表和聊天中

主要特性

• 游戏内管理 GUI——可视化地管理 LuckPerms：创建 / 编辑 / 删除分组、设置前缀、后缀、权重和名称颜色，以及分配玩家。无需输入命令。
• 处处显示角色——角色会显示在聊天、Tab 列表以及玩家头顶。
• 动画——彩虹、流动渐变、脉冲和辉光波浪，应用于头顶和 Tab 列表。
• 实时颜色编辑器 + 调色板——一个引导式构建器（文本 + 动画 + 颜色），带有可点击的调色板和实时动画预览，也可以直接编辑原始标签。
• 成员管理——为任何玩家设置、添加或移除分组，在线或离线（按名称）均可。
• 支持原版客户端——服务端将角色写入原版计分板队伍，因此原版客户端也能看到（静态显示）。在客户端安装本模组即可看到动画。
• Tab 列表按等级排序——Tab 列表按分组的权重排序。
• 实时同步——在 LuckPerms 中更改角色会立即更新名牌，无需重新登录。
• 多语言——英语和西班牙语，跟随客户端的语言设置。
• 安全——GUI 受 OP 权限限制，并且每个操作都在服务端重新验证。

管理 GUI

使用 /luckpermsgui gui（或 /lpgui）、一个可配置的按键，或背包和 Esc 菜单中的⚙ 角色按钮（仅限 OP）打开编辑器。在左侧选择一个分组，并在两个紧凑的区块中编辑其前缀和后缀：输入文本、选择动画、从调色板中选取颜色并切换粗体——预览会随着你的输入实时动画化。高级用户可以直接编辑原始标签字符串。

成员

在成员标签页中，点击一个在线玩家（或输入任意用户名，即使是离线玩家）并选择一个分组：设为角色（主分组）、添加分组或移除分组。更改会直接写入 LuckPerms。

动画和颜色

前缀和后缀支持旧版代码、十六进制颜色、渐变和动画标签。动画效果在安装了本模组的客户端上会移动；原版客户端则看到静态快照。

效果	标签 / 代码	动画
旧版 / 十六进制颜色	&c   &#ff8800   <#ff8800>	—
渐变（静态）	<gradient:#ff0000:#00ff00>...</gradient>	—
彩虹	<rainbow>...</rainbow>	是
流动渐变	<flow:#00ffff:#ff00ff>...</flow>	是
脉冲	<pulse:#2ecc71:#16a085>...</pulse>	是
辉光波浪	<wave:#f1c40f>...</wave>	是

加入和离开消息

加入和离开消息也会显示玩家的角色及其颜色。

工作原理

• 服务端——读取 LuckPerms 元数据并将其写入原版计分板队伍（头顶 + Tab 列表，按权重排序）并格式化聊天。这就是原版客户端看到的内容。
• 客户端（安装了模组）——每帧重新绘制头顶和 Tab 列表，使动画流畅移动——无数据包刷屏，无 mixin。
• 聊天显示完整的颜色/渐变但不播放动画（发送的行是静态的）。

前置要求

• Minecraft 1.20.1
• Minecraft Forge 47+
• LuckPerms (Forge) 5.4+——服务端必需。
• 可选：在客户端安装本模组以查看动画（原版客户端看到静态角色）。客户端不需要 LuckPerms。

注意：如果你运行了其他聊天格式化模组，请在配置中设置 chat.chatEnabled = false 以避免聊天重复。

依赖项

LuckPerms (Forge) 是必需的——请在服务端安装：
🔗 CurseForge 上的 LuckPerms

---