默认图片分组与素材包
一个主题命名空间、适度用途分组,以及可独立分发的登记配置和图片
默认主题统一使用 xerr_ui。命名空间区分作者或主题,basename 区分用途,ID 区分组内具体图片。独立分发一个图片组,不需要另造命名空间。
从「资源」进入 xerr_ui,再选择用途组;生命与饥饿在一起,经验和 BossBar 各自分组。截图可点击放大。
七个默认图片组
| basename | 内容与 ID 示例 | 下载 |
|---|---|---|
icon | 通用图标:health、hunger、clock、gem、scene_logo 等 | ZIP |
panel | 面板和外框:profile、notice、dialog、hotbar_frame | ZIP |
player_status | 生命与饥饿:health_full、health_empty、health_trail、hunger_full、hunger_empty | ZIP |
experience | 经验条:full、empty | ZIP |
compass | 方位、横线、指针、刻度和目标:north、indicator、home 等 | ZIP |
background | 文字与信息栏背景:stack_center、time_left、announcement_edge、announcement_center 等 | ZIP |
bossbar | 七色和分段 BossBar 素材,含 1.21.6 分段版本 | ZIP |
所有组都包含自己的 config.yml 和 textures,放在 core/assets/image/xerr_ui 下。ZIP 使用插件相对路径,解压到 plugins/Xerr 即可放入正确位置。
原版 Hotbar 的四张覆盖图片是唯一单独的客户端纹理组,位于 core/assets/hotbar:下载原版 Hotbar 纹理。它们不混入经验条,也没有独立命名空间。
生命与饥饿共用一组
在布局里引用生命条:
progress:
namespace: xerr_ui
basename: player_status
image:
full: health_full
empty: health_empty
fill:
direction: left-to-right
steps: auto
variables:
total: "player max health"
current: "player health"
refresh: 5
trail:
image: health_trail
delay: 8
duration: 12
easing: ease-out饥饿条使用同样的 namespace/basename,将图片换成 hunger_full、hunger_empty 并设置对应数值即可。字段说明见图片进度。
BossBar 使用普通图片登记
BossBar 由 Xerr 绘制,不是把用户图片作为原版 GUI 直接覆盖。图片来自同一个登记体系,没有额外的 core/assets/bossbar 用户目录。
在 core/display/external-bossbars.yml 中选择图片组:
bar:
y: 12
namespace: xerr_ui
basename: bossbar渲染器根据 ID 查登记项及其 path,然后生成进度图集和位图字体。文件名可以与 ID 不同;更换主题时调整 namespace/basename,即可读取另一套普通图片组,不需要修改代码。
颜色和分段角色用明确 ID,例如 red_background、red_progress、notched_6_progress;1.21.6 版本使用 notched_6_progress_1_21_6 等 ID。默认有 30 张静态图片,显示高度 5 像素,源画布 182×5。组名写错、已登记文件丢失或尺寸错误会报错;缺少某个角色时使用内部原版素材。
改图后执行 /xerr reload、/xerr pack 并加载新资源包。libs/bossbar 和隐藏原生 HUD 黄条的透明贴图是引擎内部资源,不作为用户外观分发。
图片组与完整成品
这些下载是图片素材组,不是完整编辑项目,也不是玩家直接加载的资源包。素材登记后,普通图片需要在布局中使用;BossBar 图片组由现有捕获渲染器使用。不会自动新增 HUD。
分发完整 HUD、罗盘或通知成品时,还需要对应布局、模板、显示配置和必要字体。一个成品可以携带多个用途组;采用作者或主题专属命名空间及配置 ID,避免覆盖购买者已有内容。继续制作见布局与 HUD、罗盘和通知。
源码中执行 python3 tools/package_default_assets.py --package player_status experience --output /tmp/xerr-assets 可导出图片组。相同内容的 ZIP 可复现,不混入测试圆环、旧固定面板和多余说明文件。