CurseForge · Minecraft mod
Tinkers' Schema
Data-driven registration of custom tools for Tinkers' Construct 2 using JSON, with no Java required.
Quick answer
Which Tinkers' Schema release matches 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.
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.
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.
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.
- 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.
- 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.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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.12.2
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Tinkers' Schema versions and loaders
0.3.0
tinkersschema-0.3.0.jar
20 Nov 2026
0.2.5
tinkersschema-0.2.5.jar
6 Nov 2026
0.2.4
tinkersschema-0.2.4.jar
26 Oct 2026
0.2.3
tinkersschema-0.2.3.jar
23 Oct 2026
0.2.2
tinkersschema-0.2.2.jar
12 Oct 2026
0.2.1
tinkersschema-0.2.1.jar
11 Oct 2026
0.2.0
tinkersschema-0.2.0.jar
18 Sept 2026
0.1.0
tinkersschema-0.1.0.jar
16 Sept 2026
0.0.2
tinkersschema-0.0.2.jar
15 Sept 2026
0.0.1
tinkersschema-0.0.1.jar
14 Sept 2026
Looking for an older file? The official CurseForge project page is in Resources.