Beta Protected constructorReadonly dimensionReturns the dimension that the block is within.
Beta isReturns or sets whether this block has a liquid on it.
This property can't be edited in read-only mode.
Readonly locationCoordinates of the specified block.
This property can throw when used.
Readonly permutationAdditional block configuration data that describes the block.
This property can throw when used.
Readonly Beta typeGets the type of block.
This property can throw when used.
Readonly Beta typeIdentifier of the type of block for this block.
This property can throw when used.
Readonly xX coordinate of the block.
Readonly yY coordinate of the block.
Readonly zZ coordinate of the block.
Beta
Block type or block permutation to check placement for.
Optional faceToPlaceOn: DirectionOptional specific face of this block to check placement against.
Returns true if the block type or permutation can be
placed on this block, else false.
Checks to see whether it is valid to place the specified block type or block permutation, on a specified face on this block
This function can throw errors.
Beta
Identifier of the component. If a namespace is not specified, minecraft: is assumed.
Returns the component object if it is present on the particular block.
Gets additional configuration properties (a component) for specific capabilities of particular blocks - for example, an inventory component of a chest block.
This function can throw errors.
Beta
Optional amount: numberNumber of instances of this block to place in the item stack.
Optional withData: booleanWhether additional data facets of the item stack are included.
Creates a prototype item stack based on this block that can be used with Container/ContainerSlot APIs.
Beta
Tag to check for.
Returns true if the permutation of this block has the tag,
else false.
Checks to see if the permutation of this block has a specific tag.
This function can throw errors.
check_block_tags.js
import { world } from "@minecraft/server";
// Fetch the block
const block = world.getDimension("overworld").getBlock({ x: 1, y: 2, z: 3 });
console.log(`Block is dirt: ${block.hasTag("dirt")}`);
console.log(`Block is wood: ${block.hasTag("wood")}`);
console.log(`Block is stone: ${block.hasTag("stone")}`);
Permutation that contains a set of property states for the Block.
Sets the block in the dimension to the state of the permutation.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Identifier of the type of block to apply - for example, minecraft:powered_repeater.
Sets the type of block.
This function can't be called in read-only mode.
This function can throw errors.
Beta
Permutation that contains a set of property states for the Block.
Returns true if the block permutation data was
successfully set, else false.
Tries to set the block in the dimension to the state of the permutation by first checking if the placement is valid.
This function can't be called in read-only mode.
This function can throw errors.
Represents a block in a dimension. A block represents a unique X, Y, and Z within a dimension and get/sets the state of the block at that location. This type was significantly updated in version 1.17.10.21.