Home Migration Guide Getting Started With Scripts Commands Examples
BracketHandlers

MCBlock

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.

script.zs
import crafttweaker.api.blocks.MCBlock;

Casters

Result typeIs Implicit
Result type
MCItemDefinition
Is Implicit
false
Result type
string
Is Implicit
false

Methods

Gets the Item representation of this Block.

NOTE: Not all Blocks have Items, for instance, a Lit Redstone Lamp does not have an Item.

Returns: The Item representation of this Block.
Return Type: MCItemDefinition

script.zs
// MCBlock.asItem() as MCItemDefinition
<block:minecraft:grass_block>.asItem();

Checks if entities can collide with this Block.

Returns: True if entities will collide with this Block. False otherwise.
Return Type: boolean

script.zs
// MCBlock.canCollide() as boolean
<block:minecraft:grass_block>.canCollide();

Checks if an entity can be spawned inside this Block.

This is used to find valid spawn locations for players.

Returns: True if an entity can be spawned in this Block. False Otherwise.
Return Type: boolean

script.zs
// MCBlock.canSpawnInBlock() as boolean
<block:minecraft:grass_block>.canSpawnInBlock();

Gets the blast resistance of this Block.

Returns: The blast resistance of this Block.
Return Type: float

script.zs
// MCBlock.getBlastResistance() as float
<block:minecraft:grass_block>.getBlastResistance();

Gets the block bracket handler syntax for this Block.

E.G. block:minecraft:dirt

Returns: The block bracket handler syntax for this Block.
Return Type: string

script.zs
// MCBlock.getCommandString() as string
<block:minecraft:grass_block>.getCommandString();

Gets the default MCBlockState of this Block.

Returns: The default MCBlockState of this Block.
Return Type: MCBlockState

script.zs
// MCBlock.getDefaultState() as MCBlockState
<block:minecraft:grass_block>.getDefaultState();

Gets the harvest level for this Block.

NOTE: This will get the level for the default blockstate, you should use the BlockState specific method for a more accurate result!

Returns: The harvest tool for this Block.
Return Type: int

script.zs
// MCBlock.getHarvestLevel() as int
<block:minecraft:grass_block>.getHarvestLevel();

Gets the harvest tool for this Block.

NOTE: This will get the tool for the default blockstate, you should use the BlockState specific method for a more accurate result!

Returns: The harvest tool for this Block.
Return Type: ToolType?

script.zs
// MCBlock.getHarvestTool() as ToolType?
<block:minecraft:grass_block>.getHarvestTool();

Gets the jump factor of this Block.

Returns: The jump factor of this Block.
Return Type: float

script.zs
// MCBlock.getJumpFactor() as float
<block:minecraft:grass_block>.getJumpFactor();

Gets the loot table id for this Block.

Returns: The loot table id for this Block.
Return Type: string

script.zs
// MCBlock.getLootTable() as string
<block:minecraft:grass_block>.getLootTable();

Gets the material of this Block.

Returns: The material of this Block.
Return Type: MCMaterial

script.zs
// MCBlock.getMaterial() as MCMaterial
<block:minecraft:grass_block>.getMaterial();

Gets the registry name of this block.

Returns: A ResourceLocation of the registry name of this block.
Return Type: MCResourceLocation

script.zs
// MCBlock.getRegistryName() as MCResourceLocation
<block:minecraft:grass_block>.getRegistryName();

Gets the slipperiness of this Block.

Returns: The Slipperiness of this Block.
Return Type: float

script.zs
// MCBlock.getSlipperiness() as float
<block:minecraft:grass_block>.getSlipperiness();

Gets the speed factor of this Block.

Returns: The speed factor of this Block.
Return Type: float

script.zs
// MCBlock.getSpeedFactor() as float
<block:minecraft:grass_block>.getSpeedFactor();

Gets all the MCTag<T>s that contain this Block.

Returns: a List of MCTag<T>s that contain this Block.
Return Type: stdlib.List<MCTag<MCBlock>>

script.zs
// MCBlock.getTags() as stdlib.List<MCTag<MCBlock>>
<block:minecraft:grass_block>.getTags();

Gets the translation key that is used to localize this Block.

Returns: The unlocalized name of this block.
Return Type: string

script.zs
// MCBlock.getTranslationKey() as string
<block:minecraft:grass_block>.getTranslationKey();

Gets a list of valid MCBlockStates for this Block.

Returns: A list of valid MCBlockStates for this Block.
Return Type: stdlib.List<MCBlockState>

script.zs
// MCBlock.getValidStates() as stdlib.List<MCBlockState>
<block:minecraft:grass_block>.getValidStates();

Checks if this Block is in the given MCTag<T>.

Returns: True if this Block is in the MCTag<T>. False otherwise.
Return Type: boolean

script.zs
MCBlock.isInTag(tag as MCTag<MCBlock>) as boolean
ParameterTypeDescription
Parameter
tag
Type
MCTag<MCBlock>
Description
The MCTag<T> to check against.

Checks if the opacity of this block is different in different areas of the Block.

Returns: True if this Block has variable opacity. False otherwise.
Return Type: boolean

