Class BlockBeta

Readonly Betadimension

BetaisWaterlogged

Readonly Betalocation

Readonly Betapermutation

Readonly Betatype

Readonly BetatypeId

Readonly Betax

Readonly Betay

Readonly Betaz

canPlace

• canPlace(
      blockToPlace: BlockPermutation | BlockType,
      faceToPlaceOn?: Direction,
  ): boolean
  Beta

  Parameters

  • blockToPlace: BlockPermutation | BlockType

    Block type or block permutation to check placement for.
  • OptionalfaceToPlaceOn: Direction

    Optional specific face of this block to check placement against.

  Returns boolean

  Returns true if the block type or permutation can be placed on this block, else false.

  Remarks

  Checks to see whether it is valid to place the specified block type or block permutation, on a specified face on this block

  Throws

  This function can throw errors.

getComponent

• getComponent(componentName: string): any
  Beta

  Parameters

  • componentName: string

    Identifier of the component. If a namespace is not specified, minecraft: is assumed.

  Returns any

  Returns the component object if it is present on the particular block.

  Remarks

  Gets additional configuration properties (a component) for specific capabilities of particular blocks - for example, an inventory component of a chest block.

  Throws

  This function can throw errors.

getRedstonePower

• getRedstonePower(): undefined | number
  Beta

  Returns undefined | number

  Returns undefined if redstone power is not applicable to this block.

  Remarks

  Returns the net redstone power of this block.

  Throws

  This function can throw errors.

getTags

• getTags(): string[]
  Beta

  Returns string[]

  The list of tags that the block has.

  Remarks

  Returns a set of tags for a block.

  Throws

  This function can throw errors.

hasTag

• hasTag(tag: string): boolean
  Beta

  Parameters

  • tag: string

    Tag to check for.

  Returns boolean

  Returns true if the permutation of this block has the tag, else false.

  Remarks

  Checks to see if the permutation of this block has a specific tag.

  Throws

  This function can throw errors.

  Example: 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")}`);
  
  Copy

isAir

• isAir(): boolean
  Beta

  Returns boolean

isLiquid

• isLiquid(): boolean
  Beta

  Returns boolean

isSolid

• isSolid(): boolean
  Beta

  Returns boolean

setPermutation

• setPermutation(permutation: BlockPermutation): void
  Beta

  Parameters

  • permutation: BlockPermutation

    Permutation that contains a set of property states for the Block.

  Returns void

  Remarks

  Sets the block in the dimension to the state of the permutation.

  Throws

  This function can throw errors.

setType

• setType(blockType: BlockType): void
  Beta

  Parameters

  • blockType: BlockType

    Identifier of the type of block to apply - for example, minecraft:powered_repeater.

  Returns void

  Remarks

  Sets the type of block.

  Throws

  This function can throw errors.

trySetPermutation

• trySetPermutation(permutation: BlockPermutation): boolean
  Beta

  Parameters

  • permutation: BlockPermutation

    Permutation that contains a set of property states for the Block.

  Returns boolean

  Returns true if the block permutation data was successfully set, else false.

  Remarks

  Tries to set the block in the dimension to the state of the permutation by first checking if the placement is valid.

  Throws

  This function can throw errors.