跳转到正文
iPlugin

4. 显示 HUD

绑定 tutorial_welcome,生成资源包并完成第一块 HUD

这一页完成最后一步。前提是已经准备 tutorial_font、tutorial/ui/gem 和 tutorial_welcome,不是从这里跳过资产和 Layout。

本页新增文件

tutorial.yml

绑定 Layout

新建一个独立 HUD 文件,不用修改默认 main:

plugins/Xerr/core/display/huds/tutorial.yml
tutorial:
  enabled: true
  refresh: 20
  layouts:
    tutorial_welcome: {}

layouts 仍使用映射。{} 是空配置,表示引用这个 Layout,不额外覆盖刷新、条件或变量。

生成资源包

文件全部准备好后,执行:

/xerr pack

Xerr 会重新读取资产、Layout 和显示配置,然后生成 plugins/Xerr/generated/resource_pack。

让客户端加载

自托管开启时会发送资源包请求;没有开启时,重新分发服务器资源包。配置正确但客户端没加载新包,仍可能显示方块字符。

检查结果

屏幕中央应该出现宝石和欢迎文字。自带主题还会继续显示,这个教程 HUD 与默认 main 是独立配置。

三种 ID 的关系

配置ID引用对象
字体配置tutorial_fontTTF 文件 tutorial.ttf
Layouttutorial_welcome字体与图片
HUDtutorialLayout tutorial_welcome

HUD ID 不必与 Layout ID 或文件名相同。

改成玩家欢迎文字

在 Layout 中把 value 改为:

修改 tutorial_welcome.text.value
value: "&f欢迎回来,{{ player name }}"

只修改内容,执行 /xerr reload。{{ player name }} 是 Kether 表达式,返回看见 HUD 的玩家名。

关闭教程 HUD

在本页创建的 HUD 文件中设置:

修改 tutorial.enabled
enabled: false

执行 /xerr reload。字体和 Layout 文件仍然保留,可以被其它显示系统复用。

接下来做什么