Block - CraftTweaker Documentation

Version:

Language:

Home Getting Started With Scripts Commands Examples

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.block.Block;

Casters

Result type	Is Implicit
Result type ItemDefinition	Is Implicit false
Result type string	Is Implicit false

Methods

asItem

Name: asItem

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: ItemDefinition

ZenScript
 Copy
// Block.asItem() as ItemDefinition

<block:minecraft:grass_block>.asItem();

getCommandString

Name: getCommandString

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

ZenScript
 Copy
// Block.getCommandString() as string

<block:minecraft:grass_block>.getCommandString();

getDefaultState

Name: getDefaultState

Gets the default BlockState of this Block.

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

ZenScript
 Copy
// Block.getDefaultState() as BlockState

<block:minecraft:grass_block>.getDefaultState();

getDescriptionId

Name: getDescriptionId

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

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

ZenScript
 Copy
// Block.getDescriptionId() as string

<block:minecraft:grass_block>.getDescriptionId();

getExplosionResistance

Name: getExplosionResistance

Gets the blast resistance of this Block.

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

ZenScript
 Copy
// Block.getExplosionResistance() as float

<block:minecraft:grass_block>.getExplosionResistance();

getFriction

Name: getFriction

Gets the friction of this Block.

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

ZenScript
 Copy
// Block.getFriction() as float

<block:minecraft:grass_block>.getFriction();

getJumpFactor

Name: getJumpFactor

Gets the jump factor of this Block.

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

ZenScript
 Copy
// Block.getJumpFactor() as float

<block:minecraft:grass_block>.getJumpFactor();

getLootTable

Name: getLootTable

Gets the loot table id for this Block.

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

ZenScript
 Copy
// Block.getLootTable() as string

<block:minecraft:grass_block>.getLootTable();

getMaterial

Name: getMaterial

Gets the material of this Block.

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

ZenScript
 Copy
// Block.getMaterial() as Material

<block:minecraft:grass_block>.getMaterial();

getPossibleStates

Name: getPossibleStates

Gets a list of valid BlockStates for this Block.

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

ZenScript
 Copy
// Block.getPossibleStates() as stdlib.List<BlockState>

<block:minecraft:grass_block>.getPossibleStates();

getRegistryName

Name: getRegistryName

Gets the registry name of this block.

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

ZenScript
 Copy
// Block.getRegistryName() as ResourceLocation

<block:minecraft:grass_block>.getRegistryName();

getSpeedFactor

Name: getSpeedFactor

Gets the speed factor of this Block.

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

ZenScript
 Copy
// Block.getSpeedFactor() as float

<block:minecraft:grass_block>.getSpeedFactor();

hasCollision

Name: hasCollision

Checks if entities can collide with this Block.

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

ZenScript
 Copy
// Block.hasCollision() as boolean

<block:minecraft:grass_block>.hasCollision();

hasDynamicShape

Name: hasDynamicShape

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

ZenScript
 Copy
// Block.hasDynamicShape() as boolean

<block:minecraft:grass_block>.hasDynamicShape();

isPossibleToRespawnInThis

Name: isPossibleToRespawnInThis

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

ZenScript
 Copy
// Block.isPossibleToRespawnInThis() as boolean

<block:minecraft:grass_block>.isPossibleToRespawnInThis();

matches

Name: matches

Checks whether this Block matches another Block.

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

ZenScript
 Copy
Block.matches(other as Block) as boolean

Parameter	Type	Description
Parameter other	Type Block	Description The other Block to check if this Block matches.

setExplosionResistance

Name: setExplosionResistance

Sets the blast resistance of this Block.

Return Type: void

ZenScript
 Copy
// Block.setExplosionResistance(resistance as float) as void

<block:minecraft:grass_block>.setExplosionResistance(2);

Parameter	Type	Description
Parameter resistance	Type float	Description The new blast resistance of this Block.

setHasCollision

Name: setHasCollision

Sets whether entities can collide with this Block.

Return Type: void

ZenScript
 Copy
// Block.setHasCollision(canCollide as boolean) as void

<block:minecraft:grass_block>.setHasCollision(true);

Parameter	Type	Description
Parameter canCollide	Type boolean	Description Can entities collide with this Block.

setJumpFactor

Name: setJumpFactor

Sets the jump factor of this Block.

Return Type: void

ZenScript
 Copy
// Block.setJumpFactor(jumpFactor as float) as void

<block:minecraft:grass_block>.setJumpFactor(2);

Parameter	Type	Description
Parameter jumpFactor	Type float	Description The new jump factor of this Block.

setMaterial

Name: setMaterial

Sets the material of this Block.

Return Type: void

ZenScript
 Copy
// Block.setMaterial(material as Material) as void

<block:minecraft:grass_block>.setMaterial(<blockmaterial:earth>);

Parameter	Type	Description
Parameter material	Type Material	Description The new material of this Block.

setSlipperiness

Name: setSlipperiness

Sets the friction of this Block.

Return Type: void

ZenScript
 Copy
// Block.setSlipperiness(friction as float) as void

<block:minecraft:grass_block>.setSlipperiness(2);

Parameter	Type	Description
Parameter friction	Type float	Description The new friction of this Block.

setSpeedFactor

Name: setSpeedFactor

Sets the speed factor of this Block.

Return Type: void

ZenScript
 Copy
// Block.setSpeedFactor(speedFactor as float) as void

<block:minecraft:grass_block>.setSpeedFactor(2);

Parameter	Type	Description
Parameter speedFactor	Type float	Description The new speed factor of this Block.

Properties

Name	Type	Has Getter	Has Setter	Description
Name canCollide	Type Block	Has Getter false	Has Setter true	Description Sets whether 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 BlockState	Has Getter true	Has Setter false	Description Gets the default BlockState of this Block.
Name dynamicShape	Type boolean	Has Getter true	Has Setter false	Description Checks if the opacity of this block is different in different areas of the Block.
Name explosionResistance	Type float	Has Getter true	Has Setter true	Description Gets the blast resistance of this Block.
Name friction	Type float	Has Getter true	Has Setter true	Description Gets the friction of this Block.
Name hasCollision	Type boolean	Has Getter true	Has Setter false	Description Checks if entities can collide with this Block.
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 Material	Has Getter true	Has Setter true	Description Gets the material of this Block.
Name registryName	Type ResourceLocation	Has Getter true	Has Setter false	Description Gets the registry name of this block.
Name speedFactor	Type float	Has Getter true	Has Setter true	Description Gets the speed factor of 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<BlockState>	Has Getter true	Has Setter false	Description Gets a list of valid BlockStates for this Block.