Block API

public function getTypeId() : int

// Example: Check block type
if($block->getTypeId() === BlockTypeIds::STONE){
    $player->sendMessage("This is stone!");
}

public function getStateId() : int

public function getName() : string

// Example: Display block name
$player->sendMessage("You're looking at: " . $block->getName());

public function getPosition() : Position

// Example: Get block position
$pos = $block->getPosition();
$player->sendMessage("Block at: {$pos->x}, {$pos->y}, {$pos->z}");

public function hasSameTypeId(Block $other) : bool

public function isSameState(Block $other) : bool

public function asItem() : Item

// Example: Give player block as item
$item = $block->asItem();
$player->getInventory()->addItem($item);

public function canBePlaced() : bool

public function canBeReplaced() : bool

public function canBePlacedAt(Block $blockReplace, Vector3 $clickVector, int $face, bool $isClickedBlock) : bool

public function place(BlockTransaction $tx, Item $item, Block $blockReplace, Block $blockClicked, int $face, Vector3 $clickVector, ?Player $player = null) : bool

public function onPostPlace() : void

public function onBreak(Item $item, ?Player $player = null, array &$returnedItems = []) : bool

public function getBreakInfo() : BlockBreakInfo

// Example: Check break info
$breakInfo = $block->getBreakInfo();
$hardness = $breakInfo->getHardness();
$toolType = $breakInfo->getToolType();

public function getDrops(Item $item) : array

// Example: Get block drops
$drops = $block->getDrops($item);
foreach($drops as $drop){
    $player->sendMessage("Drops: " . $drop->getName());
}

public function getDropsForCompatibleTool(Item $item) : array

public function getDropsForIncompatibleTool(Item $item) : array

public function getSilkTouchDrops(Item $item) : array

public function getXpDropForTool(Item $item) : int

public function isAffectedBySilkTouch() : bool

public function onInteract(Item $item, int $face, Vector3 $clickVector, ?Player $player = null, array &$returnedItems = []) : bool

public function onAttack(Item $item, int $face, ?Player $player = null) : bool

public function onNearbyBlockChange() : void

public function ticksRandomly() : bool

public function onRandomTick() : void

public function onScheduledUpdate() : void

public function getLightLevel() : int

public function getLightFilter() : int

public function blocksDirectSkyLight() : bool

public function isTransparent() : bool

public function isSolid() : bool

public function getFrictionFactor() : float

public function canBeFlowedInto() : bool

public function canClimb() : bool

public function hasTypeTag(string $tag) : bool

use pocketmine\block\BlockTypeTags;

// Example: Check if block is dirt-like
if($block->hasTypeTag(BlockTypeTags::DIRT)){
    $player->sendMessage("This is dirt-like!");
}

public function getTypeTags() : array

use pocketmine\block\VanillaBlocks;

// Get block instances
$stone = VanillaBlocks::STONE();
$grass = VanillaBlocks::GRASS();
$oakLog = VanillaBlocks::OAK_LOG();
$diamond = VanillaBlocks::DIAMOND_BLOCK();
$air = VanillaBlocks::AIR();

// Place blocks
$world->setBlock($pos, VanillaBlocks::STONE());
$world->setBlock($pos->add(1, 0, 0), VanillaBlocks::GRASS());

use pocketmine\block\BlockTypeIds;

// Compare block types
if($block->getTypeId() === BlockTypeIds::STONE){
    // This is stone
}

if($block->getTypeId() === BlockTypeIds::GRASS){
    // This is grass
}

use pocketmine\block\BlockTypeIds;
use pocketmine\block\VanillaBlocks;

// Method 1: Using type ID
if($block->getTypeId() === BlockTypeIds::STONE){
    $player->sendMessage("This is stone!");
}

// Method 2: Using hasSameTypeId
if($block->hasSameTypeId(VanillaBlocks::STONE())){
    $player->sendMessage("This is stone!");
}

// Method 3: Using instanceof (for specific block classes)
use pocketmine\block\Chest;

if($block instanceof Chest){
    $player->sendMessage("This is a chest!");
}

use pocketmine\event\block\BlockPlaceEvent;
use pocketmine\block\VanillaBlocks;

public function onBlockPlace(BlockPlaceEvent $event) : void{
    $player = $event->getPlayer();
    $block = $event->getBlock();
    
    // Prevent placing certain blocks
    if($block->hasSameTypeId(VanillaBlocks::TNT())){
        $event->cancel();
        $player->sendMessage("You cannot place TNT here!");
    }
}

use pocketmine\block\Door;
use pocketmine\math\Facing;

// Example: Working with doors
$door = VanillaBlocks::OAK_DOOR();
if($door instanceof Door){
    $door->setFacing(Facing::NORTH);
    $door->setOpen(true);
    $world->setBlock($pos, $door);
}

use pocketmine\block\tile\Chest;

// Example: Access chest inventory
$tile = $world->getTile($pos);
if($tile instanceof Chest){
    $inventory = $tile->getInventory();
    foreach($inventory->getContents() as $item){
        $player->sendMessage("Item: " . $item->getName());
    }
}

use pocketmine\math\Vector3;
use pocketmine\block\VanillaBlocks;

public function fill(World $world, Vector3 $pos1, Vector3 $pos2, Block $block) : void{
    $minX = (int) min($pos1->x, $pos2->x);
    $maxX = (int) max($pos1->x, $pos2->x);
    $minY = (int) min($pos1->y, $pos2->y);
    $maxY = (int) max($pos1->y, $pos2->y);
    $minZ = (int) min($pos1->z, $pos2->z);
    $maxZ = (int) max($pos1->z, $pos2->z);
    
    for($x = $minX; $x <= $maxX; $x++){
        for($y = $minY; $y <= $maxY; $y++){
            for($z = $minZ; $z <= $maxZ; $z++){
                $world->setBlock(new Vector3($x, $y, $z), $block);
            }
        }
    }
}

// Usage
$this->fill(
    $world,
    new Vector3(0, 64, 0),
    new Vector3(10, 74, 10),
    VanillaBlocks::GLASS()
);