铭牌制作器

NameplateBuilder

自定义Hytale中NPC和玩家头顶的铭牌。任何模组都可以集成并添加自己的"片段"——由你控制其外观。

生命条、精英称号、公会标签、玩家和NPC的等级——拖拽排序、选择显示格式、调整分隔符。说到有趣的功能……

---

为什么？

在Hytale中，每个实体只有一个铭牌。当多个模组试图在实体上方显示各自的信息时，它们会互相覆盖。NameplateBuilder解决了这个问题。它收集来自每个集成API的模组的文本，并将它们合并成一个你可以完全自定义的铭牌。

---

功能

开箱即用

NameplateBuilder内置了玩家名称（可隐藏真名）、生命值、耐力值和法力值的铭牌片段。每个片段都有多种显示样式——生命值可显示为42/67、百分比63%或视觉条||||||------。内置片段以温暖的紫色调突出显示，以便与模组添加的片段区分。

任何支持NameplateBuilder API的模组也可以添加自己的片段（如精英等级标签、公会标签或称号），它们会自动出现在编辑器中。

全面自定义

使用/npb命令打开编辑器，按你的喜好自定义铭牌：

• 拖拽排序 - 自由调整片段的顺序
• 选择显示格式 - 选择每个片段的显示方式（数字、百分比、进度条等）
• 自定义分隔符 - 更改片段之间的分隔符，或完全移除分隔符
• 为片段添加文字 - 为任何片段包裹自定义文本（例如：HP: [42/67]）
• 调整进度条样式 - 更改进度条显示使用的填充字符
• 垂直偏移 - 通过滑块调整铭牌的上下位置，实现悬浮全息效果
• 实时预览 - 在保存前实时查看更改效果
• 搜索功能 - 快速查找所有已安装模组中的片段

智能默认设置

• NPC铭牌仅在玩家注视时显示（12格范围内）。玩家铭牌始终可见
• 玩家蹲下时自动隐藏铭牌（类似Minecraft）
• 实体死亡后铭牌立即消失，不会残留
• 新玩家默认拥有合理的设置。模组可标记其最重要的片段为自动启用
• 保存按钮在实际更改内容前保持灰色不可用
• 所有按钮和控件都带有功能提示

服务器管理员控制

服务器管理员（拥有nameplatebuilder.admin权限）可获得完整控制面板：

• 开关控制 - 控制整个服务器、仅NPC、仅玩家、每个模组或每个世界/实例的铭牌开启或关闭
• 锁定链 - 强制所有玩家看到相同的片段排序。玩家获得只读视图，管理员仍可修改
• 必需片段 - 确保某些片段始终对所有人显示
• 隐藏片段 - 完全从所有人视图中移除片段
• NPC黑名单 - 选择特定NPC类型不显示铭牌，支持搜索弹出窗口
• 模式黑名单 - 使用Citizen.*这类模式一次性屏蔽整组NPC，默认包含市民、坐骑和宠物NPC的模式
• 服务器名称和欢迎消息 - 设置自定义名称，切换加入消息的显示

当管理员禁用某项功能时，玩家会看到"(已由管理员禁用)"且无法重新启用。

---

模组开发者

想要添加你自己的片段？请查阅文档获取完整API参考和工作示例模组。你可以：

• 注册带有显示名称、示例和多种格式变体的片段
• 让NameplateBuilder使用解析器自动计算你的片段文本，或手动设置
• 为新玩家默认启用最多3个你的片段

---

性能

NameplateBuilder设计轻量。附近没有玩家的实体会被完全跳过，结果会尽可能缓存。你可以使用/npbbench <玩家数> <秒数>自行测试（例如：/npbbench 50 5 模拟当前世界中50名玩家的实体数量持续5秒，并报告使用的服务器tick预算占比）。增加时间（秒数）可获得更准确的结果。

---

权限

权限	描述
nameplatebuilder.admin	在UI中显示管理员部分。没有此权限，管理员控件将被隐藏。

---

截图

欢迎消息

编辑器概览

常规设置

链编辑器

可用块

预览条

搜索与筛选

格式自定义

管理员面板

覆盖

管理员链警告

游戏内铭牌