CustomNameTags By Pixel Pastry

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%&hearts; %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%&hearts;", "update_interval": 1 }
    }
  }
}

覆盖项可以是:

  • true 或 false 来给予或隐藏名牌,
  • 一个字符串来替换名牌的文本,
  • 一个包含名牌中任意字段的对象来替换那些字段,外加 "enabled": false 来隐藏它。

覆盖名牌会给玩家该名牌,无论其 "for" 选择器如何,除非覆盖项指定了自己的 "for"。与全局名牌不匹配的 id 会定义一个仅该玩家拥有的名牌。

注意事项

CustomNameTags 有一些限制,虽然几乎在所有情况下名牌都会按预期工作,但自定义名牌存在一些不一致之处。

  • 当玩家按下 F1 隐藏 HUD 时,玩家自定义名牌仍会保持可见。
  • 如果玩家属于某个队伍,他们的普通名牌将会渲染。
    • 这可以通过隐藏给定队伍的所有名牌来解决:
    • /team modify <team> nametagVisibility never