resource_bar_render_data_type（资源条绘制器）

资源条的 renderer 字段选一种绘制方式，type 写在 renderer 里面。资源条写在 resource 内联 bars 里。

这一族由模组注册，数据包只能选用，不能新增。默认占用空间是 71x8，只有自己覆盖尺寸的绘制器例外。

`mxt:boss_bar`

Origins 风格的条加图标：从一张贴图集里切出背景、填充与一列 8x8 图标，图标与条索引共用同一行号。

字段	类型	默认	说明
`sprite_location`	`SpriteIcon`，只接受贴图	`mxt:textures/gui/resource_bar.png`	贴图集
`bar_index`	Integer，`0..24`	`0`	用贴图集里的哪一条
`icon_index`	Integer，`0..24`	`bar_index`	用贴图集里的哪一个图标
`inverted`	Boolean	`false`	反转填充方向

{"type": "mxt:boss_bar", "bar_index": 1}

`mxt:textured_bar`

底图与填充各画一次，按条自己声明的宽高。

字段	类型	默认	说明
`background_sprite`	`SpriteIcon`	必填	底图
`fill_sprite`	`SpriteIcon`	必填	填充
`width`	Integer，`1..1024`	必填	宽度
`height`	Integer，`1..1024`	必填	高度
`fill_color`	RGB 颜色	`#FFFFFF`	填充着色
`show_value`	Boolean	`false`	是否把当前值画在条上

{
  "type": "mxt:textured_bar",
  "background_sprite": {"texture": "example:textures/gui/qi_bar.png"},
  "fill_sprite": {"texture": "example:textures/gui/qi_bar_fill.png"},
  "width": 71,
  "height": 8,
  "fill_color": "#66CCFF"
}

`mxt:segmented_bar`

离散分段，每段 8 像素宽。

字段	类型	默认	说明
`segments`	Integer，`1..256`	必填	分段数量
`gap`	Integer，`0..32`	`1`	分段之间的间隔
`full_color`	RGB 颜色	`#FFFFFF`	已填充分段的颜色
`empty_color`	RGB 颜色	`#555555`	空分段的颜色

{"type": "mxt:segmented_bar", "segments": 10, "gap": 2, "full_color": "#66CCFF"}

`mxt:radial_bar`

环形条。

字段	类型	默认	说明
`radius`	Integer，`1..512`	必填	半径
`thickness`	Integer，`1..128`	必填	环的粗细
`start_angle`	Double	`0`	起始角度，单位为度
`end_angle`	Double	`360`	结束角度，单位为度
`fill_color`	RGB 颜色	`#FFFFFF`	填充着色

{"type": "mxt:radial_bar", "radius": 16, "thickness": 3, "fill_color": "#66CCFF"}

`mxt:text_only`

只画文本，不画条。

字段	类型	默认	说明
`format`	String	`%current%`	文本格式
`color`	RGB 颜色	`#FFFFFF`	文本颜色
`show_maximum`	Boolean	`false`	格式里没写 `%maximum%` 时是否把最大值缀在末尾

{"type": "mxt:text_only", "format": "%current% / %maximum%", "color": "#66CCFF"}

格式里的 %current% 与 %maximum% 分别替换成当前值与最大值；show_maximum 只在格式里没有 %maximum% 时才补一次最大值。

`mxt:missing`

没有任何视觉表现的占位绘制数据。

字段	类型	默认	说明
—	—	—	没有字段。

{"type": "mxt:missing"}

分段条的宽度是 segments * 8 + (segments - 1) * gap 像素；环形条在两个方向上都占 radius * 2 + thickness 像素；mxt:boss_bar、mxt:text_only 与 mxt:missing 用默认的 71x8；mxt:textured_bar 用自己声明的宽高。颜色一律写 #RRGGBB（整数或 [r,g,b] 浮点数组也接受），一律按不透明处理。绘制在客户端进行，只显示服务端同步过来的数值。

mxt:boss_bar 的 sprite_location 与 mxt:textured_bar 的两个贴图字段都是 SpriteIcon，不是裸 Identifier。裸字符串沿用字段本来的含义：sprite_location 是贴图路径，background_sprite / fill_sprite 是 GUI 图集精灵。对象形式要么写 {"sprite": ...} 点名图集精灵，要么写 {"texture": ...} 点名一张贴图。

贴图对象里的 region 取贴图的一块，字段是 u / v / texture_width / texture_height，默认起点 0,0、整图 256×256；width / height 是画出来的目标尺寸，必须成对写，省略就按条自己的宽高画。

三条加载期约束：mxt:boss_bar 要拿贴图切背景、填充、图标三种格子，所以 sprite_location 只接受贴图；精灵不能声明 region；对象里 sprite 与 texture 必须恰好写一个，两个都写或都不写都是错误，width / height 只写一个同样是错误。

尺寸只属于背景那一侧：background_sprite 与 mxt:boss_bar 的贴图可以写 width / height，fill_sprite 上写的尺寸不生效——填充按条自己的进度裁出来，固定尺寸没有意义，那两个键不参与绘制，画出来的只有背景那一份尺寸。

SpriteIcon 与 ability.icon / resource.icon 用的图标引用不是同一个值：图标引用是一张 16x16 贴图或一个物品、只画一格，没有 region / width / height，也不认 {"sprite": ...}；反过来 SpriteIcon 也写不成物品。

mxt:boss_bar​

mxt:textured_bar​

mxt:segmented_bar​

mxt:radial_bar​

mxt:text_only​

mxt:missing​