4. 显示 HUD
绑定 tutorial_welcome,生成资源包并完成第一块 HUD
这一页完成最后一步。前提是已经准备 tutorial_font、tutorial/ui/gem 和 tutorial_welcome,不是从这里跳过资产和 Layout。
本页新增文件
tutorial.yml
绑定 Layout
新建一个独立 HUD 文件,不用修改默认 main:
tutorial:
enabled: true
refresh: 20
layouts:
tutorial_welcome: {}layouts 仍使用映射。{} 是空配置,表示引用这个 Layout,不额外覆盖刷新、条件或变量。
让客户端加载
自托管开启时会发送资源包请求;没有开启时,重新分发服务器资源包。配置正确但客户端没加载新包,仍可能显示方块字符。
检查结果
屏幕中央应该出现宝石和欢迎文字。自带主题还会继续显示,这个教程 HUD 与默认 main 是独立配置。
三种 ID 的关系
| 配置 | ID | 引用对象 |
|---|---|---|
| 字体配置 | tutorial_font | TTF 文件 tutorial.ttf |
| Layout | tutorial_welcome | 字体与图片 |
| HUD | tutorial | Layout tutorial_welcome |
HUD ID 不必与 Layout ID 或文件名相同。
改成玩家欢迎文字
在 Layout 中把 value 改为:
value: "&f欢迎回来,{{ player name }}"只修改内容,执行 /xerr reload。{{ player name }} 是 Kether 表达式,返回看见 HUD 的玩家名。
关闭教程 HUD
在本页创建的 HUD 文件中设置:
enabled: false执行 /xerr reload。字体和 Layout 文件仍然保留,可以被其它显示系统复用。