跳转到正文
iPlugin

默认图片分组与素材包

一个主题命名空间、适度用途分组,以及可独立分发的登记配置和图片

默认主题统一使用 xerr_ui。命名空间区分作者或主题,basename 区分用途,ID 区分组内具体图片。独立分发一个图片组,不需要另造命名空间。

同一个 xerr_ui 主题下的七个默认图片用途组

从「资源」进入 xerr_ui,再选择用途组;生命与饥饿在一起,经验和 BossBar 各自分组。截图可点击放大。

七个默认图片组

basename内容与 ID 示例下载
icon通用图标:health、hunger、clock、gem、scene_logo 等ZIP
panel面板和外框:profile、notice、dialog、hotbar_frameZIP
player_status生命与饥饿:health_full、health_empty、health_trail、hunger_full、hunger_emptyZIP
experience经验条:full、emptyZIP
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 纹理。它们不混入经验条,也没有独立命名空间。

生命与饥饿共用一组

config.yml
health_full.png
health_empty.png
health_trail.png
hunger_full.png
hunger_empty.png

在布局里引用生命条:

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 可复现,不混入测试圆环、旧固定面板和多余说明文件。