Item Stack Provider Bindings

Item stack providers are an item stack with attached data, known as item stack modifiers. There are several methods for creating them

These are available from the TFC.itemStackProvider and TFC.isp fields

Method Signatures 

TFC.itemStackProvider.of(itemStack: ItemStack, modifiers?: (string | JsonArray | JsonObject | List<(string | JsonObject)>))
TFC.isp.empty(modifiers?: (string | JsonArray | JsonObject | List<(string | JsonObject)>))
TFC.itemStackProvider.copyInput(modifiers?: (string | JsonArray | JsonObject | List<(string | JsonObject)>))
  • Of: Returns an item stack provider with the given item and modifiers
    • 1st argument: An item stack, the item stack of the ISP
    • Optional 2nd argument: A string, json array, json object, of list of strings and/or json objects, the modifiers to add. If not provided, no modifiers will be applied to the isp
  • Empty: Returns an item stack modifier with an empty item stack and the provided modifiers
    • Optional 1st argument: A string, json array, json object, of list of strings and/or json objects, the modifiers to add. If not provided, no modifiers will be applied to the isp
  • CopyInput: Returns an empty isp with the tfc:copy_input modifier and the provided modifiers
    • Optional 1st argument: A string, json array, json object, of list of strings and/or json objects, the modifiers to add. If not provided, only the copy input modifier will be applied to the isp

These methods return an ItemStackProviderJS object which has several helper methods and is described below

Examples 

TFC.itemStackProvider.of('3x minecraft:dirt', ['tfc:add_glass', {type: 'tfc:add_trait', trait: 'kubejs:my_cool_trait'}])
TFC.isp.of('5x minecraft:stone')
TFC.itemStackProvider.empty('tfc:add_powder')
TFC.isp.copyInput()
TFC.itemStackProvider.copyInput('tfc:copy_heat')

In json:

{
    "stack": {
        "item": "minecraft:dirt",
        "count": 3
    },
    "modifiers": [
        {
            "type": "tfc:add_glass"
        },
        {
            "type": "tfc:add_trait",
            "trait": "kubejs:my_cool_trait"
        }
    ]
}

{
    "item": "minecraft:stone",
    "count": 5
}

{
    "modifiers": [
        {
            "type": "tfc:add_powder"
        }
    ]
}

{
    "modifiers": [
        {
            "type": "tfc:copy_input"
        }
    ]
}

{
    "modifiers": [
        {
            "type": "tfc:copy_input"
        },
        {
            "type": "tfc:copy_heat"
        }
    ]
}

ItemStackProviderJS

An ItemStackProviderJS is an object which is meant to mirror an actual ItemStackProvider but be friendly to modify from js and can be serialized into json.

Method Signatures 

