跳到正文
烈焰甘蔗Wiki

配色与样式（Color Type & Style）

基本信息

属性 值
样式枚举 com.caedis.duradisplay.overlay.OverlayDurabilityLike.Style
颜色枚举 com.caedis.duradisplay.utils.ColorType
数字格式枚举 com.caedis.duradisplay.utils.DurabilityFormatter.Format
配置基类 com.caedis.duradisplay.config.ConfigDurabilityLike

样式 Style 枚举

值 渲染器 说明
Text TextRenderer 在物品上叠加文本（百分比/剩余次数/分数等），numpad 1-9 选位
Bar BarRenderer 物品底部 13×1 像素条
VerticalBar VerticalBarRenderer 物品右侧 1×13 像素竖条

数字格式 DurabilityFormatter.Format 枚举

值 输出格式 示例（current=257, max=1024）
PERCENT 0-100% 整数（查表缓存 0-100） 25%
REMAINING 短格式当前值 257
USED 短格式 max - current 767
MAX 短格式最大值 1k
FRACTION current/max 整数 257/1024
CONTAINER 自适应（max≥100 不显示分母；≥1000 显示 *） 257（max < 1000）

短格式 shortenNumber

  • >= 1_000_000_000：1.2b
  • >= 1_000_000：2.5m
  • >= 1_000：257
  • 整数小值：Long.toString(whole)
  • 否则 DecimalFormat("0.#")：例如 12.5

颜色 ColorType 枚举

值 算法 用途
RYGDurability HSBtoRGB(max(0, percent)/3, 1, 1)，0% 纯红、33% 纯黄、66%+ 纯绿 默认 Durability / Container overlay
Threshold 按 colorThreshold 阈值返回 threeColors[0/1/2] 阈值分段（低/中/高三色）
Vanilla (255 - k) << 16 | k << 8，仿原版耐久度条的红→绿 原版条带兼容
Single 直接返回 cfg.color（hex RGB） 纯色
Smooth 在 threeColors[0] 与 threeColors[1] 之间，再与 threeColors[2] 二次插值 多色渐变（默认 Charge overlay）

Threshold 三色规则（cfg.colorThreshold = {30, 70} 默认）

  • durability% ≤ 30：返回 threeColors[0]（默认红 0xFF0000）
  • durability% ≥ 70：返回 threeColors[1]（默认黄 0x55FF00）
  • 其余：返回 threeColors[2]（默认绿 0x00FF00）

注意源码里 [1] 与 [2] 的角色与通常命名相反：黄在中段、绿在最高段。

Smooth 渐变（双段插值）

输入：低色 threeColors[0]、中色 threeColors[1]、高色 threeColors[2]，percent ∈ [0,1]。

  1. 在 c0 ↔ c1 间生成 (r,g,b)（percent 权重）
  2. 在 c1 ↔ c2 间生成 (r2,g2,b2)
  3. 最终 (r3,g3,b3) = (r,g,b)·(1-percent) + (r2,g2,b2)·percent

效果：从 0% 到 100% 平滑经过三个锚点；默认（橙灰 → 冷蓝 → 青）形成冷暖过渡。

各 overlay 默认样式对照表

Overlay Style Format Color ColorType ThreeColors NumPad Pos
Durability Text PERCENT 0x00FF00 RYGDurability {0xFF0000, 0x55FF00, 0x00FF00} 2
Charge Text PERCENT 0xFF55FF Smooth {0xFFB9AA, 0xBDD6FF, 0x55FFFF} 8
Gadgets Text REMAINING 0xFFFFFF Single {0xFF0000, 0xFFBDC8, 0xFFFFFF} 2
Container Text CONTAINER 0x00FF00 RYGDurability {0xFF0000, 0x55FF00, 0x00FF00} 2
PotionBrew Text REMAINING 0xFFFFFF Single {0xFF0000, 0xFFBDC8, 0xFFFFFF} 2

配置路径

ConfigDurabilityLike.loadConfig 把样式/颜色拆到子分类：

路径 键
<category> Enable、ShowWhenFull、ShowWhenEmpty
<category> Style（顶层枚举值）
<category>.StyleConfig.Text Position（1-9）、TextFormat
<category>.Color ColorType、Color（hex）、ThreeColors（hex 数组）、ColorThresholds（双值，0-100）
<category>.StyleConfig.Bars SmoothBar、BarOffset（0-16）、ShowBackground

相关条目

浏览全部模组