Fabric Custom Names

自定义名称

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

还支持通过 LuckPerms 设置的前缀/后缀！

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

许可证

本模组采用 GNU LGPLv3 许可证授权。

捐赠

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

Discord

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

版本支持

我尽量保持对最新 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

`

• 语法与相应的 `/name

命令相同，但用于设置其他玩家的前缀/后缀/昵称。除了相应的 customname. 权限外，还需要管理员权限或 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"
  },
  "name_groups": {
    "prefix": {},
    "nickname": {},
    "suffix": {}
  }
}

• enable_formatting 可用于禁用名称中使用 Minecraft 格式化代码。
• require_permissions 可用于禁用权限要求。设置为 false 时，/name、/itemname 和 /itemlore 命令对所有人可用。
• blacklisted_names 是一个正则表达式列表，这些表达式被列入黑名单。当前缀、后缀或昵称匹配这些正则表达式之一时，将无法使用。
• maxnamelength 控制玩家前缀/昵称/后缀的最大长度，最多为 32 个字符。
• operatorsbypassrestrictions 可用于为管理员禁用名称限制。启用后，管理员和拥有 customname.bypass_restrictions 权限的玩家可以在昵称中使用空格，绕过最大长度限制等。
• displayaboveplayer 控制是否在游戏中玩家头顶显示其自定义名称。目前与使用队伍隐藏名称标签不兼容。可以使用以下选项进一步配置外观：
• text_opacity：控制文本的不透明度。255 表示完全可见，0 表示透明。
• background_color：名称的十六进制背景颜色。这是 ARGB 格式，所以前两位数字表示 alpha 值。
• 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 权限仍将允许他们使用任何前缀。以上所有内容也适用于昵称和后缀。