Back to mods
Tinkers' Schema project artwork

CurseForge · Minecraft mod

Tinkers' Schema

Data-driven registration of custom tools for Tinkers' Construct 2 using JSON, with no Java required.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Tinkers' Schema release matches Forge?

Updated today
beta file 0.3.0
Game version 1.12.2
Loader Forge

Tinkers' Schema 0.3.0 targets 1.12.2 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 5 required mods have matching files.

Where it goes

Is Tinkers' Schema required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Tinkers' Schema 0.3.0 need?

0.3.0 on Forge. Every mod below is checked against that same setup.

All 5 required mods have matching files

Install Tinkers Construct, Mantle, Mantle, Tinkers' Construct and 1 more first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.

5 listed on this file 1 pulled in by one of those mods
Resource Loader Optional for Tinkers' Schema 0.3.0
optional
No matching file
Tinkers Construct Needed by Tinkers' Schema 0.3.0
required
Matching file found Matched file: TConstruct-1.12.2-2.13.0.183.jar
Mantle Needed by Tinkers' Schema 0.3.0
required
Matching file found Matched file: Mantle-1.12-1.3.3.55.jar
Mantle Needed by Tinkers' Schema 0.3.0
required
Matching file found Matched file: 1.3.3.55
Tinkers' Construct Needed by Tinkers' Schema 0.3.0
required
Matching file found Matched file: 2.13.0.183
Mantle Needed by Tinkers' Construct
pulled in
Matching file found Matched file: 1.3.3.55

1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Tinkers' Schema without breaking your instance.

Built for Tinkers' Schema 0.3.0 on Forge. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 0.3.0. It targets 1.12.2 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Tinkers Construct, Mantle, Mantle, Tinkers' Construct and 1 more first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 0.3.0. It opens that exact file at the source.

About this project

What does Tinkers' Schema add?

Tinkers' Schema

A data-driven registration framework for Tinkers' Construct 2. Add custom melee weapons, mining tools, bows, throwing weapons and ammo with a JSON file — no Java, no compiling.

Tinkers' Schema adds no items on its own. It only registers what your config files describe, so you need the example pack below or your own JSON and assets before anything appears in game. For loading custom models and textures, Resource Loader is recommended.

Ready-to-use example pack: **Tinkers' Schema - Example Tools**​

Requirements

  • Minecraft 1.12.2 + Forge
  • Tinkers' Construct 2
  • Mantle
  • Resource Loader — recommended, lets you drop assets into .minecraft/resources/

Tool Types

tooltype Built on What you get
sword SwordCore Melee weapon, sweep attack
harvest AoeToolCore Mining tool with configurable area
bow BowCore Draw-and-shoot launcher
thrown ProjectileCore Throwing weapon, durability is the ammo
ammo ProjectileCore Standalone ammo, cannot be thrown by hand

Every type is a real Tinkers' item: craftable in the Tool Station or Tool Forge, repairable, modifiable, and color-tinted per material.

Quick Start

1. Drop a config file into config/tinkersschema/tools/.

A minimal melee weapon:

{
  "id": "mymod:war_club",
  "tooltype": "sword",
  "parts": [
    { "type": "handle", "item": "tconstruct:tool_rod" },
    { "type": "head",   "item": "tconstruct:sword_blade" }
  ],
  "repairParts": [1],
  "traits": ["splintering"],
  "guiSlots": ["center", "topright"]
}

A minimal mining tool. effectiveMaterials is mandatory for harvest — without it the tool cannot mine anything:

{
  "id": "mymod:pickaxe",
  "tooltype": "harvest",
  "effectiveMaterials": ["ROCK", "WOOD", "GROUND"],
  "harvestToolClass": "pickaxe",
  "aoeRange": [1, 1, 1],
  "parts": [
    { "type": "handle", "item": "tconstruct:tool_rod" },
    { "type": "head",   "item": "tconstruct:pickaxe_head" }
  ],
  "repairParts": [1],
  "guiSlots": ["center", "topright"]
}

2. Add a model, textures and a name.

.minecraft/
├── config/tinkersschema/tools/
│   └── pickaxe.json
└── resources/mymod/                          ← Resource Loader, or a resource pack
    ├── models/item/tools/pickaxe.tcon.json
    ├── models/item/tools/pickaxe.mod.json    ← optional, modifier overlays
    ├── textures/items/tools/pickaxe/
    │   ├── handle.png                        ← 16×16 grayscale
    │   └── head.png
    └── lang/en_us.lang

