Version:

Language:

Replacer

Handles the replacing of ingredients in recipes for various IRecipeManagers and WrapperRecipes.

Differently from various other mechanisms in CraftTweaker, each replacement that gets specified from within a Replacer doesn't get run immediately, rather it gets stored and all replacements are then applied together when the this#execute() method is called. This change is done so that multiple replacements can be performed at the same time, with a net gain on performance.

Note that replacement must be explicitly supported by modded recipe types and managers, meaning that a Replacer may not be able to perform replacement on a certain set of recipes. If this is the case, a warning will be printed in the logs, so that you may review it.

Creating a Replacer gets done via the various forXxx methods, where Xxx identifies any suffix. Refer to the specific documentation to get more information on their behavior.

The various replace methods, listed both in this page and in other mod's possible expansions, then allow you to specify what should be the replacements that need to be carried out by the Replacer itself.

All recipes that get replaced by a Replacer get renamed according to a set naming scheme. You can modify completely by providing a lambda via this#useForRenaming(BiFunction), or just for a specific set of recipes via this#explicitlyRename(ResourceLocation, String).

An example usage of a Replacer could be Replacer.forTypes(craftingTable).replace(<item:minecraft:string>, <item:minecraft:diamond>).execute();

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.

ZenScript
 Copy
import crafttweaker.api.recipe.Replacer;

Static Methods

forAllTypes

Name: forAllTypes

Deprecated

Use this#forEverything() instead.

Creates a Replacer that will perform replacements globally.

In other words, the replacer will perform ingredient replacement on every recipe manager in
the game, as long as it supports replacement.

Returns: A new global Replacer.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forAllTypes() as Replacer

Replacer.forAllTypes();

forAllTypesExcluding

Name: forAllTypesExcluding

Deprecated

Use this#forEverything() to create a replacer then use this#excluding(IRecipeManager...) to exclude the various unwanted managers.

Creates a Replacer that will perform replacements on all IRecipeManagers except the ones
specified.

Returns: A new Replacer that targets all managers except the ones specified.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forAllTypesExcluding(managers as IRecipeManager[]) as Replacer

Replacer.forAllTypesExcluding(stoneCutter);

Parameter	Type	Description
Parameter managers	Type IRecipeManager[]	Description The managers to exclude from the replacer.

forCustomRecipeSet

Name: forCustomRecipeSet

Creates a Replacer that will perform replacements only on the recipes whitelisted by the given function.

The first parameter of the predicate is a WrapperRecipe that indicates the recipe that is currently
being tested, whereas the second is the IRecipeManager that is responsible for handling that particular
type of recipes. The function should then return a boolean that either whitelists the recipe for replacement
(true) or blacklists it (false).

The given function must be a pure function, which means that the output must be the same
given the same set of inputs. In other words, you should not rely on external state for this function, since it
may be called multiple times on the same set of inputs in the same replacer run.

Returns: A new Replacer that uses the given function for whitelisting.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forCustomRecipeSet(function as BiPredicate<WrapperRecipe,IRecipeManager>) as Replacer

Replacer.forCustomRecipeSet(myPredicate);

Parameter	Type	Description
Parameter function	Type BiPredicate<WrapperRecipe,IRecipeManager>	Description The custom whitelisting function.

forEverything

Name: forEverything

Returns: A new global Replacer.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forEverything() as Replacer

Replacer.forEverything();

forMods

Name: forMods

Creates a Replacer that targets only the given mods.

In other words, the replacer will perform ingredient replacement across all
IRecipeManagers, targeting only the recipes added by the specified mods.

Returns: A new Replacer that targets only the specified mods.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forMods(mods as string[]) as Replacer

Replacer.forMods("minecraft");

Parameter	Type	Description
Parameter mods	Type string[]	Description The mods whose recipes should be targeted by the replacer. It must be at least one.

forOutput

Name: forOutput

Creates a Replacer that will perform replacement only on recipes with the given output, optionally
restricted to a set of whitelisted managers.

The passed in whitelist may also be empty, in which case it'll be treated as meaning every possible recipe
manager. If the whitelist is not empty, on the other hand, only the selected recipe managers will be considered
when replacing ingredients.

Returns: A new Replacer for recipes with the given output and an optional whitelist.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forOutput(output as IIngredient, whitelist as IRecipeManager[]) as Replacer

Replacer.forOutput(<tag:items:forge:rods/wooden>, stoneCutter);

