装备词缀数据
原生宝石词缀定义、抽取配置与装备消耗品动作。
装备词缀属于原生宝石数据:每件符合条件的装备物品堆持有一个固有词缀,与镶孔独立。内置目录包含 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"
}
]
}
字段
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
name | string | required | 词缀名称翻译键。 |
color | string | required | Minecraft 命名文字颜色;仅格式名称不接受。 |
rarity | enum | required | common、uncommon、rare、epic、legendary、unique,不区分大小写。 |
weight | number | 1; finite ≥ 0 | 选定稀有度内的相对权重;0 禁止抽取。 |
items | array<identifier> | [] | 已注册物品;items 或 tags 至少有一个非空。 |
tags | array<identifier> | [] | 不带 # 的物品标签;任一目标匹配即可。 |
slots | array<enum> | required; nonempty | mainhand、offhand、head、chest、legs、feet;护甲还必须处于其实际装备槽。 |
attributes | array<object> | [] | 属性修饰行。 |
attributes[].attribute | identifier | required | 已注册属性。 |
attributes[].amount | number | required; finite | 修饰值,支持负数。 |
attributes[].operation | enum | required | ADDITION、MULTIPLY_BASE、MULTIPLY_TOTAL,区分大小写。 |
properties | object | 物品堆级别属性。 | |
properties.durability | number | 0; 0–10 | 最大耐久倍率为 1 + 数值。 |
properties.mining_speed | number | 0; 0–10 | 挖掘速度倍率为 1 + 数值。 |
fabric:load_conditions | array<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
}
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
rarities | object | required | 非负有限稀有度权重,至少一项为正;省略的稀有度权重为 0。 |
rarities.common / rarities.uncommon / rarities.rare / rarities.epic / rarities.legendary / rarities.unique | number | 0 | 相对稀有度权重,不是概率。 |
affixes | array<identifier> | [] | 可选词缀 ID 白名单,必须存在;空列表接受全部匹配定义。 |
levels_per_rank | number | 20; finite > 0 | 装备熟练等级缩放分母。 |
suppression | number | 0.15; 0 < value ≤ 1 | 对低于熟练等级基准的稀有度进行连续权重抑制。 |
quality_influence | number | 0,范围 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,最大耐久变化时保留损伤比例。不依赖外部词缀系统,也不读取旧数据。