# ❓️ 常见问题

## 问题 1: 紫色的Boss栏

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

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

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

```TXT
<font:minecraft:default>%img_xxx%</font>  # 不要忘记关闭标签
```

## 问题 3: 背景与文本不匹配

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

![](https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/1JVXlcaCLiVF1ixlTVHf/image.png)

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

## 问题 4: 我使用的是自定义位图字体

如果通过位图使用自定义字体，只需将其放入插件的 /font 文件夹并覆盖前一个即可。然后从插件文件夹中删除`/tmp`文件夹。最后，重新启动服务器。

![](https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/BTfk13Hn9J6bVKgVLDNF/image.png)

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

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

![](https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/r4H7FbAHy0NMD10VKHgL/image.png)

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

## 问题 6: 我想向下或向上移动图像

如果图像是由 CustomNameplates 注册的，只需编辑`ascent`选项即可。

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

![](https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/DNmP0b7BPqem6RwAG2Hm/image.png)

## 问题 7: 玩家看不到boss栏 <a href="#q7-players-cant-see-bossbar" id="q7-players-cant-see-bossbar"></a>

您应该给予他们“bossbar.show”权限或从 bossbar 配置中删除权限条件。

```yaml
bossbar_1:
  conditions:
    condition_1:
      type: permission
      refresh-interval: 20
      value:
        - bossbar.show
```

## 问题 8: 气泡不起作用

这是因为任何聊天插件都会取消玩家聊天事件。要解决这个问题，首先检查 config.yml 中是否正式支持该插件，并启用集成（如果可用）

```yaml
integrations:
  # 某些聊天，例如管理员聊天或菜单输入，可能需要从捕获中排除。
  # 支持的聊天插件如下所示，允许黑名单频道和 /ignore 功能正常工作。
  chat:
    TrChat: false
    VentureChat: false
    HuskChat: false
    CarbonChat: false
    AdvancedChat: false
    Essentials: false
```

如果您使用不受支持的插件，您可以提出建议，但前提是该插件具有 API 存储库。最糟糕的解决方案是在 config.yml 中打开`unsafe-chat-event`

## 问题 9: Boss栏与HUD插件冲突

在 config.yml 中将`send-delay`设置为适当的值可以修复

## 问题 10: 着色器冲突

如果遇到着色器冲突，则需要合并着色器（这需要一些 GLSL 知识）或禁用 CustomNameplates 着色器。

## 问题 11: 超暗背景

如果您发现背景的颜色异常的暗，则意味着着色器尚未成功应用于您的客户端。这通常是由着色器冲突引起的，因为客户端一次只能应用一个着色器。如果您需要使用多个着色器，则必须手动合并它们。如果您无法解决该问题，可以考虑降低图像的不透明度作为替代解决方案。这有助于减轻着色器冲突的视觉影响。

（可以在此处下载替代图像。如要使用请替换 /contents/backgrounds/ 文件夹下的图像）

{% file src="<https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/luGW6zfyAET8JelAoMcp/backgrounds.zip>" %}

<figure><img src="https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/79SdcmlUIEVkBYDaaoQN/image.png" alt=""><figcaption></figcaption></figure>

## 问题 12: 玩家名称显示为“□□□□”

出现此问题的原因是运行版本 1.19.4 到 1.20.3 的客户端无法读取**unifont\_jp** ，并且 1.19.4 客户端无法读取**unifont** 。这意味着某些字体和特定 Minecraft 版本之间的兼容性可能会导致显示问题。

如果您运行的是 1.20+ 服务器并且您确实不需要它，可以考虑删除**unifont\_jp** ，如下例所示：

```yaml
# config.yml
shift-fonts:
  shift_0:
    - space
    - nonlatin_european:7
    - accented:9
    - ascii:7
    #- unifont_jp
    - unifont
```

如果您运行的是 1.19.4 服务器，则可以按以下示例所示进行配置：

```yaml
# config.yml
shift-fonts:
  shift_0:
    - space
    - nonlatin_european:7
    - accented:9
    - ascii:7
    - unicode
```

<figure><img src="https://content.gitbook.com/content/s87C1OsSEHzpv1XHzgIN/blobs/tc009cngyVa8pa7DTVQc/image.png" alt=""><figcaption></figcaption></figure>

## 问题 13: 如何使用TTF字体

取消注释 `config.yml` 中的 `ttf` 部分，并将 `example` 替换为你使用的字体名称。然后将你的 TTF 文件放在 `/CustomNameplates/font` 目录下，并重启服务器。

```yaml
ttf:
  example:
    generate: false               # 是否将此 TTF 文件包含在生成的资源包中
    file: example.ttf             # 定义加载字体的 TTF 文件
    size: 10.0                    # 设置字体大小
    oversample: 8.0               # TTF 渲染的过采样率
    skip: []                      # 以列表格式跳过的字符
```

然后你就可以在 shift-fonts 中使用 ttf 字体了

```yaml
shift_3:
  - space
  - example:3  # 这里的数字是 Y 轴偏移量
```

请注意，ttf 文字的前进量计算可能不准确。因此，目前不建议用于非常大的字体。如果你发现某个字符的前进量不正确，可以使用文本编辑器编辑 `/tmp/xxx.tmp` 中相应字符的前进量数据 `（需要重启服务器才能生效）`