金属加工配方数据
实体部件锻造的材料数量、像素轮廓与温度区间。
部件配方描述从整块坯料中敲出的轮廓。金属的温区、升降温速度与韧性由材料文件统一定义。
文件放在哪里
部件配方位于 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"
}
字段
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
type | identifier | required | 固定为 isekaiexpansion:metalworking。 |
input | ingredient | required | 标准物品、标签或候选数组;解析为空的标签不会匹配。 |
input.item | identifier | item/tag | 已注册材料物品。 |
input.tag | identifier | item/tag | 不带 # 的材料标签。 |
count | integer | required; 1–64 | 消耗的材料数量;内置锻炉一次最多装入 8。 |
result | object | required | 一块坯料加工后获得的成品物品堆。 |
result.item | identifier | required | 已注册产物。 |
result.count | integer | 1 | 每块坯料产出的部件数量。填写正整数,最高为产物的堆叠上限。 |
result.set_nbt | string or object | absent | 可选 SNBT/JSON 复合标签;无效 SNBT 拒绝。 |
texture | identifier | required | 部件原图,路径包含 textures/ 与 .png。磨砺完成后按产物颜色显示。纹理缺失时服务端仍可加载配方。 |
pixels | array<string> | 必填,1–32 行与列 | 等宽矩形行。# 为部件像素,. 为余料。至少包含一个 #。 |
material | identifier | 必填 | 共用材料 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_color | string | ffffff | 未加热坯料与部件预览使用的六位 RGB 色值。 |
temperatures | object | 必填 | 递增的温度,单位为 °C。 |
temperatures.faint_red | integer | 必填 | 大于 60,为锻打色阶的微红起点。 |
temperatures.red | integer | 必填 | 通红温度,即最低锻打温度。 |
temperatures.wheat | integer | 必填 | 麦色最佳锻温,也是火晶的目标。 |
temperatures.gold | integer | 必填 | 接近熔点的金黄色。 |
temperatures.melting | integer | 必填 | 最高 10000。在熔点停留会产生缺陷。 |
heat_treatment | object or null | 必填 | 用对象分别指定淬火和回火温区(°C)。无需淬硬、冷却后直接磨砺的材料填 null。 |
heat_treatment.quench_min | integer | 对象内必填 | 有效淬火的最低入水温度,须高于回火温区。 |
heat_treatment.quench_max | integer | 对象内必填 | 有效淬火的最高入水温度,须高于下限、低于熔点。 |
heat_treatment.temper_min | integer | 对象内必填 | 回火保温下限,须高于 60 °C。 |
heat_treatment.temper_max | integer | 对象内必填 | 回火保温上限,须高于下限,同时低于通红温度和淬火温区。 |
heating_per_second | number | 必填 | 基础炉速为 1–3000 °C/秒。锻炉会控制淬火和回火的目标温度,越过麦色后也会放缓升温。 |
cooling_per_second | number | 必填 | 每秒降温 0.1–100 °C,小于升温速率。 |
toughness | number | 必填 | 0.5–3。越坚韧,锤击半径越小。 |
mask | identifier | isekaiexpansion:textures/artisan/metal_heat.png | 磨砺完成前整块坯料共用的不透明灰阶表面。冷态取 base_color 着色,升温和冷却时均沿用相同蒙版与 UV。 |
palette | array<string> | 983f41, fa4930, ffda9c, ffb526 | 从微红至金黄依序填写四个六位 RGB 色值。 |
校验
材料文件无效会导致重载失败。缺少材料文件时,锻炉里无法选择对应部件。轮廓无效会拒绝该配方,空标签无法匹配装料。锻炉限装 8 个材料,格式最多允许 64 个。淬火与回火温区均包含上下限。缺少热处理字段或温区无效会拒绝本次材料重载。
重载
服务端同步轮廓和材料表。客户端更换资源包只改变外观。存档中的切口会与当前余料取交集,以保留当前轮廓的全部受保护像素。
整合包的 245 个非金属部件配方使用常规有序格式和 isekaiexpansion:part_crafting。皮革部件要求对应品级的鞣革。各占用材料槽的工艺品质取平均值,未记录品质的材料按 0.8 计算。