BlockState - CraftTweaker Documentation

Version:

Language:

Home Commands Examples Getting Started With Scripts Global Keywords

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.BlockState;

Casters

Result Type	Is Implicit
Result Type Block	Is Implicit true
Result Type BlockIngredient	Is Implicit true
Result Type string	Is Implicit false

Methods

asString

Name: asString

Return Type: string

ZenScript
 Copy
// BlockState.asString() as string

<blockstate:minecraft:grass>.asString();

canOcclude

Name: canOcclude

Checks whether this BlockState is solid.

Returns: True if this BlockState is solid. False otherwise.
Return Type: boolean

ZenScript
 Copy
// BlockState.canOcclude() as boolean

<blockstate:minecraft:grass>.canOcclude();

getAllowedValuesForProperty

Name: getAllowedValuesForProperty

Gets a list of allowed values for a given property.

Returns: a List of allowed values.
Return Type: stdlib.List<string>

ZenScript
 Copy
// BlockState.getAllowedValuesForProperty(name as string) as stdlib.List<string>

<blockstate:minecraft:grass>.getAllowedValuesForProperty("snowy");

Parameter	Type	Description
Parameter name	Type string	Description The name of the property to find the allowed values for.

getCommandString

Name: getCommandString

Gets the blockstate bracket handler syntax for this BlockState.

E.G. <blockstate:minecraft:grass:snowy=true>

Returns: The blockstate bracket handler syntax for this BlockState.
Return Type: string

ZenScript
 Copy
// BlockState.getCommandString() as string

<blockstate:minecraft:grass>.getCommandString();

getDestroySpeed

Name: getDestroySpeed

Gets the hardness of this BlockState.

Returns: The hardness of this BlockState.
Return Type: float

ZenScript
 Copy
// BlockState.getDestroySpeed() as float

<blockstate:minecraft:grass>.getDestroySpeed();

getLightEmission

Name: getLightEmission

Gets the light level of this BlockState

Returns: The light level of this BlockState.
Return Type: int

ZenScript
 Copy
// BlockState.getLightEmission() as int

<blockstate:minecraft:grass>.getLightEmission();

getProperties

Name: getProperties

Gets the properties of this BlockState.

Returns: a Map of the properties on this BlockState.
Return Type: string[string]

ZenScript
 Copy
// BlockState.getProperties() as string[string]

<blockstate:minecraft:grass>.getProperties();

getPropertyNames

Name: getPropertyNames

Gets the names of the properties of this BlockState.

Returns: the List of the names of the BlockStates's properties.
Return Type: stdlib.List<string>

ZenScript
 Copy
// BlockState.getPropertyNames() as stdlib.List<string>

<blockstate:minecraft:grass>.getPropertyNames();

getPropertyValue

Name: getPropertyValue

Gets the value of the given property.

Returns: The value of the property on this BlockState.
Return Type: string

ZenScript
 Copy
BlockState.getPropertyValue(name as string) as string

Parameter	Type	Description
Parameter name	Type string	Description "snowy"

getSoundType

Name: getSoundType

Return Type: SoundType

ZenScript
 Copy
// BlockState.getSoundType() as SoundType

<blockstate:minecraft:grass>.getSoundType();

hasBlockEntity

Name: hasBlockEntity

Checks whether this BlockState has a BlockEntity.

Returns: True if this BlockState has a BlockEntity. False otherwise.
Return Type: boolean

ZenScript
 Copy
// BlockState.hasBlockEntity() as boolean

<blockstate:minecraft:grass>.hasBlockEntity();

hasProperty

Name: hasProperty

Checks whether this BlockState has the given property.

Returns: True if this BlockState has the property. False otherwise.
Return Type: boolean

ZenScript
 Copy
// BlockState.hasProperty(name as string) as boolean

<blockstate:minecraft:grass>.hasProperty("snowy");

Parameter	Type	Description
Parameter name	Type string	Description the name of the property to check.

isRandomlyTicking

Name: isRandomlyTicking

Checks whether this BlockState ticks randomly.

Returns: True if this BlockState ticks randomly. False otherwise.
Return Type: boolean

ZenScript
 Copy
// BlockState.isRandomlyTicking() as boolean

<blockstate:minecraft:grass>.isRandomlyTicking();

isSignalSource

Name: isSignalSource

Checks whether this BlockState can provide Redstone Power

Returns: True if this BlockState can provide Redstone Power. False otherwise.
Return Type: boolean

ZenScript
 Copy
// BlockState.isSignalSource() as boolean

<blockstate:minecraft:grass>.isSignalSource();

rotate

Name: rotate

Return Type: BlockState

ZenScript
 Copy
BlockState.rotate(rotation as Rotation) as BlockState

Parameter	Type
Parameter rotation	Type Rotation

setDestroySpeed

Name: setDestroySpeed

Sets the destroy speed of this BlockState.

ZenScript
 Copy
// BlockState.setDestroySpeed(destroySpeed as float)

<blockstate:minecraft:grass>.setDestroySpeed(2.4f);

Parameter	Type	Description
Parameter destroySpeed	Type float	Description the new destroy speed of this BlockState

withProperty

Name: withProperty

Sets a block property based on it's name.

Returns: This BlockState with the new property value.
Return Type: BlockState

ZenScript
 Copy
// BlockState.withProperty(name as string, value as string) as BlockState

<blockstate:minecraft:grass>.withProperty("snowy", "true");

Parameter	Type	Description
Parameter name	Type string	Description The name of the property to set.
Parameter value	Type string	Description The new value of the property.

Properties

Name	Type	Has Getter	Has Setter	Description
Name block	Type Block	Has Getter true	Has Setter false	Description Gets the base Block of this BlockState. The Block will not contain any of the properties of this BlockState.
Name canOcclude	Type boolean	Has Getter true	Has Setter false	Description Checks whether this BlockState is solid.
Name commandString	Type string	Has Getter true	Has Setter false	Description Gets the blockstate bracket handler syntax for this BlockState. E.G. `<blockstate:minecraft:grass:snowy=true>`
Name destroySpeed	Type float	Has Getter true	Has Setter true	Description Gets the hardness of this BlockState.
Name hasBlockEntity	Type boolean	Has Getter true	Has Setter false	Description Checks whether this BlockState has a BlockEntity.
Name isRandomlyTicking	Type boolean	Has Getter true	Has Setter false	Description Checks whether this BlockState ticks randomly.
Name isSignalSource	Type boolean	Has Getter true	Has Setter false	Description Checks whether this BlockState can provide Redstone Power
Name lightEmission	Type int	Has Getter true	Has Setter false	Description Gets the light level of this BlockState
Name properties	Type string[string]	Has Getter true	Has Setter false	Description Gets the properties of this BlockState.
Name propertyNames	Type stdlib.List<string>	Has Getter true	Has Setter false	Description Gets the names of the properties of this BlockState.
Name soundType	Type SoundType	Has Getter true	Has Setter false	Description