script.zs
// MCBlock.isVariableOpacity() as boolean
<block:minecraft:grass_block>.isVariableOpacity();

Checks whether this Block matches another Block.

Returns: True if this Block matches the other Block. False otherwise.
Return Type: boolean

script.zs
MCBlock.matchesBlock(other as MCBlock) as boolean
ParameterTypeDescription
Parameter
other
Type
MCBlock
Description
The other Block to check if this Block matches.

Sets the blast resistance of this Block.

Return Type: void

script.zs
// MCBlock.setBlastResistance(resistance as float) as void
<block:minecraft:grass_block>.setBlastResistance(2);
ParameterTypeDescription
Parameter
resistance
Type
float
Description
The new blast resistance of this Block.

Sets whether entities can collide with this Block.

Return Type: void

script.zs
// MCBlock.setCanCollide(canCollide as boolean) as void
<block:minecraft:grass_block>.setCanCollide(true);
ParameterTypeDescription
Parameter
canCollide
Type
boolean
Description
Can entities collide with this Block.

Sets the harvest level for this Block.

Return Type: void

script.zs
// MCBlock.setHarvestLevel(level as int) as void
<block:minecraft:grass_block>.setHarvestLevel(2);
ParameterTypeDescription
Parameter
level
Type
int
Description
the new harvest level.

Sets the harvest tool for this Block.

Return Type: void

script.zs
// MCBlock.setHarvestTool(type as ToolType?) as void
<block:minecraft:grass_block>.setHarvestTool(<tooltype:axe>);
ParameterTypeDescription
Parameter
type
Type
ToolType?
Description
The new tooltype.

Sets the jump factor of this Block.

Return Type: void

script.zs
// MCBlock.setJumpFactor(jumpFactor as float) as void
<block:minecraft:grass_block>.setJumpFactor(2);
ParameterTypeDescription
Parameter
jumpFactor
Type
float
Description
The new jump factor of this Block.

Sets the material of this Block.

Return Type: void

script.zs
// MCBlock.setMaterial(material as MCMaterial) as void
<block:minecraft:grass_block>.setMaterial(<blockmaterial:earth>);
ParameterTypeDescription
Parameter
material
Type
MCMaterial
Description
The new material of this Block.

Sets the slipperiness of this Block.

Return Type: void

script.zs
// MCBlock.setSlipperiness(slipperiness as float) as void
<block:minecraft:grass_block>.setSlipperiness(2);
ParameterTypeDescription
Parameter
slipperiness
Type
float
Description
The new slipperiness of this Block.

Sets the speed factor of this Block.

Return Type: void

script.zs
// MCBlock.setSpeedFactor(speedFactor as float) as void
<block:minecraft:grass_block>.setSpeedFactor(2);
ParameterTypeDescription
Parameter
speedFactor
Type
float
Description
The new speed factor of this Block.

Properties

NameTypeHas GetterHas SetterDescription
Name
blastResistance
Type
float
Has Getter
true
Has Setter
true
Description
Gets the blast resistance of this Block.
Name
canCollide
Type
boolean
Has Getter
true
Has Setter
true
Description
Checks if entities can collide with this Block.
Name
commandString
Type
string
Has Getter
true
Has Setter
false
Description
Gets the block bracket handler syntax for this Block.

E.G.

block:minecraft:dirt
Name
defaultState
Type
MCBlockState
Has Getter
true
Has Setter
false
Description
Gets the default MCBlockState of this Block.
Name
harvestLevel
Type
int
Has Getter
true
Has Setter
true
Description
Gets the harvest level for this Block.

NOTE:
This will get the level for the default blockstate, you should use the BlockState specific method for a more accurate result!
Name
harvestTool
Type
ToolType?
Has Getter
true
Has Setter
true
Description
Gets the harvest tool for this Block.

NOTE:
This will get the tool for the default blockstate, you should use the BlockState specific method for a more accurate result!
Name
jumpFactor
Type
float
Has Getter
true
Has Setter
true
Description
Gets the jump factor of this Block.
Name
lootTable
Type
string
Has Getter
true
Has Setter
false
Description
Gets the loot table id for this Block.
Name
material
Type
MCMaterial
Has Getter
true
Has Setter
true
Description
Gets the material of this Block.
Name
registryName
Type
MCResourceLocation
Has Getter
true
Has Setter
false
Description
Gets the registry name of this block.
Name
slipperiness
Type
float
Has Getter
true
Has Setter
true
Description
Gets the slipperiness of this Block.
Name
speedFactor
Type
float
Has Getter
true
Has Setter
true
Description
Gets the speed factor of this Block.
Name
tags
Type
stdlib.List<MCTag<MCBlock>>
Has Getter
true
Has Setter
false
Description
Gets all the MCTag<T>s that contain this Block.
Name
translationKey
Type
string
Has Getter
true
Has Setter
false
Description
Gets the translation key that is used to localize this Block.
Name
validStates
Type
stdlib.List<MCBlockState>
Has Getter
true
Has Setter
false
Description
Gets a list of valid MCBlockStates for this Block.
Name
variableOpacity
Type
boolean
Has Getter
true
Has Setter
false
Description
Checks if the opacity of this block is different in different areas of the Block.