Home Migration Guide Getting Started With Scripts Commands Examples
BracketHandlers

MCIngredientConditioned<T : IIngredient>

Importing the class

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 at the very top of the file.

script.zs
import crafttweaker.api.item.MCIngredientConditioned;

Implemented Interfaces

MCIngredientConditioned implements the following interfaces. That means all methods defined in these interfaces are also available in MCIngredientConditioned

Casters

Result typeIs Implicit
Result type
IData
Is Implicit
true
Result type
MapData
Is Implicit
true

Methods

Adds an AttributeModifier to this IIngredient.

Attributes added with this method appear on all ItemStacks that match this IIngredient, regardless of how or when the ItemStack was made, if you want to have the attribute on a single specific ItemStack (such as a specific Diamond Sword made in a recipe), then you should use IItemStack#withAttributeModifier

Return Type: void

script.zs
// MCIngredientConditioned.addGlobalAttributeModifier(attribute as Attribute, name as string, value as double, operation as AttributeOperation, slotTypes as MCEquipmentSlotType[]) as void
myMCIngredientConditioned.addGlobalAttributeModifier(<attribute:minecraft:generic.attack_damage>, "Extra Power", 10, AttributeOperation.ADDITION, [<equipmentslottype:chest>]);
ParameterTypeDescription
Parameter
attribute
Type
Attribute
Description
The Attribute of the modifier.
Parameter
name
Type
string
Description
The name of the modifier.
Parameter
value
Type
double
Description
The value of the modifier.
Parameter
operation
Type
AttributeOperation
Description
The operation of the modifier.
Parameter
slotTypes
Type
MCEquipmentSlotType[]
Description
What slots the modifier is valid for.

Adds an AttributeModifier to this IIngredient using a specific UUID.

The UUID can be used to override an existing attribute on an ItemStack with this new modifier. You can use /ct hand attributes to get the UUID of the attributes on an ItemStack.

Attributes added with this method appear on all ItemStacks that match this IIngredient, regardless of how or when the ItemStack was made, if you want to have the attribute on a single specific ItemStack (such as a specific Diamond Sword made in a recipe), then you should use IItemStack#withAttributeModifier

Return Type: void

script.zs
// MCIngredientConditioned.addGlobalAttributeModifier(attribute as Attribute, uuid as string, name as string, value as double, operation as AttributeOperation, slotTypes as MCEquipmentSlotType[]) as void
myMCIngredientConditioned.addGlobalAttributeModifier(<attribute:minecraft:generic.attack_damage>, "8c1b5535-9f79-448b-87ae-52d81480aaa3", "Extra Power", 10, AttributeOperation.ADDITION, [<equipmentslottype:chest>]);
ParameterTypeDescription
Parameter
attribute
Type
Attribute
Description
The Attribute of the modifier.
Parameter
uuid
Type
string
Description
The unique identifier of the modifier to replace.
Parameter
name
Type
string
Description
The name of the modifier.
Parameter
value
Type
double
Description
The value of the modifier.
Parameter
operation
Type
AttributeOperation
Description
The operation of the modifier.
Parameter
slotTypes
Type
MCEquipmentSlotType[]
Description
What slots the modifier is valid for.

Return Type: void

script.zs
MCIngredientConditioned.addShiftTooltip(content as MCTextComponent, showMessage as MCTextComponent) as void
ParameterTypeDescriptionOptionalDefaultValue
Parameter
content
Type
MCTextComponent
Description
No Description Provided
Optional
false
DefaultValue
Parameter
showMessage
Type
MCTextComponent
Description
No Description Provided
Optional
true
DefaultValue

Return Type: void

script.zs
MCIngredientConditioned.addTooltip(content as MCTextComponent) as void
ParameterTypeDescription
Parameter
content
Type
MCTextComponent
Description
No Description Provided

Return Type: MCIngredientConditioned<IIngredient>

script.zs
// MCIngredientConditioned.anyDamage() as MCIngredientConditioned<IIngredient>
myMCIngredientConditioned.anyDamage();

Return Type: void

script.zs
// MCIngredientConditioned.clearTooltip() as void
myMCIngredientConditioned.clearTooltip();

Does the ingredient contain the given ingredient?

Return Type: boolean

script.zs
// MCIngredientConditioned.contains(ingredient as IIngredient) as boolean
myMCIngredientConditioned.contains((<item:minecraft:iron_ingot> | <item:minecraft:gold_ingot>));
ParameterTypeDescription
Parameter
ingredient
Type
IIngredient
Description
The ingredient to check

When this ingredient stack is crafted, what will remain in the grid? Does not check if the stack matches though! Used e.g. in Crafting Table recipes.

Return Type: IItemStack

script.zs
// MCIngredientConditioned.getRemainingItem(stack as IItemStack) as IItemStack
myMCIngredientConditioned.getRemainingItem(<item:minecraft:iron_ingot>);
ParameterTypeDescription
Parameter
stack
Type
IItemStack
Description
The stack to provide for this ingredient.

Does the given stack match the ingredient?

Return Type: boolean

script.zs
// MCIngredientConditioned.matches(stack as IItemStack) as boolean
myMCIngredientConditioned.matches(<item:minecraft:iron_ingot>);
ParameterTypeDescription
Parameter
stack
Type
IItemStack
Description
The stack to check