Parameter	Type	Description
Parameter output	Type IIngredient	Description The output that should be matched.
Parameter whitelist	Type IRecipeManager[]	Description An optional list of managers that should be whitelisted in the replacement.

forRecipes

Name: forRecipes

Creates a Replacer that targets only the specified WrapperRecipes.

In other words, the replacer will perform ingredient replacement only on the recipes that
are given in this list.

Returns: A new Replacer that targets only the specified recipes.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forRecipes(recipes as WrapperRecipe[]) as Replacer

Replacer.forRecipes(craftingTable.getRecipeByName("minecraft:emerald_block"));

Parameter	Type	Description
Parameter recipes	Type WrapperRecipe[]	Description The recipes that should be targeted by the replacer. It must be at least one.

forRegexRecipes

Name: forRegexRecipes

Creates a Replacer that will perform replacement on all recipes whose names match the given regular
expression.

Returns: A new Replacer for recipes that satisfy the given regular expression.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forRegexRecipes(regex as string) as Replacer

Replacer.forRegexRecipes("\\d_\\d");

Parameter	Type	Description
Parameter regex	Type string	Description The regular expression that should be used for matching.

forRegexTypes

Name: forRegexTypes

Creates a Replacer that will perform replacement on all IRecipeManagers that match the given
regular expression.

The managers will be matched on their bracket identifier, which corresponds to their bracket expression
stripped of <recipetype: and >. E.g., a manager obtained in a script via
<recipetype:minecraft:crafting> will be matched on minecraft:crafting only.

Returns: A new Replacer for managers that satisfy the given regular expression.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forRegexTypes(regex as string) as Replacer

Replacer.forRegexTypes("^minecraft:[a-z]*ing");

Parameter	Type	Description
Parameter regex	Type string	Description The regular expression that should be used for matching.

forTypes

Name: forTypes

Creates a Replacer that targets only the specified IRecipeManagers.

In other words, the replacer will perform ingredient replacement only on the managers that
are given in this list.

Returns: A new Replacer that targets only the specified managers.
Return Type: Replacer

ZenScript
 Copy
// Replacer.forTypes(managers as IRecipeManager[]) as Replacer

Replacer.forTypes(smithing);

Parameter	Type	Description
Parameter managers	Type IRecipeManager[]	Description The managers that will be targeted by the replacer. It must be at least one.

Methods

excluding

Name: excluding

Excludes a set of managers from undergoing replacement.

Returns: A Replacer that excludes the given set of recipe managers.
Return Type: Replacer

ZenScript
 Copy
// Replacer.excluding(managers as IRecipeManager[]) as Replacer

Replacer.forEverything().excluding(stoneCutter);

Parameter	Type	Description
Parameter managers	Type IRecipeManager[]	Description The list of managers that should be excluded.

excluding

Name: excluding

Excludes a set of recipes, identified by their name, from undergoing replacement.

Returns: A Replacer that excludes the given set of recipes.
Return Type: Replacer

ZenScript
 Copy
// Replacer.excluding(recipes as MCResourceLocation[]) as Replacer

Replacer.forEverything().excluding(<resource:minecraft:comparator>);

Parameter	Type	Description
Parameter recipes	Type MCResourceLocation[]	Description The list of recipes that should be excluded.

excludingMods

Name: excludingMods

Excludes all recipes that are under the given modids from undergoing replacement.

Returns: A Replacer that excludes the given set of modids.
Return Type: Replacer

ZenScript
 Copy
// Replacer.excludingMods(modids as string[]) as Replacer

Replacer.forEverything().excludingMods("mekanism");

Parameter	Type	Description
Parameter modids	Type string[]	Description The list of modids that should be excluded.

execute

Name: execute

Executes all replacements that have been queued on this replacer, if any.

Return Type: void

ZenScript
 Copy
// Replacer.execute() as void

Replacer.forEverything().execute();

explicitlyRename

Name: explicitlyRename

Indicates that the recipe with the given oldName should be renamed to the newName.

This rename will only be applied if a replacement is carried out. Moreover, the given new name will also be fixed according to NameUtils#fixing(String).

Returns: A Replacer that will rename the recipe according to the specified rule.
Return Type: Replacer

ZenScript
 Copy
// Replacer.explicitlyRename(oldName as MCResourceLocation, newName as string) as Replacer

Replacer.forEverything().explicitlyRename(<resource:minecraft:birch_sign>, "damn_hard_birch_sign");

