Material JSON

All JSONs that pertain to the same material must have the same file name and resource ID.

Data

Stats

Location: /data/<resource_id>/materials/stats/

Keys

stats: An object that gives part types a stat block. If a stat block for a part type is not defined, the material cannot be used with parts that use that stat.

Example

{
  "stats": {
    "tconstruct:extra": {},
    "tconstruct:handle": {
      "durability": 1.1,
      "miningSpeed": 1.1,
      "attackSpeed": 1.1,
      "attackDamage": 1.0
    },
    "tconstruct:head": {
      "durability": 800,
      "miningSpeed": 8.0,
      "harvestLevel": 3,
      "attack": 2.5
    }
  }
}

Traits

Location: /data/<resource_id>/materials/traits/

Keys

default: List of Modifier Entries. The default trait.
perStat: An object that gives part types a list of Modifier Entries to use.

Example

{
  "default": [
    {
      "name": "bone_hurting_mod:bone_hurting_trait",
      "level": 1
    }
  ],
  "perStat": {
    "bone_hurting_mod:bone": [
      {
        "name": "bone_hurting_mod:juicy_trait",
        "level": 1
      }
    ]
  }
}

Assets

Location: /assets/<resource_id>/models/tool_materials/

Keys

texture: Resource Location. A suffix for an untinted texture for the material. WARNING: This texture will still be loaded from the same namespace as the rest of the material.
--Result: tconstruct:cobalt -> head_tconstruct_cobalt.png.
fallbacks: List of strings. Default suffixes the mod tries to load before it gives up and loads the default texture. Used in order from left to right.
--Known defaults: wood, rock, metal (heads); stick, bone (handles).
color: Color. The color to paint the material with.

Example

{
  "fallbacks": ["metal"],
  "color": "2376dd"
}