IIngredient
Link to iingredient
An IIngredient is an ingredient for recipes.
This could be an item, an ore dictionary entry, a liquid and much more.
Importing the package
Link to importing-the-package
It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import.
import crafttweaker.item.IIngredient;
Importing the IIngredient package
Link to importing-the-iingredient-package
Usually, you won't need this, but in some cases recipes won't work until you import the IIngredient package.
You can do this using the following import:
ZenScript Copyimport crafttweaker.item.IIngredient;
Functions
Link to functions
So, what can we do with this?
Command String
Link to command-string
The command string is how you would call this item in ZS.
This can be a bracket handler or something similar.
ZenScript Copyval item = <minecraft:iron_ingot>;
//prints "<minecraft:iron_ingot>"
print(item.commandString);
Mark
Link to mark
You can mark an IIngredient so you can later use it in crafting functions. You can also retrieve the mark applied earlier.
ZenScript Copy//Marks the pick with the String Picky
//item.marked(name) <-- Name is a string!
val markedPick = <minecraft:diamond_pickaxe>.marked("Picky");
//prints "Picky"
print(markedPick.mark);
Amount
Link to amount
If you want to use more than one of a given item, you can set an amount to an IIngredient.
This is as easy as multiplying the IIngredient with an Integer.
Retrieveing the amount is also possible.
ZenScript Copyval multipleApples = <minecraft:apple> * 3;
//prints 3
print(multipleApples.amount);
OR-ing an IIngredient
Link to or-ing-an-iingredient
Sometimes you want either IIngredient X or Y, but don't want to create a recipe for each possibility? That's why there's the OR Method for IIngredients:
ZenScript Copyval item1 = <minecraft:apple>;
val item2 = <minecraft:carrot>;
val either = item1 | item2;
val either2 = item1.or(item2);
Get Possible Items or Liquids
Link to get-possible-items-or-liquids
Sometimes an IIngredient represents more than one item, for example if you are using an OreDictEntry or if you OR-ed two Ingredients.
You can get all possible items for this IIngredient as a List<IItemStack> List using the first function.
The second function does the same as the first function but returns a IItemStack[] instead of a list.
Same goes for liquids in the third function, only they return an ILiquidStack List.
ZenScript Copy//Returns an IItemStack List
//possible items: All iron ingots and the gold ingot from MC
val itemsIngredient = <ore:ingotIron> | <minecraft:gold_ingot>;
//Returns an ILiquidStack List|
//possible liquids: Lava and Water
val liquidsIngredient = <liquid:lava> | <liquid:water>;
for item in itemsIngredient.items{
//Prints each possible item's Display name
print(item.displayName);
}
for item in itemsIngredient.itemArray{
//Prints each possible item's Display name
print(item.displayName);
}
for liquid in liquidsIngredient.liquids{
//Prints each possible liquid's Display name
print(liquid.displayName);
}
for liquid in <minecraft:water_bucket>.liquids {
//Prints the contained liquid, i.e. water.
//May not work for every item, though.
print(liquid.displayName);
}
Transform an IIngredient upon crafting
Link to transform-an-iingredient-upon-crafting
Sometimes you want an item not to be consumed upon crafting but instead receive damaged or give back a completely different item.
This is what item Transformers are there for.
ZenScript Copy
val item = <minecraft:apple>;
//Item won't be consumed and will stay in the grid
transformedItem = item.reuse();
//Item won't be consumed and the whole stack will be given back to you (does /give).
transformedItem = item.giveBack();
//item will be consumed but will give the specified stack to you (the crafting slot will be cleared!).
transformedItem = item.giveBack(<minecraft:potato>);
//item will be replaced with the specified item, which will instead go to the crafting slot
transformedItem = item.transformReplace(<minecraft:potato>);
//damages the item by 1
transformedItem = item.transformDamage();
//damages the item by the given value
transformedItem = item.transformDamage(3);
//item will be consumed, no matter what.
transformedItem = item.noReturn();
//Causes multiple items to be consumed.
transformedItem = item.transformConsume(3);
Ingredient Conditions
Link to ingredient-conditions
Sometimes you want your ingredient to have a specific tag or to only work if (not) damaged. These Conditions can be added to your Ingredients using the following:
ZenScript Copyval item = <minecraft:apple>;
//Item will only be accepted with at least 1 point damage
var conditionedItem = item.onlyDamaged();
//Item will only be accepted with at least the specified damage points
conditionedItem = item.onlyDamageAtLeast(10);
//Item will only be accepted with at most the specified damage points
conditionedItem = item.onlyDamageAtMost(100);
//Item will only be accepted with damage points greater or equal as the first and lesser or equal as the 2nd Integer.
conditionedItem = item.onlyDamageBetween(10,100);
//Item will only be accepted with the specified Tag. The item may have more/other tags than specified, those are ignored when checked.
//If you want JEI to show the tag in the recipe screen, you'll need to add a tag using "withTag(tag)"
conditionedItem = item.onlyWithTag({display: {Name: "Tomato"}});
//Item will only be accepted with the specified Tag. The item may have more/other tags than specified, those are ignored when checked.
//Note: This may not work with all ingredients, but it will work for Items. Pro side to using this is that JEI will show the tags in the recipe!
conditionedItem = item.withTag({display: {Name: "Tomato"}});
//Item will only be accepted if in a Stack of at least the specified amount. Mostly used in combination with the consume transformer.
//Note that if you only add this, it will still consume only one item per craft.
conditionedItem = item.onlyStack(32);
Matching
Link to matching
If you want to check if an IItemStack matches your IIngredient you can use the match method. This will return a boolean. If the IIngredient represents a liquid, it will check if the item is a valid container for this liquid.
ZenScript Copyprint(<ore:ingotIron>.matches(<minecraft:iron_ingot>));
print(<ore:ingotIron>.matchesExact(<minecraft:iron_ingot>));
You can also match two IIngredient Objects, in which case you'd need to use the in
operator:
ZenScript Copyval ingots = <minecraft:iron_ingot> | <minecraft:gold_ingot>;
val oreIngot = <ore:ingotIron>;
val ingotGold = <minecraft:gold_ingot>;
//true as the ingots Ingredient has <minecraft:gold_ingot>
ingots has ingotGold;
//false as <minecraft:iron_ingot> cannot be found in <ore:ingotGold>
oreIngot has ingots;