Return Type: boolean

script.zs
MCIngredientConditioned.matches(stack as IItemStack, ignoreDamage as boolean) as boolean
ParameterTypeDescription
Parameter
stack
Type
IItemStack
Description
No Description Provided
Parameter
ignoreDamage
Type
boolean
Description
No Description Provided

Return Type: void

script.zs
MCIngredientConditioned.modifyShiftTooltip(shiftedFunction as ITooltipFunction, unshiftedFunction as ITooltipFunction) as void
ParameterTypeDescriptionOptionalDefaultValue
Parameter
shiftedFunction
Type
ITooltipFunction
Description
No Description Provided
Optional
false
DefaultValue
Parameter
unshiftedFunction
Type
ITooltipFunction
Description
No Description Provided
Optional
true
DefaultValue

Return Type: void

script.zs
MCIngredientConditioned.modifyTooltip(function as ITooltipFunction) as void
ParameterTypeDescription
Parameter
function
Type
ITooltipFunction
Description
No Description Provided

Use this if you already have the condition from another ingredient

Return Type: MCIngredientConditioned<IIngredient>

script.zs
MCIngredientConditioned.only(condition as IIngredientCondition<IIngredient>) as MCIngredientConditioned<IIngredient>
ParameterTypeDescription
Parameter
condition
Type
IIngredientCondition<IIngredient>
Description
No Description Provided

Return Type: MCIngredientConditioned<IIngredient>

script.zs
// MCIngredientConditioned.onlyDamaged() as MCIngredientConditioned<IIngredient>
myMCIngredientConditioned.onlyDamaged();

Return Type: MCIngredientConditioned<IIngredient>

script.zs
MCIngredientConditioned.onlyDamagedAtLeast(minDamage as int) as MCIngredientConditioned<IIngredient>
ParameterTypeDescription
Parameter
minDamage
Type
int
Description
No Description Provided

Return Type: MCIngredientConditioned<IIngredient>

script.zs
MCIngredientConditioned.onlyDamagedAtMost(maxDamage as int) as MCIngredientConditioned<IIngredient>
ParameterTypeDescription
Parameter
maxDamage
Type
int
Description
No Description Provided

Return Type: MCIngredientConditioned<IIngredient>

script.zs
MCIngredientConditioned.onlyIf(uid as string, function as Predicate<IItemStack>) as MCIngredientConditioned<IIngredient>
ParameterTypeDescriptionOptionalDefaultValue
Parameter
uid
Type
string
Description
No Description Provided
Optional
false
DefaultValue
Parameter
function
Type
Predicate<IItemStack>
Description
No Description Provided
Optional
true
DefaultValue

Removes all AttributeModifiers that use the given Attribute from this IIngredient.

Attributes removed with this method are removed from ItemStacks that match this IIngredient, regardless of how or when the ItemStack was made, if you want to remove the attribute on a single specific ItemStack (such as a specific Diamond Sword made in a recipe), then you should use IItemStack#withoutAttribute.

This method can only remove default Attributes from an ItemStack, it is still possible that an ItemStack can override it.

Return Type: void

script.zs
// MCIngredientConditioned.removeGlobalAttribute(attribute as Attribute, slotTypes as MCEquipmentSlotType[]) as void
myMCIngredientConditioned.removeGlobalAttribute(<attribute:minecraft:generic.attack_damage>, [<equipmentslottype:chest>]);
ParameterTypeDescription
Parameter
attribute
Type
Attribute
Description
The attribute to remove.
Parameter
slotTypes
Type
MCEquipmentSlotType[]
Description
The slot types to remove it from.

Removes all AttributeModifiers who’s ID is the same as the given uuid from this IIngredient.

Return Type: void

script.zs
// MCIngredientConditioned.removeGlobalAttributeModifier(uuid as string, slotTypes as MCEquipmentSlotType[]) as void
myMCIngredientConditioned.removeGlobalAttributeModifier("8c1b5535-9f79-448b-87ae-52d81480aaa3", [<equipmentslottype:chest>]);
ParameterTypeDescription
Parameter
uuid
Type
string
Description
The unique id of the AttributeModifier to remove.
Parameter
slotTypes
Type
MCEquipmentSlotType[]
Description
The slot types to remove it from.

Return Type: void

script.zs
MCIngredientConditioned.removeTooltip(regex as string) as void
ParameterTypeDescription
Parameter
regex
Type
string
Description
No Description Provided

Operators

Does the ingredient contain the given ingredient?

script.zs
ingredient as IIngredient in myMCIngredientConditioned
(<item:minecraft:iron_ingot> | <item:minecraft:gold_ingot>) in myMCIngredientConditioned
script.zs
myMCIngredientConditioned | other as IIngredient

Properties

NameTypeHas GetterHas SetterDescription
Name
baseIngredient
Type
T
Has Getter
true
Has Setter
false
Description
No Description Provided
Name
burnTime
Type
void
Has Getter
false
Has Setter
true
Description
Sets the burn time of this ingredient, for use in the furnace and other machines
Name
condition
Type
IIngredientCondition<T>
Has Getter
true
Has Setter
false
Description
No Description Provided
Name
items
Type
IItemStack[]
Has Getter
true
Has Setter
false
Description
No Description Provided