常见问题

问题 1: 我的名牌/气泡闪烁 | 背景/图像有重叠的阴影

这是由于着色器未正确应用于您的资源包造成的问题。这通常发生在您使用 ItemsAdder/Oraxen 时，因为它们也有自己的着色器。解决此问题的唯一方法是合并着色器。但不用担心，CustomNameplates 为您提供了一些选项，可以轻松合并一些常见的着色器，您可以在 config.yml 中启用它们。之后，您需要做的就是替换将发送给玩家的资源包中的核心着色器。

如果您使用的是 ItemsAdder，则可以在 config.yml（ItemsAdder 的配置文件）中禁用文本效果：

effects:
  text-effects:
    enabled: false

如果您使用的是 HappyHud 或 BetterHud，则可以通过将以下代码添加到 HappyHud 生成的着色器中来手动合并着色器。（注意：考虑到用户合并的方便性，这只是名牌着色器的一部分代码。仅可保证 80% 的着色器功能正常使用。要使它们 100% 兼容，您必须手动合并完整的着色器，这可能更难）

if (Color.xyz == vec3(255., 254., 253.) / 255.) {
    pos.y += 1;
    pos.x += 1;
} else if (Color.xyz == vec3(254., 254., 254.) / 255.) {
    pos.z -= 0.001;
} else if (Color.xyz == vec3(253., 254., 254.) / 255.) {
    pos.z -= 0.0011;
}

问题 2: 如何配置插件

配置Boss栏

配置动作栏

获取更多条件类型

编辑占位符返回的文本

创建名牌

创建气泡

创建背景

创建图像

问题 3: 紫色的Boss栏

插件中默认的Boss栏应该是黄色的。如果您看到紫色的Boss栏，则是Lunar客户端中的一个错误。

问题 4: 使用 "&" 时控制台报错

我们不再建议使用任何旧的颜色符号，它们早在 1.8 版本就已被弃用，但 SpigotAPI 仍在使用它们。直到 1.16 版本，越来越多的功能是基于组件的，旧版本的颜色代码无法满足功能要求。

如果您坚持使用它，请在 config.yml 中启用 "legacy-color-code-support"。

问题 5: 如何获取资源包

资源包是自动生成的，位于 /plugins/CustomNameplates/ResourcePack。

问题 6: 插件依赖关系/控制台报错刷屏/名牌比玩家的名字长

ProtocolLib PlaceholderAPI + Player拓展

译者注：你直接在控制台输入 papi ecloud download Player 然后输入 papi reload 即可

如果您没有安装 Player 拓展，可能会遇到如下控制台报错刷屏：

问题 7: 我看不到名牌

许多插件使用队伍来制作 Tab 列表/玩家发光。因此，一些插件与 CustomNameplates 的队伍模式不兼容。如果您不使用队伍模式，不用担心，只需在该插件中将玩家的名牌标签设置为不可见即可。

TAB CMI Velocitab Unknown

问题 8: 如何使用 ItemsAdder/Oraxen 中的图像

您应该使用字体标签将图像包围起来，例如：

<font:minecraft:default> 图像 </font>  # 不要忘记关闭标签

问题 9: 背景与文本不匹配

这是因为插件不知道您自定义图像的宽度。如果您在 CustomNameplates 中注册了图像，只需在 YAML 文件中输入图像的宽度。如果您使用其他插件（例如 ItemsAdder）创建新图像，则应在 /configs/font-width-data.yml 中输入您图像的宽度。

minecraft:default:
  default: 8
  template-loading-sequence:
    - unifont
    - nonlatin_european
    - accented
    - ascii
  # 这里的值将覆盖模板中相同的字符
  values:
    默: 8               # 在此处输入字符
    %placeholder%: 17   # 在此处输入占位符

问题 10: 我想将图像向下/向上移动

如果您使用其他插件中的图像，您无法从 CustomNameplates 端将图像向下/向上移动。实际上，这很容易修复，因为在这些插件中，它们提供了一个选项来编辑图像的上升（在 ItemsAdder 中称为 y_position）。

问题 11: 我正在使用自定义的 ascii.png 字体

如果您使用的是通过 ascii.png 自定义的字体，只需将其放入插件的 /font 文件夹中并覆

盖之前的文件即可。然后，删除 /font 文件夹中的 /cache 子文件夹。最后，重新启动服务器。

问题 12: 在 1.17-1.18 客户端上重新加载着色器失败

是时候放弃旧版本了，但是如果您坚持，我也无法阻止您。

在 rendertype_text.vsh 中找到这一行：

vertexDistance = fog_distance(ModelViewMat, IViewRotMat * Position, FogShape);

然后替换为：

vertexDistance = length((ModelViewMat * vec4(Position, 1.0)).xyz);

问题 13: 我在 Tab 中看到其他玩家的名牌

这是一个原版的队伍限制。解决这个问题有两种方法：方法 1：安装一个 Tab 插件方法 2：在 nameplate.yml 中启用 "fix-Tab" 选项

问题 14: 玩家无法使用气泡/无法看到Boss栏/动作栏

您应该首先给予他们 "bubbles.use"/"bossbar.show"/"actionbar.show" 权限。

问题 15: 气泡太高/太低

打开 /configs/bubbles.yml

# 这决定最低的那个气泡的位置
bottom-line-Y-offset: 0.4

问题 16: 所有玩家的标签都错误地一起变化

这通常是由于所有玩家都在同一个队伍中造成的。只有在其他插件为玩家创建真正的队伍时才会发生这种情况。因此，我无法确定是哪个插件造成的问题。如果您的玩家都在一个名为 "CallisionRulexxxx" 的队伍中，这可能是由于 Paper 配置引起的问题。

collisions:
  enable-player-collisions: true  # 在 paper-global.yml 中启用此选项

问题 17: 是什么造成了黑色方框？

这是由于 ItemsAdder 的 hud 造成的。只需在 ItemsAdder 的 config.yml 中禁用即可。

huds:
  enabled: false
  force_color:
    enabled: false
    color: '#FFFFFF'

最后更新于4天前