Json Things

This page covers information for 1.19.2+. For 1.18.2, see Json Things 1.18.

While we aim to make as much of our mods configurable and extendable through data packs and resource packs, there are some areas of the game that simply cannot be data driven at this time. Addons written in Java can of course access these features through code, but that is more difficult for modpacks and developers with less coding experience.

Json Things offers a good middle ground for developers wishing to add registry content such as items, blocks and fluids using an interface very similar to data packs and resource packs called “thing packs”, allowing very extensive mods to be written without writing any Java code. For a demonstration of its potential, see Tinkers’ JSON Things, an official addon to Tinkers’ Construct written purely using JSON files.

Json Things provides most of the components you need to create a Tinkers’ Construct addon, though a few components, notably the item classes required to register tools, required custom compatibility. This page documents that compatibility.

• Table of Contents
  1. Prerequisites
  2. Material Items
     1. Tool Part
     2. Repair Kit
  3. Tool Items
     1. Standard Tool
     2. Bow
     3. Crossbow
     4. Armor
  4. Other Items
     1. Tool Part Cast
  5. Fluid Blocks
     1. Burning Liquid
     2. Mob Effect Liquid

Prerequisites

Tinkers’ Construct items and blocks added through Json Things follow the same base format as the items added in Json Things. Make sure to read the basics of items and blocks on the Json Things documentation:

• Json Things Item Definitions
• Json Things Block Definitions

Material Items

Folder: things/<domain>/item/.

Material items are items that have a variant based on materials. While the NBT for these items is handled primarily through recipes and the textures through models, these item classes ensure the proper tooltips are shown and that creative tabs and JEI show all variants.

Tool Part

Tool parts are essential for creating new tools; the majority of tool recipes require certain interfaces to be present on any items used.

The format of the tool part item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:tool_part.
  • stat_type (Stat Type ID): Supported stat type. This will determine available material variants, along with how the part contributes stats and traits to the tool.
  • Any other fields supported in item definitions.

Repair Kit

Repair kits allow repairing a tool both in the Tinkers’ Station or Anvil, and in a standard crafting table. Most addons will not need to add custom repair kits, but they serve as a nice example “tool part” and may be useful to a modpack wishing for more granular on the go repair.

The format of the repair kit item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:repair_kit.
  • repair_amount (Number): Amount this repair kit will repair. 1.0 makes it equivelent to a single “common unit” of the material, for instance an ingot or a wood plank. Note that this does not determine the cost of the repair kit, that is controlled through recipes.
  • Any other fields supported in item definitions.

Tool Items

Folder: things/<domain>/item/.

While the majority of tool behavior is defined as part of tool definitions in data packs, the internal tool logic must still be registered as an item of the appropriate type to ensure all modifiers can properly function. There is also a small amount of tool behavior tied to the item type, though that may change in future updates as more content is migrated to data packs.

Standard Tool

The majority of tools (melee weapons, harvest tools, shields, staffs) are added using this item type, with the differing behaviors caused by tool definitions, starting modifiers, and item tags.

The format of the tool item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:tool.
  • break_blocks_in_creative (Boolean): If true (default), this tool can break blocks in creative mode. Weapons that are primarily for combat (notably swords) will set this to false.
  • max_stack_size (Integer): Maximum stack size of the tool, default 64. This is a standard Json Things property which nearly all tools will want to set to 1; however some tools such as daggers have a higher stack size for modifier crafting incentives.
  • Any other fields supported in item definitions.

Bow

This item type represents a modifiable bow, with behavior similar to longbows. Bows support firing arrows on releasing right click. They only support left click interaction modifiers by default (instead of all interaction modifier hooks). They fully support melee attacks and block harvest if added to the proper tags.

The format of the bow item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:bow.
  • max_stack_size (Integer): Maximum stack size of the tool, default 64. This is a standard Json Things property which nearly all tools will want to set to 1; however some tools such as daggers have a higher stack size for modifier crafting incentives.
  • Any other fields supported in item definitions.

Crossbow

This item type represents a modifiable crossbow. Crossbows support firing arrows and fireworks by charging to load then firing on a second click. They only support left click interaction modifiers by default (instead of all interaction modifier hooks). They fully support melee attacks and block harvest if added to the proper tags.

