1. 添加字体
放入 TTF 文件并登记 tutorial_font
本页只完成字体资产准备，不写 Layout，也不显示 HUD。
要准备的文件
tutorial.ttf
tutorial.yml
放入 TTF
把服务器现有的 core/assets/font/ttf/fusion_pixel.ttf 复制一份，命名为 tutorial.ttf，放在同一个 ttf 目录。不要移动或删除原文件，默认主题仍会用它。
登记字体 ID
新建 core/assets/font/tutorial.yml，完整内容如下：
tutorial_font:
ttf: tutorial
size: 10
oversample: 5.0检查名字是否对应
| 配置 | 对应内容 |
|---|---|
tutorial_font | 以后在 Layout 中引用的字体 ID |
ttf: tutorial | ttf 目录中的 tutorial.ttf，不写后缀 |
size: 10 | 显示字号 |
oversample: 5.0 | 字体采样倍率，先保留即可 |
字体大小与宽度
字号控制文字显示大小。Xerr 自动读取 TTF 字符前进量，计算对齐、文字背景和信息栏占位，无需维护字符宽度规则。详见字体参考。
更换字体或修改字号、采样后，重新打包并让客户端加载新资源包。
完成检查
tutorial.ttf已经存在。tutorial.yml中写的是ttf: tutorial。- 字体 ID 没有与其它文件重复。
这时还看不到新 HUD，是正常的。接下来要准备图片，再由 Layout 引用字体。
下一步: 添加图片
创建 tutorial/ui 图片组并登记 gem。