Kzeroko KTM2

Metalworking recipe data

Material charges, pixel silhouettes and heat windows for physical part forging.

Updated Nov 13, 2026 4 min read

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

FieldTypeDefaultMeaning
typeidentifierrequiredExactly isekaiexpansion:metalworking.
inputingredientrequiredStandard item, tag or alternatives. Empty resolved tags are inert.
input.itemidentifieritem/tagRegistered material item.
input.tagidentifieritem/tagMaterial tag without #.
countintegerrequired; 1–64Consumed material charge; the bundled forge loads at most 8 at once.
resultobjectrequiredFinished stack from one billet.
result.itemidentifierrequiredRegistered output item.
result.countinteger1Number of parts from one billet. Use a positive count within the output item’s stack limit.
result.set_nbtstring or objectabsentOptional SNBT/JSON compound; malformed SNBT rejects.
textureidentifierrequiredPart artwork, including textures/ and .png. Honing reveals it with the output item’s tint. A missing texture does not reject server data.
pixelsarray<string>required, 1–32 rows and columnsEqual-width rows of # (protected) and . (removable). At least one # is required.
materialidentifierrequiredShared 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"
}
FieldTypeDefaultMeaning
base_colorstringffffffSix-digit RGB tint for the unheated billet and part preview.
temperaturesobjectrequiredIncreasing temperatures in °C.
temperatures.faint_redintegerrequiredAbove 60. First glow colour on the shaping scale.
temperatures.redintegerrequiredRed and minimum shaping temperature.
temperatures.wheatintegerrequiredBest shaping temperature and ember target.
temperatures.goldintegerrequiredNear-melting warning.
temperatures.meltingintegerrequiredAt most 10000. Holding here causes defects.
heat_treatmentobject or nullrequiredSpecify both treatment windows in °C, or set this to null for a material that cools and goes straight to honing.
heat_treatment.quench_minintegerrequired in objectLowest entry temperature for a clean quench, above the tempering window.
heat_treatment.quench_maxintegerrequired in objectHighest clean entry temperature, above the minimum and below melting.
heat_treatment.temper_minintegerrequired in objectLower hold temperature, above 60 °C.
heat_treatment.temper_maxintegerrequired in objectUpper hold temperature, above the minimum and below both red heat and the quench window.
heating_per_secondnumberrequiredBase heating rate, 1–3000 °C/s. The forge regulates the approach to quench and temper targets and slows the rise above wheat.
cooling_per_secondnumberrequired0.1–100 °C/s, below the heating rate.
toughnessnumberrequired0.5–3. Higher values reduce the hammer radius.
maskidentifierisekaiexpansion:textures/artisan/metal_heat.pngOpaque grayscale surface used until honing finishes. Cold metal uses base_color. Heating and cooling use the same mask and UVs.
palettearray<string>983f41, fa4930, ffda9c, ffb526Four 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.

Forgery explains physical work. Assembly recipes join finished parts; forgery runtime describes the API.