pickaxe.tcon.json — one layer per part, in parts order. brokenN is the texture shown at zero durability:

{
  "loader": "tconstruct:tool",
  "parent": "forge:item/default",
  "textures": {
    "layer0": "mymod:items/tools/pickaxe/handle",
    "layer1": "mymod:items/tools/pickaxe/head",
    "broken1": "mymod:items/tools/pickaxe/head_broken"
  }
}

lang/en_us.lang:

item.mymod.pickaxe.name=Pickaxe
item.mymod.pickaxe.desc=One block at a time.

3. Restart the game. The tool shows up in the Tool Station and the Tinkers' Construct creative tab. A tool missing its model still works, but renders as a missing-texture cube.

Modifier Overlays

Tinkers' Construct keys its overlay textures by tool name and only knows its own tools, so a custom tool name never matches. Give it a map beside the model:

models/item/tools/pickaxe.mod.json

{
  "textures": {
    "sharpness": "tconstruct:items/pickaxe/mod_sharpness",
    "diamond":   "tconstruct:items/pickaxe/mod_diamond"
  }
}

Keys are modifier IDs and must match exactly. Values are the overlay textures drawn on top of the tool, so reuse the overlay of the vanilla tool your model is based on to keep the UV layout aligned. Modifiers you leave out simply render without an overlay — no errors, no missing pieces. The file is read once, while the model bakes.

Reference

Common fields

Field Default Notes
id required namespace:path
tooltype required see table above
parts required ordered list of { "type", "item" }
station table table = Tool Station + Tool Forge, forge = Tool Forge only
categories type default TOOL, WEAPON, HARVEST, AOE, LAUNCHER, PROJECTILE, NO_MELEE
traits [] intrinsic trait IDs, e.g. splintering, beheading
traitColors {} per-trait display color, e.g. {"splintering": "yellow"}
guiSlots preset grid topleft … bottomright, or "12,62"; freely mixed
modifiers material total number of modifier slots
repairParts [1] indices of parts used for repair
repairModifiers {} repair multiplier per part index
stats Tinkers' baseline see below

Part type accepts head, handle, extra, bowlimb, bowstring, arrowhead, arrowshaft, fletching, any registered stat ID, or a comma-separated combination. The same type may appear more than once.

Stats

damagePotential 1.0 · attackSpeed 1.6 · knockback 1.0 · bonusAttack 0.0 · attackMultiplier 1.0 · durabilityMultiplier 1.0 · miningSpeedModifier 1.0 · damageCutoff 15.0 · repairModifier 1.0

Ranged fields

Field Applies to Default Notes
ammo bow vanilla arrows + this mod's ammo explicit ammo item IDs
crosshair bow SQUARE X, INVERSE, PLUS, T, SQUARE
projectile thrown, ammo shuriken shuriken, arrow, bolt
throwSpeed thrown 2.1 launch velocity
cooldown thrown 4 ticks between throws
durabilityPerAmmo thrown, ammo 10 durability spent per shot

Bow stats added on top of the common ones: drawSpeedMultiplier, rangeMultiplier, bonusDamageMultiplier, baseProjectileDamage, projectileDamageModifier, baseInaccuracy, projectileSpeedMultiplier, drawMoveSpeed — all multiplier defaults 1.0 (or 0.0 for additive damage), and omitting drawMoveSpeed keeps vanilla drawing slowdown.

Harvest fields

effectiveMaterials (required) — block materials the tool can mine: ROCK, WOOD, GROUND, SAND, IRON, LEAVES, PLANTS, SNOW, CLAY, GLASS and other vanilla block materials. harvestToolClass — pickaxe, axe, shovel, null. aoeRange — [width, height, depth], [1, 1, 1] is a single block.

Limitations

  • Tool behaviour (sweep, AOE logic, draw mechanics) comes from the Tinkers' base classes and is not configurable beyond the fields above.
  • Model path is fixed by the Tinkers' loader convention: models/item/tools/<name>.tcon.json.
  • Vanilla Tinkers' bows do not recognise ammo added by this mod; custom bows do, automatically.
  • Config changes need a game restart.

License & Credits

MIT. Built on ForgeDevEnv (MIT, CleanroomMC). Tinkers' Construct 2 — SlimeKnights · Resource Loader — Lumien231 · ForgeDevEnv — CleanroomMC

Project description from CurseForge.

Pick your setup

Tinkers' Schema by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Tinkers' Schema versions and loaders

10 of 10 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.