Home Migration Guide Getting Started With Scripts Commands Examples
BracketHandlers

Expansion for MCBlock

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

Methods

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

Adds an IItemStack as a drop for this block.

Return Type: void

script.zs
MCBlock.addDrop(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#addLootModifier(Block, String, ILootModifier) instead.

Adds a list of IItemStacks as drops for this block.

Return Type: void

script.zs
MCBlock.addDrops(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 this block, with the given name.

Return Type: void

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

Adds an ILootModifier to the current block, only if it is not harvested with the silk touch enchantment.

Return Type: void

script.zs
MCBlock.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.
Deprecated
Scheduled for removal in 1.17: use this#addStateLootModifier(Block, String, Consumer, ILootModifier) instead.

Adds an IItemStack to the drops of this block if it matches the state outlined in the StatePropertiesPredicate.

Return Type: void

script.zs
MCBlock.addStateDrop(uniqueId as string, statePredicate as Consumer<StatePropertiesPredicate>, stack as IItemStack) as void
ParameterTypeDescription
Parameter
uniqueId
Type
string
Description
A unique identifier for this loot modifier.
Parameter
statePredicate
Type
Consumer<StatePropertiesPredicate>
Description
A consumer to configure the StatePropertiesPredicate to identify the target state.
Parameter
stack
Type
IItemStack
Description
The stack to add to the drops.

Adds an ILootModifier to this block, firing only if it matches the state outlined in the StatePropertiesPredicate.

Return Type: void

script.zs
MCBlock.addStateLootModifier(name as string, statePredicate as Consumer<StatePropertiesPredicate>, modifier as ILootModifier) as void
ParameterTypeDescription
Parameter
name
Type
string
Description
The name of the loot modifier to add.
Parameter
statePredicate
Type
Consumer<StatePropertiesPredicate>
Description
A consumer to configure the StatePropertiesPredicate to identify the target state.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add.
Deprecated
Scheduled for removal in 1.17: use this#addToolLootModifier(Block, String, IItemStack, ILootModifier) instead.

Adds an IItemStack to the drops of this block, if it gets broken with the given tool.

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

Return Type: void

script.zs
MCBlock.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 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(Block, String, IItemStack, ILootModifier) instead.

Adds a list of IItemStacks to the drops of this block, if it gets broken with the given tool.

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

Return Type: void

script.zs
MCBlock.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 was broken with.
Parameter
stacks
Type
IItemStack[]
Description
The stacks to add to the drops.

Adds an ILootModifier that fires if this block 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
MCBlock.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 was broken with.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block.

Adds an ILootModifier that fires if this block 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
MCBlock.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 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.

Adds an ILootModifier that fires if this block 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
MCBlock.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 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.

Adds an ILootModifier that fires if this block 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
MCBlock.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 must be broken with.
Parameter
modifier
Type
ILootModifier
Description
The loot modifier to add to the block.