declare class ItemStackProviderJS {
    stack(): ItemStack
    modifiers(): JsonArray
    isEmpty(): boolean
    isSimple(): boolean
    withCount(i: number): ItemStackProviderJS
    getCount(): number
    getJsonStack(): JsonObject
    getModifiersOfType(type: string): List<JsonObject>
    toJson(): JsonObject
    asCanonClass(): ItemStackProvider
    dependsOnInput(): boolean
    copy(): ItemStackProviderJS
    getTag(): @Nullable CompoundTag
    setTag(tag: CompoundTag): ItemStackProviderJS
    mergeTag(tag: CompoundTag): ItemStackProviderJS
    simpleModifier(type: string): ItemStackProviderJS
    jsonModifier(modifier: JsonObject): ItemStackProviderJS
    dyeLeather(color: DyeColor): ItemStackProviderJS
    addHeat(temperature: number): ItemStackProviderJS
    addPowder(): ItemStackProviderJS
    addTrait(trait: string): ItemStackProviderJS
    removeTrait(trait: string): ItemStackProviderJS
    addGlass(): ItemStackProviderJS
    copyFood(): ItemStackProviderJS
    copyForgingBonus(): ItemStackProviderJS
    copyHeat(): ItemStackProviderJS
    copyInput(): ItemStackProviderJS
    emptyBowl(): ItemStackProviderJS
    resetFood(): ItemStackProviderJS
    copyOldestFood(): ItemStackProviderJS
    addBait(): ItemStackProviderJS
    meal(food: Consumer<BuildFoodItemData>, portions?: Consumer<BuildPortionData>[]): ItemStackProviderJS
    // The following are available if FirmaLife is installed
    firmaLifeAddPiePan(): ItemStackProviderJS
    firmaLifeCopyDynamicFood(): ItemStackProviderJS
    firmaLifeEmptyPan(): ItemStackProviderJS
}
  • .stack(): Returns the ItemStack of the ISP
  • .modifiers(): Returns a json array of all of the applied modifiers
  • .isEmpty(): Returns true if the stack and modifier list is empty
  • .withCount(i: number): Sets the stacks count to the provided value
  • .getCount(): Returns the stack’s count
  • .getJsonStack(): Returns a json object representing the item stack
  • .getModifiersOfType(type: string): Returns a list of json objects which represent the applied modifiers with the given type
  • .toJson(): Returns the json representation of the ISP
  • .asCanonClass(): Returns the ISP as an ItemStackProvider object, TFC’s canonical class for this data
  • .dependsOnInput(): Returns true if any of the applied modifiers is dependent on the recipe’s input
  • .copy(): Returns a copy of the ISP
  • .getTag(): Returns the item stack’s CompoundTag, may be null
  • .setTag(tag: CompoundTag): Sets the item stack’s CompoundTag
  • .mergeTag(tag: CompoundTag): Merges the provided CompoundTag into the item stack’s
  • .simpleModifier(type: string): Adds a modifier of the provided type
  • .jsonModifier(modifier: JsonObject): Adds the provided json modifier
  • .dyeLeather(color: DyeColor): Adds a tfc:dye_leather modifier with the provided color
  • .addHeat(temperature: number): Adds a tfc:add_heat with the provided temperature, allows negative values
  • .addPowder(): Adds a tfc:add_powder modifier
  • .addTrait(trait: string): Adds a tfc:add_trait modifier with the provided trait value
  • .removeTrait(trait: string): Adds a tfc:remove_trait modifier with the provided trait value
  • .addGlass(): Adds a tfc:add_glass modifier
  • .copyFood(): Adds a tfc:copy_food modifier
  • .copyForgingBonus(): Adds a tfc:copy_forging_bonus modifier
  • .copyHeat(): Adds a tfc:copy_heat modifier
  • .copyInput(): Adds a tfc:copy_input modifier
  • .emptyBowl(): Adds a tfc:empty_bowl modifier
  • .resetFood(): Adds a tfc:reset_food modifier
  • .copyOldestFood(): Adds a tfc:copy_oldest_food modifier
  • .addBait(): Adds a tfc:add_bait_to_rod modifier
  • .meal(food: Consumer<BuildFoodItemData>, portions?: Consumer<BuildPortionData>[]): Adds a tfc:meal modifier
    • 1st argument: A consumer with the same methods as the 2nd argument of a food definition
    • Optional 2nd argument: An array of consumers specifying the portions of a meal
      • .ingredient(ingredient: Ingredient): Sets the portion’s ingredient
      • .nutrientModifier(modifier: number): Multiplies the nutrition from the ingredient, defaults to 1
      • .waterModifier(modifier: number): Multiplies the water from the ingredient, defaults to 1
      • .saturationModifier(modifier: number): Multiplies the saturation from the ingredient, defaults to 1

If FirmaLife is installed the following methods are available:

  • .firmaLifeAddPiePan(): Adds a firmalife:add_pie_pan modifier
  • .firmaLifeCopyDynamicFood(): Adds a firmalife:copy_dynamic_food modifier
  • .firmaLifeEmptyPan(): Adds a firmalife:empty_pan modifier

Examples 

TFC.itemStackProvider.copyInput().copyHeat().copyOldestFood()
TFC.itemStackProvider.of('5x minecraft:glass').addHeat(500)

In json:

{
    "modifiers": [
        {
            "type": "tfc:copy_input"
        },
        {
            "type": "tfc:copy_heat"
        },
        {
            "type": "tfc:copy_oldest_food"
        }
    ]
}

{
    "stack": {
        "item": "minecraft:glass",
        "count": 5
    },
    "modifiers": [
        {
            "type": "tfc:add_heat",
            "temperature": 500
        }
    ]
}