Entity API

public function getId() : int

// Example: Store entity ID for later reference
$entityId = $entity->getId();
// Later: Find entity by ID
$foundEntity = $world->getEntity($entityId);

public function getLocation() : Location

// Example: Get entity position
$location = $entity->getLocation();
$player->sendMessage("Entity at: {$location->x}, {$location->y}, {$location->z}");

public function getPosition() : Position

public function getWorld() : World

public function teleport(Vector3|Position|Location $pos, ?float $yaw = null, ?float $pitch = null) : bool

// Example: Teleport entity
$entity->teleport(new Vector3(100, 64, 100));

// Teleport with rotation
$entity->teleport($targetPos, 90.0, 0.0);

// Teleport to another world
$otherWorld = $server->getWorldManager()->getWorldByName("world_nether");
if($otherWorld !== null){
    $entity->teleport(new Position(0, 64, 0, $otherWorld));
}

public function getMotion() : Vector3

public function setMotion(Vector3 $motion) : bool

// Example: Launch entity upward
$entity->setMotion(new Vector3(0, 2, 0));

// Example: Push entity horizontally
$entity->setMotion(new Vector3(1, 0, 1));

public function addMotion(float $x, float $y, float $z) : void

// Example: Apply knockback
$entity->addMotion(0, 0.5, 0);

public function getHealth() : float

public function setHealth(float $amount) : void

// Example: Heal entity to full health
$entity->setHealth($entity->getMaxHealth());

// Example: Set specific health
$entity->setHealth(10.0);

public function getMaxHealth() : int

public function setMaxHealth(int $amount) : void

public function isAlive() : bool

public function attack(EntityDamageEvent $source) : void

use pocketmine\event\entity\EntityDamageEvent;

// Example: Deal custom damage
$damage = new EntityDamageEvent($entity, EntityDamageEvent::CAUSE_CUSTOM, 5.0);
$entity->attack($damage);

public function heal(EntityRegainHealthEvent $source) : void

public function kill() : void

// Example: Kill entity
if($entity->isAlive()){
    $entity->kill();
}

public function getLastDamageCause() : ?EntityDamageEvent

public function getNameTag() : string

public function setNameTag(string $name) : void

// Example: Set custom name tag
$entity->setNameTag("§6Boss Monster");
$entity->setNameTagVisible(true);
$entity->setNameTagAlwaysVisible(true);

public function isNameTagVisible() : bool

public function setNameTagVisible(bool $value = true) : void

public function isNameTagAlwaysVisible() : bool

public function setNameTagAlwaysVisible(bool $value = true) : void

public function getScale() : float

public function setScale(float $value) : void

// Example: Make entity twice as large
$entity->setScale(2.0);

// Example: Make entity half size
$entity->setScale(0.5);

public function getSize() : EntitySizeInfo

public function getBoundingBox() : AxisAlignedBB

public function isOnFire() : bool

public function setOnFire(int $seconds) : void

// Example: Set entity on fire for 5 seconds
$entity->setOnFire(5);

public function getFireTicks() : int

public function setFireTicks(int $ticks) : void

public function extinguish() : void

// Example: Put out fire
if($entity->isOnFire()){
    $entity->extinguish();
}

public function isInvisible() : bool

public function setInvisible(bool $value = true) : void

// Example: Make entity invisible
$entity->setInvisible(true);

public function isSilent() : bool

public function setSilent(bool $value = true) : void

public function canClimb() : bool

public function setCanClimb(bool $value = true) : void

public function getOwningEntity() : ?Entity

public function setOwningEntity(?Entity $owner) : void

// Example: Set projectile owner
use pocketmine\entity\projectile\Arrow;

if($arrow instanceof Arrow){
    $arrow->setOwningEntity($player);
}

public function getTargetEntity() : ?Entity

public function setTargetEntity(?Entity $target) : void

public function close() : void

// Example: Remove entity
if($entity->isAlive()){
    $entity->close();
}

public function isClosed() : bool

public function isFlaggedForDespawn() : bool

public function flagForDespawn() : void

public function canSaveWithChunk() : bool

public function setCanSaveWithChunk(bool $value) : void

public function saveNBT() : CompoundTag

public function getEffects() : EffectManager

use pocketmine\entity\effect\VanillaEffects;
use pocketmine\entity\effect\EffectInstance;

// Example: Apply potion effect
$effect = new EffectInstance(VanillaEffects::SPEED(), 20 * 60, 1); // 1 minute, level 2
$entity->getEffects()->add($effect);

public function hasLineOfSight(Entity $entity) : bool

public function getArmorInventory() : ArmorInventory

public function getInventory() : PlayerInventory

public function getSkin() : Skin

public function setSkin(Skin $skin) : void

public static function getInstance() : EntityFactory

public function register(string $className, callable $creationFunc, array $saveNames) : void

use pocketmine\entity\EntityFactory;
use pocketmine\entity\EntityDataHelper;
use pocketmine\entity\Location;
use pocketmine\nbt\tag\CompoundTag;

// Example: Register custom entity
EntityFactory::getInstance()->register(
    CustomEntity::class,
    function(Location $location, CompoundTag $nbt) : CustomEntity{
        return new CustomEntity($location, $nbt);
    },
    ['CustomEntity', 'my_plugin:custom_entity']
);

use pocketmine\entity\Location;
use pocketmine\entity\EntityFactory;
use pocketmine\nbt\tag\CompoundTag;

// Spawn a basic entity
$location = new Location(100, 64, 100, $world, 0, 0);
$nbt = CompoundTag::create();
$entity = EntityFactory::getInstance()->create(EntityTypeIds::ZOMBIE, $location, $nbt);
if($entity !== null){
    $entity->spawnToAll();
}

use pocketmine\math\AxisAlignedBB;

// Find entities within radius
$radius = 10;
$bb = new AxisAlignedBB(
    $pos->x - $radius, $pos->y - $radius, $pos->z - $radius,
    $pos->x + $radius, $pos->y + $radius, $pos->z + $radius
);

$nearbyEntities = $world->getNearbyEntities($bb);
foreach($nearbyEntities as $entity){
    if($entity instanceof Living){
        // Do something with living entities
    }
}

use pocketmine\entity\Living;
use pocketmine\entity\effect\VanillaEffects;
use pocketmine\entity\effect\EffectInstance;

if($entity instanceof Living){
    // Add speed effect
    $entity->getEffects()->add(
        new EffectInstance(VanillaEffects::SPEED(), 20 * 30, 1) // 30 seconds, level 2
    );
    
    // Add multiple effects
    $entity->getEffects()->add(
        new EffectInstance(VanillaEffects::REGENERATION(), 20 * 10, 0)
    );
    
    // Remove all effects
    $entity->getEffects()->clear();
}

use pocketmine\entity\Living;
use pocketmine\entity\EntitySizeInfo;
use pocketmine\nbt\tag\CompoundTag;

class CustomMob extends Living{
    
    protected function getInitialSizeInfo() : EntitySizeInfo{
        return new EntitySizeInfo(1.8, 0.6); // height, width
    }
    
    protected function getInitialDragMultiplier() : float{
        return 0.02;
    }
    
    protected function getInitialGravity() : float{
        return 0.08;
    }
    
    public function getName() : string{
        return "Custom Mob";
    }
    
    protected function entityBaseTick(int $tickDiff = 1) : bool{
        $hasUpdate = parent::entityBaseTick($tickDiff);
        
        // Custom behavior every tick
        if($this->isAlive()){
            // AI logic here
        }
        
        return $hasUpdate;
    }
}