Metalworking recipe data
Material charges, pixel silhouettes and heat windows for physical part forging.
Each part recipe defines a silhouette cut from a full billet. A shared material profile governs its temperature and toughness.
Where the files live
Put recipes in data/<namespace>/recipes/<path>.json and material profiles in data/<namespace>/smithing_materials/<path>.json. The highest-priority file for an ID wins.
Minimal example
{
"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"
}
Fields
| Field | Type | Default | Meaning |
|---|---|---|---|
type | identifier | required | Exactly isekaiexpansion:metalworking. |
input | ingredient | required | Standard item, tag or alternatives. Empty resolved tags are inert. |
input.item | identifier | item/tag | Registered material item. |
input.tag | identifier | item/tag | Material tag without #. |
count | integer | required; 1–64 | Consumed material charge; the bundled forge loads at most 8 at once. |
result | object | required | Finished stack from one billet. |
result.item | identifier | required | Registered output item. |
result.count | integer | 1 | Number of parts from one billet. Use a positive count within the output item’s stack limit. |
result.set_nbt | string or object | absent | Optional SNBT/JSON compound; malformed SNBT rejects. |
texture | identifier | required | Part artwork, including textures/ and .png. Honing reveals it with the output item’s tint. A missing texture does not reject server data. |
pixels | array<string> | required, 1–32 rows and columns | Equal-width rows of # (protected) and . (removable). At least one # is required. |
material | identifier | required | Shared material ID. |
Iron material profile
{
"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"
}
| Field | Type | Default | Meaning |
|---|---|---|---|
base_color | string | ffffff | Six-digit RGB tint for the unheated billet and part preview. |
temperatures | object | required | Increasing temperatures in °C. |
temperatures.faint_red | integer | required | Above 60. First glow colour on the shaping scale. |
temperatures.red | integer | required | Red and minimum shaping temperature. |
temperatures.wheat | integer | required | Best shaping temperature and ember target. |
temperatures.gold | integer | required | Near-melting warning. |
temperatures.melting | integer | required | At most 10000. Holding here causes defects. |
heat_treatment | object or null | required | Specify both treatment windows in °C, or set this to null for a material that cools and goes straight to honing. |
heat_treatment.quench_min | integer | required in object | Lowest entry temperature for a clean quench, above the tempering window. |
heat_treatment.quench_max | integer | required in object | Highest clean entry temperature, above the minimum and below melting. |
heat_treatment.temper_min | integer | required in object | Lower hold temperature, above 60 °C. |
heat_treatment.temper_max | integer | required in object | Upper hold temperature, above the minimum and below both red heat and the quench window. |
heating_per_second | number | required | Base heating rate, 1–3000 °C/s. The forge regulates the approach to quench and temper targets and slows the rise above wheat. |
cooling_per_second | number | required | 0.1–100 °C/s, below the heating rate. |
toughness | number | required | 0.5–3. Higher values reduce the hammer radius. |
mask | identifier | isekaiexpansion:textures/artisan/metal_heat.png | Opaque grayscale surface used until honing finishes. Cold metal uses base_color. Heating and cooling use the same mask and UVs. |
palette | array<string> | 983f41, fa4930, ffda9c, ffb526 | Four six-digit RGB colours, ordered from faint red to gold. |
Validation
Malformed profiles reject the reload. Missing material profiles leave the affected parts unavailable in the forge. Invalid silhouettes reject the recipe. Empty ingredient tags cannot match a charge. A forge holds 8 inputs although the format accepts 64. All four treatment limits are inclusive. Omitting the treatment field or supplying invalid limits rejects the material reload.
Reloading
The server synchronizes the shape and material catalogue. Changing client textures affects appearance only. Saved cuts are intersected with the current removable stock, preserving the current protected silhouette.
The pack defines 245 nonmetal component patterns using the shaped format and isekaiexpansion:part_crafting. Each leather component requires its own grade of tanned leather. Occupied slots contribute their average workmanship, with unmarked materials contributing 0.8.
Related
Forgery explains physical work. Assembly recipes join finished parts; forgery runtime describes the API.