Kzeroko KTM2

金属加工配方数据

实体部件锻造的材料数量、像素轮廓与温度区间。

更新于 2026/11/13 5 分钟阅读

部件配方描述从整块坯料中敲出的轮廓。金属的温区、升降温速度与韧性由材料文件统一定义。

文件放在哪里

部件配方位于 data/<namespace>/recipes/<path>.json,材料位于 data/<namespace>/smithing_materials/<path>.json。同 ID 的定义以优先级最高的数据包为准。

最小示例

{
  "type": "isekaiexpansion:metalworking",
  "input": {
    "item": "minecraft:iron_ingot"
  },
  "count": 1,
  "result": {
    "item": "isekaiexpansion:iron_connector"
  },
  "material": "isekaiexpansion:iron",
  "pixels": [
    "....",
    ".##.",
    ".##.",
    "...."
  ],
  "texture": "isekaiexpansion:textures/parts/connector.png"
}

字段

字段类型默认值含义
typeidentifierrequired固定为 isekaiexpansion:metalworking。
inputingredientrequired标准物品、标签或候选数组;解析为空的标签不会匹配。
input.itemidentifieritem/tag已注册材料物品。
input.tagidentifieritem/tag不带 # 的材料标签。
countintegerrequired; 1–64消耗的材料数量;内置锻炉一次最多装入 8。
resultobjectrequired一块坯料加工后获得的成品物品堆。
result.itemidentifierrequired已注册产物。
result.countinteger1每块坯料产出的部件数量。填写正整数,最高为产物的堆叠上限。
result.set_nbtstring or objectabsent可选 SNBT/JSON 复合标签;无效 SNBT 拒绝。
textureidentifierrequired部件原图,路径包含 textures/ 与 .png。磨砺完成后按产物颜色显示。纹理缺失时服务端仍可加载配方。
pixelsarray<string>必填,1–32 行与列等宽矩形行。# 为部件像素,. 为余料。至少包含一个 #。
materialidentifier必填共用材料 ID。

铁的材料文件

{
  "base_color": "c0c0c0",
  "temperatures": {
    "faint_red": 569,
    "red": 861,
    "wheat": 1184,
    "gold": 1446,
    "melting": 1538
  },
  "heat_treatment": {
    "quench_min": 800,
    "quench_max": 880,
    "temper_min": 190,
    "temper_max": 240
  },
  "heating_per_second": 111.92,
  "cooling_per_second": 3.23,
  "toughness": 1.05,
  "palette": [
    "983f41",
    "fa4930",
    "ffda9c",
    "ffb526"
  ],
  "mask": "isekaiexpansion:textures/artisan/metal_heat.png"
}
字段类型默认值含义
base_colorstringffffff未加热坯料与部件预览使用的六位 RGB 色值。
temperaturesobject必填递增的温度,单位为 °C。
temperatures.faint_redinteger必填大于 60,为锻打色阶的微红起点。
temperatures.redinteger必填通红温度,即最低锻打温度。
temperatures.wheatinteger必填麦色最佳锻温,也是火晶的目标。
temperatures.goldinteger必填接近熔点的金黄色。
temperatures.meltinginteger必填最高 10000。在熔点停留会产生缺陷。
heat_treatmentobject or null必填用对象分别指定淬火和回火温区(°C)。无需淬硬、冷却后直接磨砺的材料填 null。
heat_treatment.quench_mininteger对象内必填有效淬火的最低入水温度,须高于回火温区。
heat_treatment.quench_maxinteger对象内必填有效淬火的最高入水温度,须高于下限、低于熔点。
heat_treatment.temper_mininteger对象内必填回火保温下限,须高于 60 °C。
heat_treatment.temper_maxinteger对象内必填回火保温上限,须高于下限,同时低于通红温度和淬火温区。
heating_per_secondnumber必填基础炉速为 1–3000 °C/秒。锻炉会控制淬火和回火的目标温度,越过麦色后也会放缓升温。
cooling_per_secondnumber必填每秒降温 0.1–100 °C,小于升温速率。
toughnessnumber必填0.5–3。越坚韧,锤击半径越小。
maskidentifierisekaiexpansion:textures/artisan/metal_heat.png磨砺完成前整块坯料共用的不透明灰阶表面。冷态取 base_color 着色,升温和冷却时均沿用相同蒙版与 UV。
palettearray<string>983f41, fa4930, ffda9c, ffb526从微红至金黄依序填写四个六位 RGB 色值。

校验

材料文件无效会导致重载失败。缺少材料文件时,锻炉里无法选择对应部件。轮廓无效会拒绝该配方,空标签无法匹配装料。锻炉限装 8 个材料,格式最多允许 64 个。淬火与回火温区均包含上下限。缺少热处理字段或温区无效会拒绝本次材料重载。

重载

服务端同步轮廓和材料表。客户端更换资源包只改变外观。存档中的切口会与当前余料取交集,以保留当前轮廓的全部受保护像素。

整合包的 245 个非金属部件配方使用常规有序格式和 isekaiexpansion:part_crafting。皮革部件要求对应品级的鞣革。各占用材料槽的工艺品质取平均值,未记录品质的材料按 0.8 计算。

相关页面

锻造介绍实体加工;组装配方组合成品部件;锻造运行时介绍 API。