MCBlockState
Link to mcblockstate
Importing the class
Link to 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 Copyimport crafttweaker.api.blocks.MCBlockState;
Casters
Link to casters
Result type | Is Implicit |
---|---|
Result type MCBlock | Is Implicit true |
Result type string | Is Implicit false |
Methods
Link to methods
Name: canBeReplacedByLeaves
Checks if this BlockState can be replaced by leaves in tree growth.
Return Type: boolean
ZenScript Copy// MCBlockState.canBeReplacedByLeaves(world as MCWorld, pos as BlockPos) as boolean
<blockstate:minecraft:grass>.canBeReplacedByLeaves(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState |
Name: canBeReplacedByLogs
Checks if this BlockState can be replaced by logs in tree growth.
Return Type: boolean
ZenScript Copy// MCBlockState.canBeReplacedByLogs(world as MCWorld, pos as BlockPos) as boolean
<blockstate:minecraft:grass>.canBeReplacedByLogs(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState |
Name: canConnectRedstone
Determines if Redstone can connect to this BlockState at the given position and (optional) side.
Returns: True if Redstone can connect to this BlockState. False otherwise.
Return Type: boolean
ZenScript CopyMCBlockState.canConnectRedstone(world as MCWorld, pos as BlockPos, side as Direction) as boolean
Parameter | Type | Description | Optional | DefaultValue |
---|---|---|---|---|
Parameter world | Type MCWorld | Description A world object. | Optional false | DefaultValue |
Parameter pos | Type BlockPos | Description The position of the BlockState. | Optional false | DefaultValue |
Parameter side | Type Direction | Description The side to check for. | Optional true | DefaultValue |
Name: canCreatureSpawn
Checks if a specific entity type can spawn on this BlockState at the position in the world.
Returns: True if the entity type can spawn. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.canCreatureSpawn(world as MCWorld, pos as BlockPos, type as PlacementType, entityType as MCEntityType) as boolean
<blockstate:minecraft:grass>.canCreatureSpawn(world, new BlockPos(1, 2, 3), PlacementType.IN_WATER, <entitytype:minecraft:pig>);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position in the world. |
Parameter type | Type PlacementType | Description The PlaceMentType to check for. |
Parameter entityType | Type MCEntityType | Description The EntityType to check for. |
Name: canDropFromExplosion
Checks if the BlockState will drop from the given explosion at the given position.
Returns: True if this BlockState will drop. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.canDropFromExplosion(world as MCWorld, pos as BlockPos, explosion as Explosion) as boolean
<blockstate:minecraft:grass>.canDropFromExplosion(world, new BlockPos(1, 2, 3), Explosiotn.create(world, 1, 2, 3, 5, true, ExplosionMode.BREAK));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter explosion | Type Explosion | Description The Explosion to check against. |
Name: canEntityDestroy
Determines if this BlockState can be destroyed by the Entity at the specific position.
Returns: True if the entity can destroy the BlockState. False otherwise.
Return Type: boolean
ZenScript CopyMCBlockState.canEntityDestroy(world as MCWorld, pos as BlockPos, entity as MCEntity) as boolean
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter entity | Type MCEntity | Description The Entity that is trying to destroy the BlockState. |
Name: canHarvestBlock
Checks whether the player can harvest the BlockState.
Returns: True if the player can harvest the block. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.canHarvestBlock(world as MCWorld, pos as BlockPos, player as MCPlayerEntity) as boolean
<blockstate:minecraft:grass>.canHarvestBlock(world, new BlockPos(1, 2, 3), player);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position to check at. |
Parameter player | Type MCPlayerEntity | Description The player that is trying to harvest the block. |
Name: canProvidePower
Checks whether this BlockState can provide Redstone Power
Returns: True if this BlockState can provide Redstone Power. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.canProvidePower() as boolean
<blockstate:minecraft:grass>.canProvidePower();
Name: canStickTo
Checks if this BlockState can stick to the other BlockState when pushed by a piston.
Returns: True if the BlockStatess stick when pushed by a piston. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.canStickTo(other as MCBlockState) as boolean
<blockstate:minecraft:grass>.canStickTo(<blockstate:minecraft:grass>);
Parameter | Type | Description |
---|---|---|
Parameter other | Type MCBlockState | Description The BlockState check if it will stick against. |
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// MCBlockState.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. |
Name: getBedDirection
Gets the direction of the bed. This can be called on any BlockState that has the HORIZONTAL_FACING
property, not just beds.
The game WILL crash if you call this on a blockstate that doesn't have the property, so make sure you check it before calling it!
Return Type: void
ZenScript Copy// MCBlockState.getBedDirection(world as MCWorld, pos as BlockPos) as void
<blockstate:minecraft:grass>.getBedDirection(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState |
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// MCBlockState.getCommandString() as string
<blockstate:minecraft:grass>.getCommandString();
Name: getExpDrop
Returns how much Experience this BlockState will drop when broken.
Returns: The amount of Experience that will drop when this BlockState is broken.
Return Type: int
ZenScript Copy// MCBlockState.getExpDrop(world as MCWorld, pos as BlockPos, fortune as int, silktouch as int) as int
<blockstate:minecraft:grass>.getExpDrop(world, new BlockPos(1, 2, 3), 1, 0);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter fortune | Type int | Description The fortune level of the tool being used to break the block. |
Parameter silktouch | Type int | Description The silktouch level of the tool being used to break the block. This will most likely either be 0 or 1. |
Name: getExplosionResistance
Gets the explosion resistance of the BlockState in the world for the given Explosion
Returns: The amount of the explosion that is absorbed.
Return Type: float
ZenScript Copy// MCBlockState.getExplosionResistance(world as MCWorld, pos as BlockPos, explosion as Explosion) as float
<blockstate:minecraft:grass>.getExplosionResistance(world, new BlockPos(1, 2, 3), Explosiotn.create(world, 1, 2, 3, 5, true, ExplosionMode.BREAK));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState |
Parameter explosion | Type Explosion | Description The explosion object to check against. |
Name: getFireSpreadSpeed
Determines how fast fire spreads from this block. The higher the number the faster that fire will spread around the BlockState.
Returns: The spread speed of the BlockState.
Return Type: int
ZenScript CopyMCBlockState.getFireSpreadSpeed(world as MCWorld, pos as BlockPos, face as Direction) as int
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter face | Type Direction | Description The face that the fire is coming from. |
Name: getFlammability
Gets the chance that fire will spread and consume this BlockState.
Values range from 0 - 300.
A value of 300 is a 100% chance, and 0 is a 0% chance.
Returns: A number between 0 and 300 dictating how flammable this BlockState is.
Return Type: int
ZenScript Copy// MCBlockState.getFlammability(world as MCWorld, pos as BlockPos, face as Direction) as int
<blockstate:minecraft:grass>.getFlammability(world, new BlockPos(1, 2, 3), Direction.south);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter face | Type Direction | Description The face that the fire is coming from. |
Name: getHardness
Gets the hardness of this BlockState.
Returns: The hardness of this BlockState.
Return Type: float
ZenScript Copy// MCBlockState.getHardness() as float
<blockstate:minecraft:grass>.getHardness();
Name: getHarvestLevel
Gets the harvest level of this BlockState.
Returns: The harvest level of this BlockState.
Return Type: int
ZenScript Copy// MCBlockState.getHarvestLevel() as int
<blockstate:minecraft:grass>.getHarvestLevel();
Name: getLightLevel
Gets the light level of this BlockState
Returns: The light level of this BlockState.
Return Type: int
ZenScript Copy// MCBlockState.getLightLevel() as int
<blockstate:minecraft:grass>.getLightLevel();
Name: getLightValue
Gets the light value of the BlockState at the given position.
Returns: The light value of the BlockState at the position.
Return Type: int
ZenScript Copy// MCBlockState.getLightValue(world as MCWorld, pos as BlockPos) as int
<blockstate:minecraft:grass>.getLightValue(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world Object. |
Parameter pos | Type BlockPos | Description The position to check the light value of. |
Name: getProperties
Gets the properties of this BlockState.
Returns: a Map of the properties on this BlockState.
Return Type: string[string]
ZenScript Copy// MCBlockState.getProperties() as string[string]
<blockstate:minecraft:grass>.getProperties();
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// MCBlockState.getPropertyNames() as stdlib.List<string>
<blockstate:minecraft:grass>.getPropertyNames();
Name: getPropertyValue
Gets the value of the given property.
Returns: The value of the property on this BlockState.
Return Type: string
ZenScript CopyMCBlockState.getPropertyValue(name as string) as string
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description "snowy" |
Name: getSlipperiness
Gets the slipperiness of the BlockState at the given location for the given entity (if one is given)
Returns: The slipperiness of the BlockState at the given BlockPos for the Entity.
Return Type: float
ZenScript Copy// MCBlockState.getSlipperiness(world as MCWorld, pos as BlockPos, entity as MCEntity) as float
<blockstate:minecraft:grass>.getSlipperiness(world, new Blockpos(0,0,0);, entity);
Parameter | Type | Description | Optional | DefaultValue |
---|---|---|---|---|
Parameter world | Type MCWorld | Description A world object. | Optional false | DefaultValue |
Parameter pos | Type BlockPos | Description The position to check at. | Optional false | DefaultValue |
Parameter entity | Type MCEntity | Description The entity to work with. | Optional true | DefaultValue |
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// MCBlockState.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. |
Name: hasTileEntity
Checks whether this BlockState has a MCTileEntity.
Returns: True if this BlockState has a MCTileEntity. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.hasTileEntity() as boolean
<blockstate:minecraft:grass>.hasTileEntity();
Name: isBed
Determines if the block can be used to sleep.
Returns: True if the block allows sleeping.
Return Type: boolean
ZenScript Copy// MCBlockState.isBed(world as MCWorld, pos as BlockPos, sleeper as MCLivingEntity) as boolean
<blockstate:minecraft:grass>.isBed(world, new BlockPos(1, 2, 3), entity);
Parameter | Type | Description | Optional | DefaultValue |
---|---|---|---|---|
Parameter world | Type MCWorld | Description A world object. | Optional false | DefaultValue |
Parameter pos | Type BlockPos | Description The position to check at. | Optional false | DefaultValue |
Parameter sleeper | Type MCLivingEntity | Description The Living Entity that is trying to sleep. | Optional true | DefaultValue |
Name: isBurning
Checks if the BlockState is burning at the given position.
Returns: True if the BlockState is burning a the given position.
Return Type: boolean
ZenScript Copy// MCBlockState.isBurning(world as MCWorld, pos as BlockPos) as boolean
<blockstate:minecraft:grass>.isBurning(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Name: isConduitFrame
Determines if this BlockState can be used as the frame of a Conduit.
Returns: True if this BlockState can be used as a Conduit frame.
Return Type: boolean
ZenScript Copy// MCBlockState.isConduitFrame(world as MCWorld, pos as BlockPos, conduitPosition as BlockPos) as boolean
<blockstate:minecraft:grass>.isConduitFrame(world, new BlockPos(1, 2, 3), new BlockPos(1, 5, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter conduitPosition | Type BlockPos | Description The Position of the Conduit. |
Name: isFertile
Checks if the BlockState is "fertile" at the given position.
This will only ever return true
if the BlockState is in the <tag:blocks:minecraft:farmland>
tag and if it has the moisture
state.
The game WILL crash if you call this on a blockstate that doesn't have the property, so make sure you check it before calling it!
Returns: True if the BlockState is Fertile. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isFertile(world as MCWorld, pos as BlockPos) as boolean
<blockstate:minecraft:grass>.isFertile(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState |
Name: isFireSource
Checks if this BlockState is a fire source at the given position with the fire coming from the given direciton.
Returns: True if this BlockState is a fire source. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isFireSource(world as MCWorld, pos as BlockPos, side as Direction) as boolean
<blockstate:minecraft:grass>.isFireSource(world, new BlockPos(1, 2, 3), Direction.east);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter side | Type Direction | Description The face that the fire is coming form. |
Name: isFlammable
Checks if this BlockState is flammable at the given position with the fire coming from the given direciton.
Returns: True if the BlockState if flammable. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isFlammable(world as MCWorld, pos as BlockPos, face as Direction) as boolean
<blockstate:minecraft:grass>.isFlammable(world, new BlockPos(1, 2, 3), Direction.east);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter face | Type Direction | Description The face that the fire is coming from. |
Name: isLadder
Checks if a Living Entity can use this block to climb like a ladder.
Returns: True if the entity can climb the block. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isLadder(world as MCWorld, pos as BlockPos, entity as MCLivingEntity) as boolean
<blockstate:minecraft:grass>.isLadder(world, new BlockPos(1, 2, 3), entity);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position to check at. |
Parameter entity | Type MCLivingEntity | Description The entity that wants to climb the block. |
Name: isPortalFrame
Determins if this BlockState can be used as the frame of a Nether portal.
Returns: True if this BlockState can be used as a Nether portal frame. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isPortalFrame(world as MCWorld, pos as BlockPos) as boolean
<blockstate:minecraft:grass>.isPortalFrame(world, new BlockPos(1, 2, 3));
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the Blockstate. |
Name: isScaffolding
Checks if the entity should handle movement on this BlockState like it handles movement on scaffolding.
Returns: True if this BlockState should act like scaffolding. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isScaffolding(entity as MCLivingEntity) as boolean
<blockstate:minecraft:grass>.isScaffolding(entity);
Parameter | Type | Description |
---|---|---|
Parameter entity | Type MCLivingEntity | Description The entity that is being checked against. |
Name: isSlime
Checks if this BlockState is a Slime Block.
Returns: True if this BlockState is Slime. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isSlime() as boolean
<blockstate:minecraft:grass>.isSlime();
Name: isSolid
Checks whether this BlockState is solid.
Returns: True if this BlockState is solid. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isSolid() as boolean
<blockstate:minecraft:grass>.isSolid();
Name: isSticky
Checks if this BlockState is sticky.
This is used to determine if the block should pull or push adjacent blocks when pushed / pulled by a piston. For example, Slime Blocks are sticky blocks.
Returns: True if this BlockState is Sticky. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.isSticky() as boolean
<blockstate:minecraft:grass>.isSticky();
Name: isToolEffective
Checks if the given ToolType is effective against this BlockState.
Returns: True if the ToolType is effective. False otherwise.
Return Type: boolean
ZenScript CopyMCBlockState.isToolEffective(tool as ToolType) as boolean
Parameter | Type | Description |
---|---|---|
Parameter tool | Type ToolType | Description The ToolType to check for. |
Name: setBedOccupied
Marks the block as "occupied", this is only supported on blocks that have the "occupied" BlockState property.
The game WILL crash if you call this on a blockstate that doesn't have the property, so make sure you check it before calling it!
Return Type: void
ZenScript Copy// MCBlockState.setBedOccupied(world as MCWorld, pos as BlockPos, sleeper as MCLivingEntity, occupied as boolean) as void
<blockstate:minecraft:grass>.setBedOccupied(world, new BlockPos(1, 2, 3), livingEntity, true);
Parameter | Type | Description |
---|---|---|
Parameter world | Type MCWorld | Description A world object. |
Parameter pos | Type BlockPos | Description The position of the BlockState. |
Parameter sleeper | Type MCLivingEntity | Description The LivingEntity that is occupying the bed. |
Parameter occupied | Type boolean | Description If the bed is occupied or not. |
Name: setHardness
Sets the hardness of this BlockState.
Return Type: void
ZenScript Copy// MCBlockState.setHardness(hardness as float) as void
<blockstate:minecraft:grass>.setHardness(2.4f);
Parameter | Type | Description |
---|---|---|
Parameter hardness | Type float | Description the new hardness of this BlockState |
Name: ticksRandomly
Checks whether this BlockState ticks randomly.
Returns: True if this BlockState ticks randomly. False otherwise.
Return Type: boolean
ZenScript Copy// MCBlockState.ticksRandomly() as boolean
<blockstate:minecraft:grass>.ticksRandomly();
Name: withProperty
Sets a block property based on it's name.
Returns: This BlockState with the new property value.
Return Type: MCBlockState
ZenScript Copy// MCBlockState.withProperty(name as string, value as string) as MCBlockState
<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
Link to properties
Name | Type | Has Getter | Has Setter | Description |
---|---|---|---|---|
Name block | Type MCBlock | Has Getter true | Has Setter false | Description Gets the base MCBlock of this BlockState. The MCBlock will not contain any of the properties of this BlockState. |
Name canProvidePower | Type boolean | Has Getter true | Has Setter false | Description Checks whether this BlockState can provide Redstone Power |
Name commandString | Type string | Has Getter true | Has Setter false | Description Gets the blockstate bracket handler syntax for this BlockState. E.G. |
Name hardness | Type float | Has Getter true | Has Setter true | Description Gets the hardness of this BlockState. |
Name harvestLevel | Type int | Has Getter true | Has Setter false | Description Gets the harvest level of this BlockState. |
Name harvestTool | Type ToolType? | Has Getter true | Has Setter false | Description Gets the ToolType of this BlockState. |
Name hasTileEntity | Type boolean | Has Getter true | Has Setter false | Description Checks whether this BlockState has a MCTileEntity. |
Name isSlime | Type boolean | Has Getter true | Has Setter false | Description Checks if this BlockState is a Slime Block. |
Name isSolid | Type boolean | Has Getter true | Has Setter false | Description Checks whether this BlockState is solid. |
Name isSticky | Type boolean | Has Getter true | Has Setter false | Description Checks if this BlockState is sticky. This is used to determine if the block should pull or push adjacent blocks when pushed / pulled by a piston. For example, Slime Blocks are sticky blocks. |
Name lightLevel | Type int | Has Getter true | Has Setter false | Description Gets the light level 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 ticksRandomly | Type boolean | Has Getter true | Has Setter false | Description Checks whether this BlockState ticks randomly. |