字体¶

字体（Font）是资源包中用于控制文本字形显示的客户端资源。基岩版可以通过位图字形、TTF字体和MSDF字体显示文本，资源包可以替换原版字形，也可以注册新的字体供JSON UI等界面文件引用。

概述¶

字体资源通常位于资源包的font目录中。原版资源包含多种字体资源，例如ASCII字形、标准银河字母字形、Unicode字形页、TTF字体文件和MSDF字体文件。

Ore UI使用Minecraft-Seven.ttf和Minecraft-Seven-v4.ttf，其可用字形范围与游戏内常见的JSON UI字体并不完全相同。

位图字形¶

基岩版的传统字体资源使用按Unicode码位分组的位图字形页。常见文件包括default8.png、ascii_sga.png和一系列形如glyph_00.png至glyph_ff.png的字形页。

每个glyph_xx.png文件对应基本多文种平面（Basic Multilingual Plane）中的一段字符。例如，glyph_4e.png对应U+4E00至U+4EFF范围内的字符。每张字形页通常按16×16网格排列字符图像。

字体元数据¶

font_metadata.json用于注册字体文件和字体别名。它通常包含fonts数组和font_aliases数组：

font_metadata.json

{
  "version": 1,
  "fonts": [
    {
      "font_format": "ttf",
      "font_name": "ExampleFont",
      "version": 1,
      "font_file": "font/example_font",
      "lowPerformanceCompatible": false
    }
  ],
  "font_aliases": [
    {
      "alias": "ExampleAlias",
      "fonts": [
        {
          "font_reference": "ExampleFont"
        }
      ]
    }
  ]
}

font_format: 字体格式。常见值包括ttf和msdf。
font_name: 字体的注册名称。其他字体别名或界面文件可以引用该名称。
font_file: 字体文件路径，不包含扩展名。
font_aliases: 字体别名列表。别名可以组合多个字体，并通过字符范围指定回退关系。
font_ranges: 字体适用的Unicode码位范围，范围端点使用十进制整数表示。

游戏内嵌图形字符¶

基岩版在Unicode私有使用区（Private Use Area，PUA）内硬编码了一组图形字符，这些字符在游戏内会自动渲染为对应的图案，而非普通文字。它们可以在任何支持普通文字的场合使用，包括告示牌、书与笔、物品名称和聊天框等。

这些图形字符的码位位于U+E000至U+F8FF区段（即Unicode私有使用区），由游戏引擎将其映射到特定的字形图像上，包括HUD图标（饥饿值、护甲值、生命值等）、物品与方块图标、市场货币图标以及各平台控制器按键图标。

任天堂Switch不兼容

修改上述原版游戏内嵌图形字符所对应的材质与任天堂Switch平台不兼容。

自定义表情图案¶

通过替换资源包中特定字形页的方式，可以在游戏内嵌图形字符的位置上放置自定义图案。glyph_E0.png对应U+E000至U+E0FF段，glyph_E1.png对应U+E100至U+E1FF段，以此类推。每张字形页按16×16网格排列字符图像，共256个位置。

通过在资源包的font/目录中放置修改后的字形页，即可将某个PUA码位的渲染图案替换为自定义图案，从而实现"自定义表情符号"效果。替换后，玩家在游戏内输入对应码位的字符时，便会看到自定义图案，而非原版图案。

JSON UI控件可以通过font_type指定字体名称或字体别名：

{
  "namespace": "example",
  "example_label": {
    "type": "label",
    "font_type": "ExampleFont",
    "text": "示例文本"
  }
}

字体引用只改变文本渲染方式，不改变本地化文本本身。若一行文本中存在当前字体无法显示的字符，游戏可能回退到其他字体或使用缺字图像。

性能与兼容性¶

自定义字体可能显著增加文本渲染成本，尤其是在字体覆盖范围很大、界面文本很多或设备性能较低时。为减少问题，资源包应尽量限制字体覆盖范围，避免注册过多大型字体，并在低端设备上测试界面、聊天、物品名称和长文本页面的显示表现。

字体¶

概述¶

相关页面¶