> For the complete documentation index, see [llms.txt](https://3504743864.gitbook.io/yu-lan/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3504743864.gitbook.io/yu-lan/plugin-usage/adding-content/font-images/manually-creating-font-images.md).

# 手动创建 字符图像（font images）

## 在不使用 ItemsAdder 的情况下手动创建 字符图像（Font images）

某些服务器可能出于各种原因需要手动创建字体图像，例如：

* 不希望 ItemsAdder 管理字符图像
* 想为某些自定义字符使用自定义命名空间和自定义字体名称
* 想自己管理字符图像文件

## 创建一个自定义字符

```json
{
   "file":"image_test.png",
   "chars":[
      "\uE250"
   ],
   "height":8,
   "ascent":9,
   "type":"bitmap"
}
```

如上，我创建了一个 json 配置条目，这是我的自定义字符图像设置列表.

现在你需要将其添加至 `assets/minecraft/font/default.json` 文件中的`"providers"` 属性下.

```json
{
   "providers":[
      {
         "file":"image_test.png",
         "chars":[
            "\uE250"
         ],
         "height":8,
         "ascent":9,
         "type":"bitmap"
      }
   ]
}
```

如果你有多个条目需要添加，请在上一个条目结尾添加一个 `,`，如下所示：

```json
{
   "providers":[
      {
         "file":"image1.png",
         "chars":[
            "\uE233"
         ],
         "height":8,
         "ascent":9,
         "type":"bitmap"
      },
      {
         "file":"image_test.png",
         "chars":[
            "\uE250"
         ],
         "height":8,
         "ascent":9,
         "type":"bitmap"
      }
   ]
}
```

## 使用自定义的 json 文件名

通过使用自定义的 json 字体文件，可以将默认的字体字符与自定义字符分开 你只需要创建一个新的 json 文件，并将其命名为你想要的名称，例如 `my_font.json`. 创建完后的路径将会是: `assets/minecraft/font/my_font.json`.

{% hint style="warning" %}
该功能仅适用于 Minecraft 1.16+
{% endhint %}

## 使用自定义的 json 命名空间

当你想进一步的整合你的资源包，可以为你的字体文件使用一个自定义的命名空间

所以你需要在 `assets` 文件夹中创建一个新的文件夹，而不是在 `minecraft` 文件夹下创建

创建完后的路径将会是：`assets/your_namespace/font/my_font.json`

{% hint style="warning" %}
该功能仅适用于 Minecraft 1.16+
{% endhint %}

### 在游戏中显示自定义 命名空间/字体名称

当你自定义了字体命名空间和字体名称，你需要使用特殊指令在游戏中显示自定义图像.

如：同时设置了自定义命名空间和自定义字体名称：

`/tellraw @a [{"text":"Test message!","font":"your_namespace:my_font"}]`

如：只设置了自定义字体名称:

`/tellraw @a [{"text":"Test message!","font":"my_font"}]`


---

# 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:

```
GET https://3504743864.gitbook.io/yu-lan/plugin-usage/adding-content/font-images/manually-creating-font-images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.