Parameter	Type	Description
Parameter oldName	Type MCResourceLocation	Description The MCResourceLocation of the name of the recipe that should be renamed.
Parameter newName	Type string	Description The new name of the recipe.

replace

Name: replace

Replaces every match of the from IIngredient with the one given in to.

This replacement behavior is recursive, meaning that any IIngredient that gets found is looped recursively trying to identify matches. As an example, attempting to replace <item:minecraft:stone> with <item:minecraft:diamond> will perform this replacement even in compound ingredients, such as <item:minecraft:stone> | <item:minecraft:gold_ingot> or <tag:items:minecraft:stones> (supposing that minecraft:stones is a tag that contains minecraft:stone among other items).

If this behavior is not desired, refer to this#replaceFully(IIngredient, IIngredient) instead.

This method is a specialized by this#replace(IItemStack, IIngredient) for IItemStacks and should be preferred in these cases.

Returns: A Replacer that will carry out the specified operation.
Return Type: Replacer

ZenScript
 Copy
// Replacer.replace(from as IIngredient, to as IIngredient) as Replacer

Replacer.forEverything().replace(<tag:items:forge:storage_blocks/redstone>, <item:minecraft:diamond_block>);

Parameter	Type	Description
Parameter from	Type IIngredient	Description An IIngredient that will be used to match stacks that need to be replaced.
Parameter to	Type IIngredient	Description The replacement IIngredient.

replace

Name: replace

Replaces every match of the from IItemStack with the one given in to.

If this behavior is not desired, refer to this#replaceFully(IIngredient, IIngredient) instead.

This method is a specialization of this#replace(IIngredient, IIngredient) for IItemStacks and should be preferred in these cases.

Returns: A Replacer that will carry out the specified operation.
Return Type: Replacer

ZenScript
 Copy
// Replacer.replace(from as IItemStack, to as IIngredient) as Replacer

Replacer.forEverything().replace(<item:minecraft:coal_block>, <item:minecraft:diamond_block>);

Parameter	Type	Description
Parameter from	Type IItemStack	Description An IItemStack that will be used to match stacks that need to be replaced.
Parameter to	Type IIngredient	Description The replacement IIngredient.

replaceFully

Name: replaceFully

Replaces every instance of the target from IIngredient with the to one.

This replacement behavior is not recursive, meaning that the IIngredients will be matched closely instead of recursively. As an example, attempting to replace fully <item:minecraft:stone> will only replace ingredients that explicitly specify <item:minecraft:stone> as an input, while compound ingredients such as <item:minecraft:stone> | <item:minecraft:gold_ingot> won't be replaced.

If this behavior is not desired, refer to this#replace(IIngredient, IIngredient) instead.

Returns: A Replacer that will carry out the specified operation.
Return Type: Replacer

ZenScript
 Copy
// Replacer.replaceFully(from as IIngredient, to as IIngredient) as Replacer

Replacer.forEverything().replaceFully(<tag:items:minecraft:anvil>, <tag:items:minecraft:flowers>);

Parameter	Type	Description
Parameter from	Type IIngredient	Description An IIngredient that will be used to match to specify the ingredient to replace.
Parameter to	Type IIngredient	Description The replacement IIngredient.

suppressWarnings

Name: suppressWarnings

Suppresses warnings that arise when trying to replace unsupported recipes.

Additional warnings will not be suppressed. Note that it is suggested to keep this disabled while testing and enable it only if excluding the problematic recipes via this#excluding(ResourceLocation...) would prove to be too cumbersome.

Returns: A Replacer with replacement warnings suppressed.
Return Type: Replacer

ZenScript
 Copy
// Replacer.suppressWarnings() as Replacer

Replacer.forEverything().suppressWarnings();

useForRenaming

Name: useForRenaming

Specifies the BiFunction<T,U,R> that will be used for renaming all recipes.

The first argument to the function is the MCResourceLocation that uniquely identifies its name, whereas the second represents the default name for the recipe according to the default replacement rules. The return value of the function will then represent the new name of the recipe.

Returns: A Replacer that will use the given function for renaming.
Return Type: Replacer

ZenScript
 Copy
// Replacer.useForRenaming(function as BiFunction<MCResourceLocation,string,string>) as Replacer

Replacer.forEverything().useForRenaming(myFunction);

Parameter	Type	Description
Parameter function	Type BiFunction<MCResourceLocation,string,string>	Description The renaming function.