Version:

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

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.

import crafttweaker.api.bracket.BracketHandlers;

Static Methods

Return Type: Attribute

BracketHandlers.getAttribute(tokens as string) as Attribute

Parameter	Type
Parameter tokens	Type string

Gets the give Block. Throws an Exception if not found

Returns: The found Block
Return Type: Block

<block:minecraft:dirt>

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

BracketHandlers.getBlock("minecraft:dirt");

Parameter	Type	Description
Parameter tokens	Type string	Description What you would write in the BEP call.

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

<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");

Parameter	Type	Description
Parameter tokens	Type string	Description The block’s resource location and variants

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

<damagesource:magic>

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

BracketHandlers.getDamageSource("magic");

Parameter	Type	Description
Parameter tokens	Type string	Description the damage sources’ type

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

Returns: The found enchantment
Return Type: Enchantment

<enchantment:minecraft:riptide>

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

BracketHandlers.getEnchantment("minecraft:riptide");

Parameter	Type	Description
Parameter tokens	Type string	Description The enchantment’s registry name

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

Returns: The found entityType
Return Type: EntityType<Entity>

<entitytype:minecraft:pig>

// BracketHandlers.getEntityType(tokens as string) as EntityType<Entity>

BracketHandlers.getEntityType("minecraft:pig");

Parameter	Type	Description
Parameter tokens	Type string	Description The entityType’s resource location

Gets the fluid Stack based on registry name. Throws an error if it can’t find the fluid.

Returns: A stack of the liquid with amount == 1mb
Return Type: IFluidStack

<fluid:minecraft:water>

// BracketHandlers.getFluidStack(tokens as string) as IFluidStack

BracketHandlers.getFluidStack("minecraft:water");

Parameter	Type	Description
Parameter tokens	Type string	Description The Fluid’s resource location

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

Returns: The found item
Return Type: IItemStack

<item:minecraft:dirt>

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

BracketHandlers.getItem("minecraft:dirt");

Parameter	Type	Description
Parameter tokens	Type string	Description The item’s resource location

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

Returns: The found Material
Return Type: Material

<material:earth>

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

BracketHandlers.getMaterial("earth");

Parameter	Type	Description
Parameter tokens	Type string	Description What you would write in the BEP call.

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

Returns: The found mobeffect
Return Type: MobEffect

<mobeffect:minecraft:haste>

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

BracketHandlers.getMobEffect("minecraft:haste");

Parameter	Type	Description
Parameter tokens	Type string	Description The mobeffect’s resource location

Return Type: Potion

BracketHandlers.getPotion(tokens as string) as Potion

Parameter	Type
Parameter tokens	Type string

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

<profession:minecraft:armorer>

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

BracketHandlers.getProfession("minecraft:armorer");

Parameter	Type	Description
Parameter tokens	Type string	Description The profession’s resource location

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

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

BracketHandlers.getRecipeManager("minecraft:crafting");

Parameter	Type	Description
Parameter tokens	Type string	Description The recipeManager’s resource location

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

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

BracketHandlers.getResourceLocation("minecraft:dirt");

Parameter	Type	Description
Parameter tokens	Type string	Description The resource location

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

<soundevent:minecraft:ambient.cave>

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

BracketHandlers.getSoundEvent("minecraft:ambient.cave");

Parameter	Type	Description
Parameter tokens	Type string	Description The sound event’s resource location

Gets an ITargetingStrategy based on its name.

Throws an exception if the strategy doesn’t exist.

Returns: The found targeting strategy
Return Type: ITargetingStrategy

<targetingstrategy:crafttweaker:default>

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

BracketHandlers.getTargetingStrategy("crafttweaker:default");

Parameter	Type	Description
Parameter tokens	Type string	Description The strategy’s resource location

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

<villagertype:minecraft:armorer>

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

BracketHandlers.getVillagerType("minecraft:armorer");

Parameter	Type	Description
Parameter tokens	Type string	Description The profession’s resource location