Fabric Custom Names

自定义名称

这个模组为 Minecraft 添加了 /name、/itemname 和 /itemlore 命令，玩家可以使用这些命令设置前缀、后缀或昵称，或者为他们的物品添加多彩的名称和描述。该模组主要设计用于小型私人服务器，尽管通过名称组功能，你也可以限制哪些玩家可以使用哪些前缀/后缀/昵称。

可选地，该模组还具备在游戏中玩家头顶显示自定义名称的功能。此功能还提供了自定义样式（背景颜色和文字透明度）以及自定义显示文本行的选项。

也支持使用 LuckPerms 设置的前缀/后缀！

欢迎在问题追踪器中报告任何错误或建议新功能。

许可证

该模组基于 GNU LGPLv3 许可证。

捐赠

如果你喜欢这个模组，请考虑捐赠。

Discord

如需支持或有任何疑问，欢迎加入我的 Discord。

版本支持

Minecraft 版本	状态
26.2.x	✅ 当前
26.1.x	✔️ 可用
1.21.11	✔️ 可用
1.21.9+10	✔️ 可用
1.21.6+7+8	✔️ 可用
1.21.5	✔️ 可用
1.21.4	✔️ 可用
1.21.2+3	✔️ 可用
1.21+1	✔️ 可用
1.20.5+6	✔️ 可用
1.20.4	✔️ 可用
1.20.1	✔️ 可用
1.19.4	✔️ 可用
1.19.2	✔️ 可用

我尽量保持对最新 Minecraft 版本的支持。更新到更新的 Minecraft 版本可能会不时延迟，因为我并不总是有时间立即更新我的模组。

不支持的版本仍然可以下载，但它们不会获得新功能或错误修复。

NeoForge 移植版本可用于 Minecraft 26.1 及以上版本。

使用方法

该模组面向 Fabric Minecraft 服务器，但也适用于客户端。该模组需要 Fabric API。

/name 命令的使用方法如下：

• /name prefix - 为你的名字设置前缀，或者当未提供前缀时，清除你的前缀。
  • 需要管理员权限或 customname.prefix 权限。
• /name suffix - 为你的名字设置后缀，或者当未提供后缀时，清除你的后缀。
  • 需要管理员权限或 customname.suffix 权限。
• /name nickname - 设置一个昵称来代替你的游戏内名称，或者当未提供昵称时，清除你的昵称。
  • 需要管理员权限或 customname.nick 权限。
• /name other <prefix|suffix|nickname> <player>
  • 与各自的 /name <prefix|suffix|nickname> 命令语法相同，但用于设置其他玩家的前缀/后缀/昵称。除了需要相应的 customname.<nametype> 权限外，还需要管理员权限或 customname.other 权限。

当启用高级提示框并悬停在玩家名字上时，将显示他们的真实名称。

/itemname 命令可用于重命名你当前持有的物品。需要管理员权限或 customname.itemname 权限。

类似地，/itemlore 可用于设置你持有物品的描述。需要管理员权限或 customname.itemlore 权限。 \n 可用于创建新行，\\ 可用于转义反斜杠。

与 /name 命令类似，不带参数运行这些命令将重置你持有物品的物品名称/描述。

Minecraft 的格式化代码可用于格式化你的前缀、后缀、昵称或物品名称/描述。 使用 & 代替 § 字符（要在（物品）名称中使用 &，请输入 &&）。 除了 Minecraft 默认的格式化代码外，也可以使用 &#<十六进制代码> 格式。

可用的工具来轻松创建格式化的名称，请访问此处和此处。 可以在配置文件中禁用名称中的格式化代码的使用。

除了 /name 命令外，该模组还支持从 LuckPerms 模组读取前缀和后缀。

配置文件

模组的配置文件位于 {根配置目录}/eclipsescustomname.json。 默认情况下，配置文件如下所示：

{
  "enable_formatting": true,
  "require_permissions": true,
  "blacklisted_names": [],
  "max_name_length": 16,
  "operators_bypass_restrictions": false,
  "display_above_player": {
    "enabled": false,
    "text_opacity": 255,
    "background_color": "#40000000",
    "lines": [
      "luckperms_prefix prefix nickname suffix luckperms_suffix"
    ]
  },
  "name_groups": {
    "prefix": {},
    "nickname": {},
    "suffix": {}
  }
}

• enable_formatting 可用于禁用名称中 Minecraft 格式化代码的使用。
• require_permissions 可用于禁用权限要求。当设置为 false 时，/name、/itemname 和 /itemlore 命令对所有玩家开放。
• blacklisted_names 是一个被禁止的正则表达式列表。当前缀、后缀或昵称匹配其中一个正则表达式时，它们将无法被使用。
• max_name_length 控制玩家前缀/昵称/后缀的长度，最大可为 32。
• operators_bypass_restrictions 可用于为管理员禁用名称限制。启用后，管理员和拥有 customname.bypass_restrictions 权限的玩家可以在昵称中使用空格，绕过最大长度限制等。
• display_above_player 控制玩家的自定义名称是否应在游戏中显示在其头顶上方。这目前与使用队伍隐藏名称标签不兼容。外观可以通过以下选项进一步配置：
  • text_opacity：控制文字的透明度。255 为完全不透明，0 为完全透明。
  • background_color：名称的背景颜色的十六进制值。这是 ARGB 格式，因此前 2 位数字表示 alpha 值。
  • lines：控制玩家头顶显示的文本行。你可以使用此选项自定义在各行中显示哪些名称类型。默认情况下，所有名称类型都显示在一行上。所有可能的名称类型在上面的示例中列出。
• name_groups 可用于为每种名称类型创建名称组。名称组由一系列名称组成，这些名称遵循名称命令中使用的相同格式。你可以通过给予玩家相应组的权限来将玩家分配到一个或多个名称组。然后他们就可以使用这些组中列出的名称。

例如，考虑这个名称组配置：

"name_groups": {
  "prefix": {
    "vip": [
      "&f&l[&7VIP&f&l]",
      "&f&l[&9VIP&f&l]",
      "&f&l[&aVIP&f&l]",
      "&f&l[&bVIP&f&l]",
      "&f&l[&cVIP&f&l]"
    ],
    "legendary": [
      "&f&l[&7Legendary&f&l]",
      "&f&l[&9Legendary&f&l]",
      "&f&l[&aLegendary&f&l]",
      "&f&l[&bLegendary&f&l]",
      "&f&l[&cLegendary&f&l]"
    ]
  },
  "nickname": {},
  "suffix": {}
}

然后你可以给予玩家 customname.group.prefix.vip 权限，以允许他们使用来自 vip 组的前缀，以及 customname.group.prefix.legendary 权限，以允许他们使用来自 legendary 组的前缀。玩家在输入 /name prefix 命令时会看到这些建议的前缀，并且当不带任何参数运行 /name prefix 时，会有一个聊天菜单允许他们选择前缀。

请注意，授予玩家 customname.prefix 权限仍然允许他们使用任何前缀。上述所有内容也适用于昵称和后缀。