The format of the crossbow item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:crossbow.
  • allow_fireworks (Boolean): If true, this crossbow may use fireworks as ammo. If false, it is limited to only standard arrows.
  • max_stack_size (Integer): Maximum stack size of the tool, default 64. This is a standard Json Things property which nearly all tools will want to set to 1; however some tools such as daggers have a higher stack size for modifier crafting incentives.
  • Any other fields supported in item definitions.

Armor

Armor behaves notably different from tools. They notably do not fire many modifier hooks when holding the item, instead firing their hooks when the armor is worn in the correct slot. The majority of the armor’s behavior including stats is defined through the tool definition in data packs.

There are two different armor item types, tconstruct:basic_armor uses two textures for the armor, assets/<domain>/textures/models/armor/<name>_layer_2 for leggings and assets/<domain>/textures/models/armor/<name>_layer_1 for all other pieces. tconstruct:multilayer_armor supports Tinkers’ Construct’s armor model system to allow making layers vary with material textures or be conditioned on the presence of a modifier; see Armor Models.

• (Object): The root object.
  • type (Resource Location): Item type ID, may be tconstruct:basic_armor or tconstruct:multilayer_armor.
  • name (Resource Location): Name of this armor set, typically the item name without the slot (e.g. tconstruct:plate for tconstruct:plate_helmet). Used to determine armor textures or Armor Models.
  • equip_sound (Sound Event ID): Sound to play when equipping the armor. If unset, defaults to minecraft:item.armor.equip_generic.
  • slot (String): Slot where this armor piece is worn. May be helmet, chestplate, leggings, or boots.
  • Any other fields supported in item definitions except max_stack_size, which is always 1.

Other Items

Folder: things/<domain>/item/.

These item types do not fit into any of the above categories.

Tool Part Cast

Any item is valid as a cast, and casts like ingot or nugget casts can just use the standard plain type provided by Json Things. The tool part cast item type simply adds an additional tooltip to the cast showing the material cost for the cast, which is fetched from the relevant recipe in the data pack.

The format of the tool part cast item type is as follows:

• (Object): The root object.
  • type (Resource Location): Item type ID, must be tconstruct:part_cast.
  • part (Item ID): ID of the part item associated with this cast. Will be used to find the cost from the relevant recipe.
  • Any other fields supported in item definitions.

Fluid Blocks

Folder: things/<domain>/fluid/.

Tinkers’ Construct defines two fluid block definitions for implementing fluid blocks with interactions similar to those provided by Tinkers’ Construct. While you can define these blocks directly in a block definition, its typically easier to define it as part of the fluid JSON definition instead, which is what is described here.

Burning Liquid

Fluid block for a hot liquid that damages submerged entities and lights them on fire. The format of the burning liquid block type within a fluid definition:

• (Object): The root object.
  • block (Object): The root block object, defining this makes the fluid have a block form.
    • type (Resource Location): Block type ID, must be tconstruct:burning_liquid.
    • burn_time (Integer): Time in seconds that an entity will burn after leaving this liquid block.
    • damage (Number): Fire damage in half hearts that an entity will take per second while submerged in this fluid.
    • Any other fields supported in block definitions.
  • Any other fields supported in fluid definitions.

Mob Effect Liquid

Fluid block for a liquid that applies a mob effect to any submerged entities. The format of the mob effect liquid block type within a fluid definition:

• (Object): The root object.
  • block (Object): The root block object, defining this makes the fluid have a block form.
    • type (Resource Location): Block type ID, must be tconstruct:mob_effect_liquid.
    • effect (Mob Effect ID): Mob effect ID of the effect to apply while submerged.
    • effect_level (Integer): Level of the effect to apply, starting from 1.
    • burn_time (Integer): Time in seconds that the effect will last. Mostly affects the time the effect lasts after leaving the fluid, but some effects such as regeneration apply their effect at specific times so you may experience no effect while submerged based on the time provided.
    • damage (Number): Fire damage in half hearts that an entity will take per second while submerged in this fluid.
    • Any other fields supported in block definitions.
  • Any other fields supported in fluid definitions.