> For the complete documentation index, see [llms.txt](https://itemsadder.devs.beer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itemsadder.devs.beer/chinese/cha-jian-shi-yong-fang-fa/adding-content/font-images/common-errors.md).

# 常见错误

## 我只看到了白色方块

如果你看到了**白色方块**，确保你图像的**高度不高于**你设置的 `y_position`。\
要**绕过**该限制，你需要创建一个**高度更高**的图像。

图像文件名与文件夹也不能含有**大写**或者**不合适的字符**（如 `*`, `à`, `ù`, `=`, `$`, 空格等）。

{% hint style="warning" %}
记住字体图像的**最大尺寸**是**256x256**。\
这是 Minecraft 的限制。\
要绕过该限制（例如创建 GUI 或 HUD），你可以分割你的图像为多分，而后通过前后移动来合并。
{% endhint %}

## 某些情况 HUD 移动不准确

确保将图像大小设置为 2 的倍数（2x2, 4x4, 6x6, 8x8, 10x10, etc.）。

如果仍有问题，尝试以 2 为大小增大/减小图像尺寸至错误位移消失。\
我无法修复该问题

## GUI 图像被是彩色的

你需要在 GUI 的名称中指定能够被自定义菜单自动染色的 **GUI 图像名称** `title: :myimage: My Custom GUI`。在 GUI 中使用 `:myimage:` 前不要忘记添加 `&f`。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://itemsadder.devs.beer/chinese/cha-jian-shi-yong-fang-fa/adding-content/font-images/common-errors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.