This class contains the "simple" Bracket handlers from CraftTweaker. However, some Bracket handlers, like for recipeTypes, tags, tagManagers, won't be shown here as they use a different internal structure.

Importing the class

Link to 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.bracket.BracketHandlers;

Name: getAttribute

Return Type: Attribute

ZenScript
Copy
BracketHandlers.getAttribute(tokens as string) as Attribute
ParameterType
Parameter
tokens
Type
string

Name: getBlock

Gets the give Block. Throws an Exception if not found

Returns: The found Block
Return Type: Block

ZenScript
Copy
<block:minecraft:dirt>

// BracketHandlers.getBlock(tokens as string) as Block

BracketHandlers.getBlock("minecraft:dirt");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
What you would write in the BEP call.

Name: getBlockState

Creates a Blockstate based on the given inputs.
Returns null if it cannot find the block, ignored invalid variants

Returns: The found BlockState
Return Type: BlockState

ZenScript
Copy
<blockstate:minecraft:acacia_planks>
<blockstate:minecraft:furnace:facing=north,lit=false>

// BracketHandlers.getBlockState(tokens as string) as BlockState

BracketHandlers.getBlockState("minecraft:acacia_planks");
BracketHandlers.getBlockState("minecraft:furnace:facing=north,lit=false");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The block's resource location and variants

Link to getCreativeModeTab

Name: getCreativeModeTab

Gets an CreativeModeTab by name.
Will throw an error if the tab could not be found!

Returns: The found ItemGroup
Return Type: CreativeModeTab

ZenScript
Copy
<creativemodetab:misc>

// BracketHandlers.getCreativeModeTab(tokens as string) as CreativeModeTab

BracketHandlers.getCreativeModeTab(misc);
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The CreativeModeTab's name.

Name: getDamageSource

Gets a damage source based on type.
If the damage source is not pre-registered, it will create a new one with the given name

Returns: The found pre-registered damage source or a new one
Return Type: DamageSource

ZenScript
Copy
<damagesource:magic>

// BracketHandlers.getDamageSource(tokens as string) as DamageSource

BracketHandlers.getDamageSource("magic");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
the damage sources' type

Name: getEnchantment

Gets the enchantment based on registry name. Throws an error if it can't find the enchantment.

Returns: The found enchantment
Return Type: Enchantment

ZenScript
Copy
<enchantment:minecraft:riptide>

// BracketHandlers.getEnchantment(tokens as string) as Enchantment

BracketHandlers.getEnchantment("minecraft:riptide");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The enchantment's registry name

Name: getEntityType

Gets the entityType based on registry name. Throws an exception if it can't find the entityType.

Returns: The found entityType
Return Type: EntityType

ZenScript
Copy
<entitytype:minecraft:pig>

// BracketHandlers.getEntityType(tokens as string) as EntityType

BracketHandlers.getEntityType("minecraft:pig");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The entityType's resource location

Name: getItem

Gets the item based on registry name. Throws an error if it can't find the item.

Returns: The found item
Return Type: IItemStack

ZenScript
Copy
<item:minecraft:dirt>

// BracketHandlers.getItem(tokens as string) as IItemStack

BracketHandlers.getItem("minecraft:dirt");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The item's resource location

Name: getMaterial

Gets the given Material. Throws an Exception if not found.

Returns: The found Material
Return Type: Material

ZenScript
Copy
<material:earth>

// BracketHandlers.getMaterial(tokens as string) as Material

BracketHandlers.getMaterial("earth");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
What you would write in the BEP call.

Name: getMobEffect

Gets the mobeffect based on registry name. Throws an error if it can't find the mobeffect.

Returns: The found mobeffect
Return Type: MobEffect

ZenScript
Copy
<mobeffect:minecraft:haste>

// BracketHandlers.getMobEffect(tokens as string) as MobEffect

BracketHandlers.getMobEffect("minecraft:haste");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The mobeffect's resource location

Name: getPotion

Return Type: Potion

ZenScript
Copy
BracketHandlers.getPotion(tokens as string) as Potion
ParameterType
Parameter
tokens
Type
string

Name: getProfession

Gets the villager profession based on registry name. Throws an exception if it can't find the profession.

Returns: The found profession
Return Type: VillagerProfession

ZenScript
Copy
<profession:minecraft:armorer>

// BracketHandlers.getProfession(tokens as string) as VillagerProfession

BracketHandlers.getProfession("minecraft:armorer");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The profession's resource location

Link to getRecipeManager

Name: getRecipeManager

Gets the recipeManager based on registry name. Throws an error if it can't find the recipeManager.
Throws an exception if the given recipeType is not found.

This will always return IRecipeManager.

There is also a BEP for that but that works differently so it can't be automatically added to the docs here.
But the BEP looks the same as the other ones: <recipetype:minecraft:crafting>

Returns: The found recipeManager
Return Type: IRecipeManager

ZenScript
Copy
// BracketHandlers.getRecipeManager(tokens as string) as IRecipeManager

BracketHandlers.getRecipeManager("minecraft:crafting");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The recipeManager's resource location

Link to getResourceLocation

Name: getResourceLocation

Deprecated
Use ResourceLocationBracketHandler#getResourceLocation(String) instead.

Creates a Resource location based on the tokens.
Throws an error if the tokens are not a valid location.

Returns: The location
Return Type: ResourceLocation

ZenScript
Copy
// BracketHandlers.getResourceLocation(tokens as string) as ResourceLocation

BracketHandlers.getResourceLocation("minecraft:dirt");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The resource location

Name: getSoundEvent

Gets a sound event based on registry name. Throws an exception if it can't find the sound event.

Returns: The found sound event
Return Type: SoundEvent

ZenScript
Copy
<soundevent:minecraft:ambient.cave>

// BracketHandlers.getSoundEvent(tokens as string) as SoundEvent

BracketHandlers.getSoundEvent("minecraft:ambient.cave");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The sound event's resource location

Link to getTargetingStrategy

Name: getTargetingStrategy

Gets an ITargetingStrategy based on its name.

Throws an exception if the strategy doesn't exist.

Returns: The found targeting strategy
Return Type: ITargetingStrategy

ZenScript
Copy
<targetingstrategy:crafttweaker:default>

// BracketHandlers.getTargetingStrategy(tokens as string) as ITargetingStrategy

BracketHandlers.getTargetingStrategy("crafttweaker:default");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The strategy's resource location

Name: getVillagerType

Gets the villager profession based on registry name. Throws an exception if it can't find the profession.

Returns: The found profession
Return Type: VillagerType

ZenScript
Copy
<villagertype:minecraft:armorer>

// BracketHandlers.getVillagerType(tokens as string) as VillagerType

BracketHandlers.getVillagerType("minecraft:armorer");
ParameterTypeDescription
Parameter
tokens
Type
string
Description
The profession's resource location