Home Migration Guide Getting Started With Scripts Commands Examples
BracketHandlers

Expansion for MCBlockState

Additional methods for easier modification of block state-related loot tables.

Methods

Deprecated
Scheduled for removal in 1.17: use this#addBlockLootModifier(BlockState, String, ILootModifier) instead.

Adds an IItemStack to the drop for this block, ignoring the current state.

Return Type: void

script.zs
MCBlockState.addBlockDrop(uniqueId as string, stack as IItemStack) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
stack
Type
IItemStack
Description
The stack to add to the drops.
Deprecated
Scheduled for removal in 1.17: use this#addBlockLootModifier(BlockState, String, ILootModifier) instead.

Adds a list of IItemStacks to the drops for this block, ignoring the current state.

Return Type: void

script.zs
MCBlockState.addBlockDrops(uniqueId as string, stack as IItemStack) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
stack
Type
IItemStack
Description
The stack to add to the drops.

Adds an ILootModifier to this block, ignoring the current state.

Return Type: void

script.zs
MCBlockState.addBlockLootModifier(name as string, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add.

Adds an ILootModifier to the current block, only if it matches the current block state precisely and not harvested with the silk touch enchantment.

Return Type: void

script.zs
MCBlockState.addNoSilkTouchLootModifier(name as string, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.
Deprecated
Scheduled for removal in 1.17: use this#addTargetedLootModifier(BlockState, String, ILootModifier) instead.

Adds an IItemStack to the drops of the current block, only if it matches the current block state precisely.

Return Type: void

script.zs
MCBlockState.addTargetedDrop(uniqueId as string, stack as IItemStack) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
stack
Type
IItemStack
Description
The stack to add to the drops.
Deprecated
Scheduled for removal in 1.17: use this#addTargetedLootModifier(BlockState, String, ILootModifier) instead.

Adds a list of IItemStacks to the drops of the current block, only if it matches the current block state precisely.

Return Type: void

script.zs
MCBlockState.addTargetedDrops(uniqueId as string, stacks as IItemStack[]) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
stacks
Type
IItemStack[]
Description
The stacks to add to the drops.

Adds an ILootModifier to the current block, only if it matches the current block state precisely.

Return Type: void

script.zs
MCBlockState.addTargetedLootModifier(name as string, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.
Deprecated
Scheduled for removal in 1.17: use this#addToolLootModifier(BlockState, String, IItemStack, ILootModifier) instead.

Adds an IItemStack to the drops of this block, if it gets broken with the given tool and matches the current block state precisely.

Parameters that may be attached the tool such as count, damage, or NBT data are ignored.

Return Type: void

script.zs
MCBlockState.addToolDrop(uniqueId as string, tool as IItemStack, stack as IItemStack) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
tool
Type
IItemStack
Description
The tool the block state was broken with.
Parameter
stack
Type
IItemStack
Description
The stack to add to the drops.
Deprecated
Scheduled for removal in 1.17: use this#addToolLootModifier(BlockState, String, IItemStack, ILootModifier) instead.

Adds a list of IItemStacks to the drops of this block, if it gets broken with the given tool and matches the current block state precisely.

Parameters that may be attached the tool such as count, damage, or NBT data are ignored.

Return Type: void

script.zs
MCBlockState.addToolDrops(uniqueId as string, tool as IItemStack, stacks as IItemStack[]) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
tool
Type
IItemStack
Description
The tool the block state was broken with.
Parameter
stacks
Type
IItemStack[]
Description
The stacks to add to the drops.

Adds an ILootModifier that fires if this block state gets broken with the given tool.

Parameters that may be attached to the tool such as count, damage, or NBT data are ignored.

Return Type: void

script.zs
MCBlockState.addToolLootModifier(name as string, tool as IItemStack, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
tool
Type
IItemStack
Description
The tool the block state was broken with.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.

Adds an ILootModifier that fires if this block state gets broken with the given tool, optionally considering its damage.

Additional parameters that may be attached to the tool, such as NBT or count, are ignored.

Return Type: void

script.zs
MCBlockState.addToolLootModifier(name as string, tool as IItemStack, matchDamage as boolean, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
tool
Type
IItemStack
Description
The tool the block state was broken with.
Parameter
matchDamage
Type
boolean
Description
Whether to consider damage or not when trying to match the tool.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.

Adds an ILootModifier that fires if this block state gets broken with the given tool, optionally considering its damage or NBT.

Additional parameters that may be attached to the tool, such as count, are ignored.

Return Type: void

script.zs
MCBlockState.addToolLootModifier(name as string, tool as IItemStack, matchDamage as boolean, matchNbt as boolean, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
tool
Type
IItemStack
Description
The tool the block state was broken with.
Parameter
matchDamage
Type
boolean
Description
Whether to consider damage or not when trying to match the tool.
Parameter
matchNbt
Type
boolean
Description
Whether to consider NBT data or not when trying to match the tool.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.

Adds an ILootModifier that fires if this block state gets broken with a tool with the given ToolType.

Damage or NBT is ignored when attempting to match the tool.

Return Type: void

script.zs
MCBlockState.addToolTypeLootModifier(name as string, toolType as ToolType, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier.
Parameter
toolType
Type
ToolType
Description
The type of the tool the block state must be broken with.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block state.