Beta
Readonly
Beta
dimensionReadonly
Beta
isReadonly
Beta
isReadonly
Beta
isReadonly
Beta
isReadonly
Beta
isReadonly
Beta
locationReadonly
Beta
permutationReadonly
Beta
typeReadonly
Beta
typeReadonly
Beta
xReadonly
Beta
yReadonly
Beta
zBeta
The type of liquid this function should be called for.
Whether this block is removed when touched by liquid.
Beta
The type of liquid this function should be called for.
Whether this block can have a liquid placed over it.
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
.
Beta
The identifier of the component (e.g., 'minecraft:inventory'). If no namespace prefix is specified, 'minecraft:' is assumed. Available component IDs can be found as part of the BlockComponentTypes enum.
Returns the component if it exists on the block, otherwise undefined.
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.
An itemStack with the specified amount of items and data. Returns undefined if block type is incompatible.
Beta
Tag to check for.
Returns true
if the permutation of this block has the tag,
else false
.
import { DimensionLocation } from "@minecraft/server";
function checkBlockTags(log: (message: string, status?: number) => void, targetLocation: DimensionLocation) {
// Fetch the block
const block = targetLocation.dimension.getBlock(targetLocation);
// check that the block is loaded
if (block) {
log(`Block is dirt: ${block.hasTag("dirt")}`);
log(`Block is wood: ${block.hasTag("wood")}`);
log(`Block is stone: ${block.hasTag("stone")}`);
}
}
Beta
The type of liquid this function should be called for.
Whether this block stops liquid from flowing.
Beta
Whether liquid can flow into the block from the provided direction, or flow out from the provided direction when liquid is placed into it with a bucket
Beta
The type of liquid this function should be called for.
Whether this block is removed and spawns its item when touched by liquid.
Beta
Block type identifier to match this API against.
Optional
states: Record<string, string | number | boolean>Optional set of block states to test this block against.
Returns true if the block matches the specified criteria.
Beta
Permutation that contains a set of property states for the Block.
Beta
Identifier of the type of block to apply - for example, minecraft:powered_repeater.
Beta
true if the block should have water within it.
Beta
Permutation that contains a set of property states for the Block.
Returns true
if the block permutation data was
successfully set, else false
.
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.