Tinkers' Schema

Data-driven tool registration for Tinkers' Construct 2.

Tinkers' Schema is an addon for Tinkers' Construct 2 that lets you add custom melee weapons, harvest tools, and ranged weapons using only JSON. No Java code, no compilation, no resource pack restructuring — drop a config file, supply your models and textures, and the tool becomes a fully functional Tinkers' item.

For custom models and textures, Resource Loader is recommended.

A ready-to-use example pack is available here: Tinkers' Schema - Example Tools.

Tinkers' Schema by itself adds nothing to the game. It only provides the framework — you need the example pack or your own JSON and resource files for any tool to appear.

Features

• JSON-driven registration — Each tool is defined by a single file in config/tinkersschema/tools/.
• First-class Tinkers' items — Tools are craftable in the Tool Station and Tool Forge, repairable, modifiable, and compatible with existing Tinkers' materials.
• Configurable parts — Combine any Tinkers' tool parts using head, handle, extra, bowlimb, bowstring, or any registered stat ID. Multiple parts of the same type are supported.
• Configurable stats — Damage, attack speed, knockback, durability, mining speed, damage cutoff, and bow handling are all adjustable with sensible defaults.
• Intrinsic traits — Attach any registered trait (e.g., splintering, beheading) to a tool, with optional display colors.
• AOE range — Harvest tools can define their own area-of-effect dimensions.
• Custom GUI layout — Nine-grid slot presets (topleft, center, bottomright) or precise pixel coordinates ("12,62"), freely mixed.
• Station routing — Craft in the Tool Station, or restrict to the Tool Forge.
• Guidebook entries — Add custom pages to the Tinkers' Construct book ("Materials and You") via JSON.
• Zero side effects — No config files means no changes to your game.

Current Scope

Tool Type	Base Class	Use Case
sword	SwordCore	Melee weapons
harvest	AoeToolCore	Harvest tools with AOE mining
bow	BowCore	Ranged weapons using arrows

Requirements

• Minecraft 1.12.2
• Forge
• Tinkers' Construct 2
• Mantle
• Resource Loader (recommended for loading custom models and textures)

Quick Start

1. Install Tinkers' Schema and its dependencies.

2. Create a tool definition in config/tinkersschema/tools/:

{
  "id": "tinkersschema:war_club",
  "tooltype": "sword",
  "station": "table",
  "categories": ["WEAPON"],
  "traits": ["splintering"],
  "traitColors": { "splintering": "yellow" },
  "repairParts": [1, 2],
  "repairModifiers": { "1": 1.5, "2": 1.5 },
  "parts": [
    { "type": "handle", "item": "tconstruct:tool_rod" },
    { "type": "head",   "item": "tconstruct:bow_limb" },
    { "type": "head",   "item": "tconstruct:bow_limb" }
  ],
  "guiSlots": ["center", "topright", "bottomleft"],
  "stats": {
    "damagePotential": 0.9,
    "attackSpeed": 1.6,
    "knockback": 1.1,
    "bonusAttack": 0.5,
    "attackMultiplier": 1.1,
    "durabilityMultiplier": 1.2,
    "damageCutoff": 15.0,
    "repairModifier": 1.0
  }
}

3. Provide the model and textures via Resource Loader or a resource pack:

resources/tinkersschema/
├── models/item/tools/war_club.tcon.json
├── textures/items/tools/war_club/
│   ├── handle.png
│   ├── limb1.png
│   ├── limb2.png
│   └── limb1_broken.png
└── lang/
    ├── en_us.lang
    └── zh_cn.lang

4. Launch the game. Your tool appears in the Tool Station and the Tinkers' Construct creative tab.

Configuration Reference

Required Fields

Field	Description
id	Registry name in namespace:path form
tooltype	sword, harvest, or bow
parts	Ordered list of tool parts

Optional Fields

Field	Default	Description
station	"table"	table (Tool Station + Tool Forge) or forge (Tool Forge only)
categories	[]	WEAPON, HARVEST
traits	[]	Intrinsic trait IDs
traitColors	{}	Display color per trait (e.g., {"splintering": "yellow"})
harvestToolClass	null	pickaxe, shovel, axe
effectiveMaterials	[]	Block materials for AOE tools (ROCK, WOOD, etc.)
aoeRange	[1,1,1]	AOE dimensions for harvest tools
repairParts	[1]	Part indices used for repair
repairModifiers	{}	Repair multiplier per part index
guiSlots	preset	Slot positions (topleft, center, "12,62", etc.)

Stats

All values default to Tinkers' Construct baselines:

Stat	Default	Applies To
damagePotential	1.0	All
attackSpeed	1.6	All
knockback	1.0	All
bonusAttack	0.0	All
attackMultiplier	1.0	All
durabilityMultiplier	1.0	All
miningSpeedModifier	1.0	All
damageCutoff	15.0	All
repairModifier	1.0	All

Bow Stats

Additional fields for bow tools:

Field	Default	Description
drawSpeedMultiplier	1.0	Multiplier on the material-derived draw speed
rangeMultiplier	1.0	Multiplier on the material-derived range
bonusDamageMultiplier	1.0	Multiplier on the material-derived bonus damage
baseProjectileDamage	0.0	Inherent damage, scaled by draw progress
projectileDamageModifier	1.0	Final damage modifier
baseInaccuracy	0.0	Shot spread. Higher is less accurate
projectileSpeedMultiplier	1.0	Projectile velocity multiplier
drawMoveSpeed	null	Movement speed retained while drawing. Omit for vanilla slowdown

Assets

Models and textures follow the standard resource pack layout. Place them in .minecraft/resources/tinkersschema/ (with Resource Loader) or package them as a resource pack.

• Models: models/item/tools/<tool_name>.tcon.json — layered tool model
• Textures: textures/items/tools/<tool_name>/<layer>.png — grayscale, 16×16
• Language: lang/<locale>.lang — keys item.<modid>.<name>.name and .desc
• Guidebook: book/index.json, book/sections/*.json, book/<locale>/... — Tinkers' Construct book pages

Grayscale textures are tinted by the material color at render time, following the same convention used by Tinkers' Construct's own tools.

Future Plans

• CraftTweaker/ZenScript integration
• Crossbows and ammunition (arrows, bolts, throwables)
• JSON-defined custom tool parts
• Stable API and full documentation

Known Limitations

• Tool behavior (sweep attack, AOE logic, bow draw mechanics) is inherited from Tinkers' base classes and cannot be reconfigured through JSON.
• Model paths are bound to Tinkers' loading convention: models/item/tools/<name>.tcon.json.
• effectiveMaterials currently supports vanilla block materials only.
• Config changes require a game restart (CraftTweaker 1.12.2 does not support /reload).

License

MIT. Built on ForgeDevEnv (MIT, CleanroomMC).

Credits

• SlimeKnights — Tinkers' Construct 2
• Lumien231 — Resource Loader
• CleanroomMC — ForgeDevEnv

---

AI-assisted development.