Item API

public function getTypeId() : int

// Example: Check item type
if($item->getTypeId() === ItemTypeIds::DIAMOND){
    $player->sendMessage("You have a diamond!");
}

public function getStateId() : int

public function getName() : string

public function getVanillaName() : string

public function getCount() : int

public function setCount(int $count) : Item

// Example: Set item count
$item->setCount(64);
$player->getInventory()->addItem($item);

public function pop(int $count = 1) : Item

// Example: Split item stack
$original = VanillaItems::DIAMOND()->setCount(64);
$popped = $original->pop(32); // $original now has 32, $popped has 32

public function getMaxStackSize() : int

public function isNull() : bool

public function hasCustomName() : bool

public function getCustomName() : string

public function setCustomName(string $name) : Item

// Example: Set custom name
$item = VanillaItems::DIAMOND_SWORD();
$item->setCustomName("Legendary Sword");
$player->getInventory()->addItem($item);

public function clearCustomName() : Item

public function getLore() : array

public function setLore(array $lines) : Item

// Example: Set item lore
$item = VanillaItems::DIAMOND_SWORD();
$item->setLore([
    "A powerful weapon",
    "Forged in ancient times",
    "Rarity: Legendary"
]);
$player->getInventory()->addItem($item);

public function hasNamedTag() : bool

public function getNamedTag() : CompoundTag

use pocketmine\nbt\tag\StringTag;

// Example: Set custom NBT data
$nbt = $item->getNamedTag();
$nbt->setString("CustomData", "some_value");
$item->setNamedTag($nbt);

// Example: Read custom NBT data
$nbt = $item->getNamedTag();
if($nbt->getTag("CustomData") instanceof StringTag){
    $value = $nbt->getString("CustomData");
}

public function setNamedTag(CompoundTag $tag) : Item

public function clearNamedTag() : Item

public function keepOnDeath() : bool

public function setKeepOnDeath(bool $keepOnDeath) : void

// Example: Make item persistent on death
$item = VanillaItems::COMPASS();
$item->setKeepOnDeath(true);
$player->getInventory()->addItem($item);

public function equals(Item $item, bool $checkDamage = true, bool $checkCompound = true) : bool

public function canStackWith(Item $other) : bool

// Example: Check if items can stack
if($item1->canStackWith($item2)){
    $combined = $item1->getCount() + $item2->getCount();
    $item1->setCount(min($combined, $item1->getMaxStackSize()));
}

public function canBePlaced() : bool

public function getBlock(?int $clickedFace = null) : Block

public function getAttackPoints() : int

public function getDefensePoints() : int

public function getBlockToolType() : int

public function getBlockToolHarvestLevel() : int

public function getMiningEfficiency(bool $isCorrectTool) : float

public function onInteractBlock(Player $player, Block $blockReplace, Block $blockClicked, int $face, Vector3 $clickVector, array &$returnedItems) : ItemUseResult

public function onClickAir(Player $player, Vector3 $directionVector, array &$returnedItems) : ItemUseResult

public function onReleaseUsing(Player $player, array &$returnedItems) : ItemUseResult

public function onDestroyBlock(Block $block, array &$returnedItems) : bool

public function onAttackEntity(Entity $victim, array &$returnedItems) : bool

public function hasEnchantment(Enchantment $enchantment, int $level = -1) : bool

use pocketmine\item\enchantment\VanillaEnchantments;

// Example: Check for enchantment
if($item->hasEnchantment(VanillaEnchantments::SHARPNESS())){
    $player->sendMessage("This weapon has Sharpness!");
}

public function getEnchantment(Enchantment $enchantment) : ?EnchantmentInstance

public function addEnchantment(EnchantmentInstance $enchantment) : Item

use pocketmine\item\enchantment\EnchantmentInstance;
use pocketmine\item\enchantment\VanillaEnchantments;

// Example: Add enchantment
$item = VanillaItems::DIAMOND_SWORD();
$item->addEnchantment(new EnchantmentInstance(VanillaEnchantments::SHARPNESS(), 5));
$item->addEnchantment(new EnchantmentInstance(VanillaEnchantments::UNBREAKING(), 3));
$player->getInventory()->addItem($item);

public function removeEnchantment(Enchantment $enchantment, int $level = -1) : Item

public function removeEnchantments() : Item

public function getEnchantments() : array

public function getFuelTime() : int

public function getFuelResidue() : Item

public function isFireProof() : bool

public function getCooldownTicks() : int

public function getCooldownTag() : ?string

use pocketmine\item\VanillaItems;

// Get item instances
$diamond = VanillaItems::DIAMOND();
$sword = VanillaItems::DIAMOND_SWORD();
$apple = VanillaItems::APPLE();
$arrow = VanillaItems::ARROW();

// Give items to players
$player->getInventory()->addItem(VanillaItems::DIAMOND()->setCount(64));

use pocketmine\item\VanillaItems;
use pocketmine\item\enchantment\EnchantmentInstance;
use pocketmine\item\enchantment\VanillaEnchantments;

public function createLegendarySword() : Item{
    $sword = VanillaItems::DIAMOND_SWORD();
    
    $sword->setCustomName("§6Excalibur");
    $sword->setLore([
        "§7A legendary blade",
        "§7forged by ancient smiths",
        "",
        "§9Sharpness X",
        "§9Unbreaking V"
    ]);
    
    $sword->addEnchantment(new EnchantmentInstance(VanillaEnchantments::SHARPNESS(), 10));
    $sword->addEnchantment(new EnchantmentInstance(VanillaEnchantments::UNBREAKING(), 5));
    
    // Add custom NBT
    $nbt = $sword->getNamedTag();
    $nbt->setString("ItemType", "legendary");
    $nbt->setInt("ItemLevel", 100);
    $sword->setNamedTag($nbt);
    
    return $sword;
}

use pocketmine\event\player\PlayerInteractEvent;

public function onInteract(PlayerInteractEvent $event) : void{
    $player = $event->getPlayer();
    $item = $event->getItem();
    
    // Check custom NBT
    $nbt = $item->getNamedTag();
    if($nbt->getTag("ItemType") !== null){
        $type = $nbt->getString("ItemType");
        if($type === "legendary"){
            $level = $nbt->getInt("ItemLevel", 1);
            $player->sendMessage("Legendary Item (Level $level)!");
        }
    }
}

use pocketmine\item\Durable;

if($item instanceof Durable){
    $damage = $item->getDamage();
    $maxDurability = $item->getMaxDurability();
    $remaining = $maxDurability - $damage;
    
    $player->sendMessage("Durability: $remaining / $maxDurability");
    
    // Damage the item
    $item->applyDamage(1);
}

use pocketmine\command\Command;
use pocketmine\command\CommandSender;
use pocketmine\player\Player;
use pocketmine\item\VanillaItems;

public function onCommand(CommandSender $sender, Command $command, string $label, array $args) : bool{
    if($command->getName() === "givekit"){
        if($sender instanceof Player){
            $sender->getInventory()->addItem(
                VanillaItems::DIAMOND_SWORD(),
                VanillaItems::DIAMOND_PICKAXE(),
                VanillaItems::DIAMOND_AXE(),
                VanillaItems::COOKED_BEEF()->setCount(64)
            );
            $sender->sendMessage("Kit received!");
            return true;
        }
    }
    return false;
}