Common JSON Value Types

Table of Contents
Ingredient FluidIngredient EntityIngredient SizedIngredient ItemOutput FluidStack ModifierEntry ModifierMatch SlotCount ResourceLocation Fluid IFluidHandlerItem ToolCore IMaterialItem MaterialId Tick Color

Ingredient

Vanilla recipe input. Can be either an item stack or a tag.

FluidIngredient

A fluid recipe input. The input can be an array of both types and tags.

Keys

name: The fluid's full name.
tag: Forge tag. Used when the recipe can have multiple possible inputs.
amount: Integer. The fluid amount in millibuckets.

Examples

"fluid": {
  "name": "tconstruct:molten_gold",
  "amount": 144
}

"fluid": [
  {
    "name": "minecraft:water",
    "amount": 1000
  },
  {
    "tag": "forge:fluids/steam",
    "amount": 1000
  }
]

EntityIngredient

An entity. Used for entity melting. The input can be an array of both types and tags.

Keys

type: Full entity type.
tag: Forge entity tag.
types: An array of entity types.

Example

"entity": {
  "type": "minecraft:creeper"
}

"entity": [
  {
    "tag": "minecraft:skeletons"
  },
  {
    "type": "minecraft:skeleton_horse"
  }
]

"entity": {
  "types": [
    "minecraft:villager",
    "minecraft:wandering_trader"
  ]
}

SizedIngredient

Similar to Ingredient, but needs at least amount_needed of the ingredient to be present.

Keys

ingredient: Ingredient. Optional, if missing, the whole object is considered an ingredient. The item to be used.
amount_needed : Integer. Defaults to 1. The amount of ingredient needed for the recipe.

Examples

{
  "item": "tconstruct:reinforcement"
}

{
  "ingredient": {
    "item": "tconstruct:bone_hurting_nugget"
  },
  "amount_needed": 9
}

ItemOutput

Used for recipe outputs where the exact item output could be irrelevant, like ingot casting.

Keys

tag: Forge tag. Used when the recipe can have any possible tagged output.
count: Integer. Defaults to 1. The item count.
nbt: NBT for the item.

Example

"result": {
  "tag": "forge:ingots/invar"
}

FluidStack

Similar to FluidIngredient, but cannot take a tag (the fluid must be exact).

Example

"result": {
  "fluid": "tconstruct:molten_electrum",
  "amount": 288
}

ModifierEntry

Full name and level of a modifier to be added.

Keys

name: Full modifier name.
level: Integer. Defaults to 1. The level of the modifier to be added.

Example

{
  "name": "tconstruct:silky",
  "level": 1
}

ModifierMatch

A recursive list of ModifierMatch and ModifierEntry objects. The top object can be a ModifierEntry.

Keys

options: List of ModifierMatch and ModifierEntry objects.
matches_needed: Integer. The amount of matches from the list required.
error: String. The translation key of the error to shown if the ModifierMatch fails. Only available on the top level.

Examples

{
  "name": "tconstruct:expanded",
  "level": 1,
  "error": "recipe.tconstruct.modifier.ender_expander_requirements"
},
{
  "options": [
    {
      "name": "tconstruct:diamond",
      "level": 1
    },
    {
      "name": "tconstruct:emerald",
      "level": 1
    }
  ],
  "matches_needed": 1,
  "error": "recipe.tconstruct.modifier.netherite_requirements"
}

SlotCount

Contains information about the modifier slots in a recipe. The format for SlotCount is { "<type>": <slots> } where <type> is the type of modifier slots required, and <slots> is the number of that type needed. At most one type can be specified, if no type is specified the modifier is considered "slotless"

For more information on modifier slots, see Modifier Slot Types

Example

"slots": {"upgrades": 2}

Requires 2 modifier slots of type upgrades.

ResourceLocation

https://mcforge.readthedocs.io/en/latest/concepts/resources/

Fluid

Full identifier of a fluid.

Example

"fluid": "tconstruct:molten_cobalt"

IFluidHandlerItem

Full item name of a fluid container item. Must implement the IFluidHandlerItem capability.

Example

"container": "minecraft:bucket"

ToolCore

Full item name of a Tinkers tool. Must extend the ToolCore class.

Example

"result": "tconstruct:axe"

IMaterialItem

Full item name of a material based item, usually a tool part. Must extend the IMaterialItem interface.

Example

"result": "tconstruct:pickaxe_head"

MaterialId

Full name of a Tinkers material.

Example

"input": "tconstruct:bone"

Tick

1/20th of a second.

Color

A hex RRGGBB color.

Example

"color": "3ce186"