Kzeroko KTM2

装备词缀数据

原生宝石词缀定义、抽取配置与装备消耗品动作。

更新于 2026/11/1 4 分钟阅读

装备词缀属于原生宝石数据:每件符合条件的装备物品堆持有一个固有词缀,与镶孔独立。内置目录包含 324 个定义、668 条属性或物品效果。

文件放在哪里

定义位于 data/<namespace>/gem_affixes/<path>.json,抽取来源位于 data/<namespace>/gem_affix_profiles/<path>.json。文件路径决定 ID;高优先级同 ID 资源整体替换定义。内置来源为 isekaiexpansion:imprint、isekaiexpansion:blacksmith 和 isekaiexpansion:merchant。

最小示例

保存为 data/example/gem_affixes/resolute.json,并在资源包提供对应翻译键。

{
  "name": "affix.example.resolute",
  "color": "light_purple",
  "rarity": "epic",
  "items": [
    "minecraft:iron_sword"
  ],
  "slots": [
    "mainhand"
  ],
  "attributes": [
    {
      "attribute": "minecraft:generic.attack_damage",
      "amount": 1.5,
      "operation": "ADDITION"
    }
  ]
}

字段

字段类型默认值含义
namestringrequired词缀名称翻译键。
colorstringrequiredMinecraft 命名文字颜色;仅格式名称不接受。
rarityenumrequiredcommon、uncommon、rare、epic、legendary、unique,不区分大小写。
weightnumber1; finite ≥ 0选定稀有度内的相对权重;0 禁止抽取。
itemsarray<identifier>[]已注册物品;items 或 tags 至少有一个非空。
tagsarray<identifier>[]不带 # 的物品标签;任一目标匹配即可。
slotsarray<enum>required; nonemptymainhand、offhand、head、chest、legs、feet;护甲还必须处于其实际装备槽。
attributesarray<object>[]属性修饰行。
attributes[].attributeidentifierrequired已注册属性。
attributes[].amountnumberrequired; finite修饰值,支持负数。
attributes[].operationenumrequiredADDITION、MULTIPLY_BASE、MULTIPLY_TOTAL,区分大小写。
propertiesobject物品堆级别属性。
properties.durabilitynumber0; 0–10最大耐久倍率为 1 + 数值。
properties.mining_speednumber0; 0–10挖掘速度倍率为 1 + 数值。
fabric:load_conditionsarray<object>absent解析前检查 Fabric 资源条件。

抽取配置

铭印和商人来源使用下列分布。铁匠来源使用史诗 765、传说 135、独特 100,较低稀有度为 0。

{
  "rarities": {
    "common": 40,
    "uncommon": 30,
    "rare": 20,
    "epic": 10,
    "legendary": 5,
    "unique": 3
  },
  "levels_per_rank": 20,
  "suppression": 0.15,
  "quality_influence": 2.5
}
字段类型默认值含义
raritiesobjectrequired非负有限稀有度权重,至少一项为正;省略的稀有度权重为 0。
rarities.common / rarities.uncommon / rarities.rare / rarities.epic / rarities.legendary / rarities.uniquenumber0相对稀有度权重,不是概率。
affixesarray<identifier>[]可选词缀 ID 白名单,必须存在;空列表接受全部匹配定义。
levels_per_ranknumber20; finite > 0装备熟练等级缩放分母。
suppressionnumber0.15; 0 < value ≤ 1对低于熟练等级基准的稀有度进行连续权重抑制。
quality_influencenumber0,范围 0–8工艺品质对稀有度的影响强度。内置铁匠为 5,铭印为 2.5,商人为 0。

稀有度序号 r 为 0–5,熟练等级为 m,floor = min(5, max(0, m − 1) / levels_per_rank)。基础权重先乘以 suppression 的 max(0, floor − r) 次方,再乘以 2^((quality - 0.8) * quality_influence * r)。没有工艺标记的装备取 0.8,较高品质偏向较稀有的候选档次,较低品质偏向较普通的档次。零权重始终为零。选定档次后,再按定义自身权重抽取一个匹配词缀。

宝石消耗品动作

isekaiexpansion:imprint_equipment_affix 要求符合条件且尚无词缀的装备;isekaiexpansion:reroll_equipment_affix 要求已有有效词缀。两者的 data.profile 为已存在的抽取配置 ID,默认 isekaiexpansion:imprint。目标为 EQUIPMENT,不占用镶孔。重铸动作支持 keep_choice;保留或放弃预览都会消耗试剂。外围消耗品字段见宝石数据。

校验

缺少必填字段、未知物品或属性 ID、无效枚举、非有限数值和越界值会拒绝宝石重载。未知可选字段被忽略。空目标列表、空装备槽列表以及无正权重的配置会被拒绝。白名单词缀或消耗品引用的配置不存在也会拒绝。标签按当前物品标签解析,空标签不匹配任何物品。失败时继续使用先前的完整宝石快照。

重载

词缀与宝石定义一起原子重载,在加入和成功重载时同步。装备只在 ise_affix 中保存词缀 ID;移除定义后效果停用。重铸保留镶孔、附魔、熟练等级及无关 NBT,最大耐久变化时保留损伤比例。不依赖外部词缀系统,也不读取旧数据。

相关页面

宝石与镶孔说明消耗品;锻造说明工艺品质;宝石运行时说明实现约定。