图片与 GIF
图片目录、登记字段和 GIF 转换的完整参考
需要完整操作流程时，先阅读添加图片。本页代码未标为完整文件时，均为对应节点中的片段。
文件关系
config.yml
gem.png
spin.gif
目录规则
core/assets/image/<namespace>/<basename>/config.yml
core/assets/image/<namespace>/<basename>/textures/*.png
core/assets/image/<namespace>/<basename>/animation/*.gif配置示例：
img:
coin:
path: coin
height: 16图片地址是：
namespace + basename + 顶层图片 ID图片字段
| 字段 | 类型 / 省略值 | 说明 | 生效 |
|---|---|---|---|
path | 字符串 / 空 | 文件名；不含扩展名时按 PNG 读取 | 打包 |
height | 整数 / 0 | GUI 显示高度；静态图宽度按原图比例计算 | 打包 |
symbol | 单字符字符串 / 无 | 可选，将图片映射为可直接输入的默认字体字符 | 打包 |
ascent | 整数 / 0 | 仅 symbol 使用的原生字体上升值 | 打包 |
animation | 布尔 / false | 把 animation/<path>.gif 作为动画处理 | 打包 |
duration | 小数 / 1.0 | GIF 完整动画时长，单位秒 | 打包 |
正常 Layout 图片建议填写正数 height。height: 0 会尝试使用源 PNG 像素宽度，但不能提供可靠的显示高度。
PNG
img:
coin:
path: coin
height: 16文件：
textures/coin.pngGIF
img:
coin_animation:
path: coin
height: 16
animation: true
duration: 2.0文件：
animation/coin.gif打包时 Xerr 会把 GIF 帧转换为客户端动画纹理。GIF 显示宽度按配置高度处理，建议使用方形帧或实际测试比例。
symbol
img:
logo:
path: logo
height: 16
symbol: "◆"
ascent: 12设置后，Xerr 会把贴图加入 Minecraft 默认字体提供器，可以在普通文本中输入该字符。常规 HUD 更推荐使用 image.id，避免字符冲突。
Layout 引用
完整地址：
image:
namespace: my_ui
basename: icons
id: coin继承 Layout defaults.image 后：
image:
id: coin测试命令
/xerr print img my_ui icons coin
/xerr print img my_ui icons coin title 10 40 10
/xerr print img my_ui icons coin subtitle 10 40 10Title 和 Subtitle 的数字依次为淡入、停留和淡出 tick。
复用默认图片时，按默认图片资产包查找组件包与图片分组，不再从混合的 minecraft 目录里挑选。