
CustomNameTags By Pixel Pastry
此mod自定义并更改人物姓名标签
查看大图命令
你可以使用 /nametag 命令在游戏内管理你的名牌,这需要权限等级 2,或者如果你使用了权限模组,则需要权限 "custom-nametags.commands.nametag"。
文本参数支持 placeholders API 以及格式化标签。
/nametag create <id> <text>创建一个具有指定 id 和文本的名牌,显示在所有玩家身上。/nametag edit <id> text <text>更改现有名牌的文本。/nametag edit <id> for <who>更改现有名牌的 for 选择器。/nametag edit <id> priority <priority>更改现有名牌的优先级(优先级越高显示越靠上)。/nametag delete <id>删除具有指定 id 的名牌。/nametag list列出所有已定义的名牌。/nametag player <players> give <id>给予玩家该名牌,即使他们通常不会拥有它。/nametag player <players> revoke <id>对玩家隐藏该名牌,即使他们通常应该拥有它。/nametag player <players> set <id> <text>仅为这些玩家设置该名牌的文本。如果不存在该 id 的名牌,则会创建一个仅这些玩家拥有的名牌。/nametag player <players> reset <id?>移除玩家对指定名牌的覆盖,或移除他们的所有覆盖。/nametag reload重新加载配置文件。
示例
如果你想创建一个显示玩家名称但使用彩虹色的名牌,可以运行以下命令:
/nametag create rainbow_name <rainbow>%player:displayname_visual%</rainbow>
这里给出的 id 为 rainbow_name,可以是任意字符串。<rainbow> ... </rainbow> 标签表示其中间的内容应显示为彩虹色,这是一个格式化标签。而 %player:displayname_visual% 表示应在此处插入玩家的名称,这是一个占位符。还有更多不同的格式化标签和占位符可供使用。
默认情况下,名牌附加到每个人身上,如果你只想让该名牌仅对管理员显示,可以运行:
/nametag edit rainbow_name for operators
如果你希望手动指定某人是否获得名牌,可以运行:
/nametag edit rainbow_name for nobody
这意味着默认情况下没有人会拥有此名牌,然后你可以通过以下方式覆盖:
/nametag player senseiwells give rainbow_name
指定的玩家(此处为 senseiwells)将始终被给予该名牌。
如果你想覆盖特定名牌的文本,或仅为某位玩家提供一个仅他们可见的名牌,可以使用:
/nametag player senseiwells set rainbow_name <red>Special Red Name</red>
如果存在 id 为 rainbow_name 的名牌,则指定玩家的名牌现在将显示覆盖文本 "Special Red Name",颜色为红色。如果该 id 的名牌不存在,则会仅为该指定玩家创建一个。
这些命令允许你创建一个基本的名牌系统,但若需要更精细的控制,则必须手动编辑名牌配置文件……
配置
此模组的配置文件位于 config/custom-nametags/config.json。上方图片使用了以下配置:
{
"version": 2,
"nametags": {
"admin_name": {
"text": "[Admin] <rainbow>%player:displayname_visual%</rainbow>",
"update_interval": -1,
"for": "operators"
},
"name": {
"text": "[Player] %player:displayname_visual%",
"update_interval": -1,
"for": { "not": "operators" }
},
"held_item": {
"text": "Holding: <green>%player:equipment_slot mainhand%</green>",
"update_interval": 1
},
"data": {
"text": "%player:health%♥ %player:hunger%🍖 %player:statistic minecraft:killed minecraft:player%⚔ %player:statistic minecraft:deaths%\uD83D\uDC80",
"update_interval": 1
}
},
"players": {}
}
模组 2.0.0 之前版本的配置将自动升级为新格式。你的原始配置将备份为
config.old.json。
名牌
"nametags" 对象包含所有将显示给玩家的名牌,以它们的 id 为键。它们按列出的顺序堆叠,第一个位于顶部。
"text"这是将显示在名牌上的文本。如前所述,它支持 placeholders API 以及格式化标签。"update_interval"这是名牌更新的间隔,以刻为单位。如果你的名牌不需要更新,请设置为-1。如果你的名牌包含含有变化数据的占位符(例如%player:health%),则此设置很重要。"for"这决定哪些玩家拥有此名牌,请参见下方的玩家选择器。默认为"everyone"。"visible_to"这决定哪些玩家可以看到此名牌,请参见下方的玩家选择器。默认为"everyone"。"visible_radius"、"hidden_radius"这两个设置指定了名牌对其他玩家可见的范围。将其设置为负值可禁用。"visible_through_walls"名牌是否可以透过墙壁看到,默认为true。"visible_when_invisible"玩家隐身时是否显示名牌,默认为false。"visible_with_passengers"玩家有乘客时是否显示名牌,默认为false。"shift_height"名牌占用的垂直空间,默认为0.275,足够容纳单行文本。"priority"优先级较高的名牌显示在优先级较低的名牌之上,默认为0。
玩家选择器
选择器由 "for" 和 "visible_to" 用于挑选玩家。
最简单的选择器是 "everyone"、"nobody" 和 "operators":
{
"for": "operators"
}
对于其他情况,请使用包含以下一个或多个条件的对象,所有条件都必须匹配:
| 条件 | 匹配以下玩家…… |
|---|---|
"names" |
拥有给定用户名之一 |
"uuids" |
拥有给定 uuid 之一 |
"teams" |
位于给定队伍之一 |
"tags" |
拥有给定计分板标签之一 |
"permission_level" |
至少拥有给定的管理员等级(0-4) |
"permission" |
拥有给定的权限节点(需要权限模组) |
"not" |
不匹配给定选择器 |
"any" |
匹配给定选择器列表中的任意一个 |
"all" |
匹配给定选择器列表中的全部 |
"predicate" |
匹配 predicate api 谓词 |
每个接受列表的条件也接受单个值。
{
// 名为 senseiwells 或 SuperSanta 的玩家
"for": { "names": ["senseiwells", "SuperSanta"] },
// 红队中的管理员
"for": { "permission_level": 2, "teams": "red" },
// 任何管理员或 vip
"visible_to": { "any": [ "operators", { "permission": "group.vip" } ] },
// 除旁观者外的所有人
"visible_to": { "not": { "teams": "spectators" } }
}
玩家
"players" 对象允许你为特定玩家自定义名牌,以他们的用户名或 uuid 为键。每个条目将名牌 id 映射到一个覆盖项:
{
"nametags": {
"rank": { "text": "<red>[Admin]</red>", "for": "operators" },
"name": { "text": "%player:displayname_visual%" }
},
"players": {
// 你也可以使用 uuid 代替用户名
"senseiwells": {
// 仅为此玩家替换 "rank" 名牌的文本
"rank": "<gold>[Owner]</gold>"
},
"SuperSanta": {
// 无论 SuperSanta 是否为管理员,我们都给予 "rank" 名牌
"rank": true,
// 隐藏 "name" 名牌
"name": false,
// 仅此玩家拥有此特定名牌
"hearts": { "text": "%player:hearts%♥", "update_interval": 1 }
}
}
}
覆盖项可以是:
true或false来给予或隐藏名牌,- 一个字符串来替换名牌的文本,
- 一个包含名牌中任意字段的对象来替换那些字段,外加
"enabled": false来隐藏它。
覆盖名牌会给玩家该名牌,无论其 "for" 选择器如何,除非覆盖项指定了自己的 "for"。与全局名牌不匹配的 id 会定义一个仅该玩家拥有的名牌。
注意事项
CustomNameTags 有一些限制,虽然几乎在所有情况下名牌都会按预期工作,但自定义名牌存在一些不一致之处。
- 当玩家按下 F1 隐藏 HUD 时,玩家自定义名牌仍会保持可见。
- 如果玩家属于某个队伍,他们的普通名牌将会渲染。
- 这可以通过隐藏给定队伍的所有名牌来解决:
/team modify <team> nametagVisibility never
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。