isNull()){ throw new \InvalidArgumentException("Item entity must have a non-air item with a count of at least 1"); } $this->item = clone $item; parent::__construct($location, $nbt); } protected function getInitialSizeInfo() : EntitySizeInfo{ return new EntitySizeInfo(0.25, 0.25); } protected function getInitialDragMultiplier() : float{ return 0.02; } protected function getInitialGravity() : float{ return 0.04; } protected function initEntity(CompoundTag $nbt) : void{ parent::initEntity($nbt); $this->setMaxHealth(5); $this->setHealth($nbt->getShort(self::TAG_HEALTH, (int) $this->getHealth())); $age = $nbt->getShort(self::TAG_AGE, 0); if($age === -32768){ $this->despawnDelay = self::NEVER_DESPAWN; }else{ $this->despawnDelay = max(0, self::DEFAULT_DESPAWN_DELAY - $age); } $this->pickupDelay = $nbt->getShort(self::TAG_PICKUP_DELAY, $this->pickupDelay); $this->owner = $nbt->getString(self::TAG_OWNER, $this->owner); $this->thrower = $nbt->getString(self::TAG_THROWER, $this->thrower); } protected function onFirstUpdate(int $currentTick) : void{ (new ItemSpawnEvent($this))->call(); //this must be called before EntitySpawnEvent, to maintain backwards compatibility parent::onFirstUpdate($currentTick); } protected function entityBaseTick(int $tickDiff = 1) : bool{ if($this->closed){ return false; } Timings::$itemEntityBaseTick->startTiming(); try{ $hasUpdate = parent::entityBaseTick($tickDiff); if($this->isFlaggedForDespawn()){ return $hasUpdate; } if($this->pickupDelay !== self::NEVER_DESPAWN && $this->pickupDelay > 0){ //Infinite delay $hasUpdate = true; $this->pickupDelay -= $tickDiff; if($this->pickupDelay < 0){ $this->pickupDelay = 0; } } if($this->hasMovementUpdate() && $this->isMergeCandidate() && $this->despawnDelay % self::MERGE_CHECK_PERIOD === 0){ $mergeable = [$this]; //in case the merge target ends up not being this $mergeTarget = $this; foreach($this->getWorld()->getNearbyEntities($this->boundingBox->expandedCopy(0.5, 0.5, 0.5), $this) as $entity){ if(!$entity instanceof ItemEntity || $entity->isFlaggedForDespawn()){ continue; } if($entity->isMergeable($this)){ $mergeable[] = $entity; if($entity->item->getCount() > $mergeTarget->item->getCount()){ $mergeTarget = $entity; } } } foreach($mergeable as $itemEntity){ if($itemEntity !== $mergeTarget){ $itemEntity->tryMergeInto($mergeTarget); } } } if(!$this->isFlaggedForDespawn() && $this->despawnDelay !== self::NEVER_DESPAWN){ $hasUpdate = true; $this->despawnDelay -= $tickDiff; if($this->despawnDelay <= 0){ $ev = new ItemDespawnEvent($this); $ev->call(); if($ev->isCancelled()){ $this->despawnDelay = self::DEFAULT_DESPAWN_DELAY; }else{ $this->flagForDespawn(); } } } return $hasUpdate; }finally{ Timings::$itemEntityBaseTick->stopTiming(); } } private function isMergeCandidate() : bool{ return $this->pickupDelay !== self::NEVER_DESPAWN && $this->item->getCount() < $this->item->getMaxStackSize(); } /** * Returns whether this item entity can merge with the given one. */ public function isMergeable(ItemEntity $entity) : bool{ if(!$this->isMergeCandidate() || !$entity->isMergeCandidate()){ return false; } $item = $entity->item; return $entity !== $this && $item->canStackWith($this->item) && $item->getCount() + $this->item->getCount() <= $item->getMaxStackSize(); } /** * Attempts to merge this item entity into the given item entity. Returns true if it was successful. */ public function tryMergeInto(ItemEntity $consumer) : bool{ if(!$this->isMergeable($consumer)){ return false; } $ev = new ItemMergeEvent($this, $consumer); $ev->call(); if($ev->isCancelled()){ return false; } $consumer->setStackSize($consumer->item->getCount() + $this->item->getCount()); $this->flagForDespawn(); $consumer->pickupDelay = max($consumer->pickupDelay, $this->pickupDelay); $consumer->despawnDelay = max($consumer->despawnDelay, $this->despawnDelay); return true; } protected function tryChangeMovement() : void{ $this->checkObstruction($this->location->x, $this->location->y, $this->location->z); parent::tryChangeMovement(); } protected function applyDragBeforeGravity() : bool{ return true; } public function canSaveWithChunk() : bool{ return !$this->item->isNull() && parent::canSaveWithChunk(); } public function saveNBT() : CompoundTag{ $nbt = parent::saveNBT(); $nbt->setTag(self::TAG_ITEM, $this->item->nbtSerialize()); $nbt->setShort(self::TAG_HEALTH, (int) $this->getHealth()); if($this->despawnDelay === self::NEVER_DESPAWN){ $age = -32768; }else{ $age = self::DEFAULT_DESPAWN_DELAY - $this->despawnDelay; } $nbt->setShort(self::TAG_AGE, $age); $nbt->setShort(self::TAG_PICKUP_DELAY, $this->pickupDelay); $nbt->setString(self::TAG_OWNER, $this->owner); $nbt->setString(self::TAG_THROWER, $this->thrower); return $nbt; } public function getItem() : Item{ return $this->item; } public function isFireProof() : bool{ return $this->item->isFireProof(); } public function canCollideWith(Entity $entity) : bool{ return false; } public function canBeCollidedWith() : bool{ return false; } public function getPickupDelay() : int{ return $this->pickupDelay; } public function setPickupDelay(int $delay) : void{ $this->pickupDelay = $delay; } /** * Returns the number of ticks left before this item will despawn. If -1, the item will never despawn. */ public function getDespawnDelay() : int{ return $this->despawnDelay; } /** * @throws \InvalidArgumentException */ public function setDespawnDelay(int $despawnDelay) : void{ if(($despawnDelay < 0 || $despawnDelay > self::MAX_DESPAWN_DELAY) && $despawnDelay !== self::NEVER_DESPAWN){ throw new \InvalidArgumentException("Despawn ticker must be in range 0 ... " . self::MAX_DESPAWN_DELAY . " or " . self::NEVER_DESPAWN . ", got $despawnDelay"); } $this->despawnDelay = $despawnDelay; } public function getOwner() : string{ return $this->owner; } public function setOwner(string $owner) : void{ $this->owner = $owner; } public function getThrower() : string{ return $this->thrower; } public function setThrower(string $thrower) : void{ $this->thrower = $thrower; } protected function sendSpawnPacket(Player $player) : void{ $networkSession = $player->getNetworkSession(); $networkSession->sendDataPacket(AddItemActorPacket::create( $this->getId(), //TODO: entity unique ID $this->getId(), ItemStackWrapper::legacy($networkSession->getTypeConverter()->coreItemStackToNet($this->getItem())), $this->location->asVector3(), $this->getMotion(), $this->getAllNetworkData(), false //TODO: I have no idea what this is needed for, but right now we don't support fishing anyway )); } public function setStackSize(int $newCount) : void{ if($newCount <= 0){ throw new \InvalidArgumentException("Stack size must be at least 1"); } $this->item->setCount($newCount); $this->broadcastAnimation(new ItemEntityStackSizeChangeAnimation($this, $newCount)); } public function getOffsetPosition(Vector3 $vector3) : Vector3{ return $vector3->add(0, 0.125, 0); } public function onCollideWithPlayer(Player $player) : void{ if($this->getPickupDelay() !== 0){ return; } $item = $this->getItem(); $playerInventory = match(true){ $player->getOffHandInventory()->getItem(0)->canStackWith($item) && $player->getOffHandInventory()->getAddableItemQuantity($item) > 0 => $player->getOffHandInventory(), $player->getInventory()->getAddableItemQuantity($item) > 0 => $player->getInventory(), default => null }; $ev = new EntityItemPickupEvent($player, $this, $item, $playerInventory); if($player->hasFiniteResources() && $playerInventory === null){ $ev->cancel(); } $ev->call(); if($ev->isCancelled()){ return; } NetworkBroadcastUtils::broadcastEntityEvent( $this->getViewers(), fn(EntityEventBroadcaster $broadcaster, array $recipients) => $broadcaster->onPickUpItem($recipients, $player, $this) ); $inventory = $ev->getInventory(); if($inventory !== null){ foreach($inventory->addItem($ev->getItem()) as $remains){ $this->getWorld()->dropItem($this->location, $remains, new Vector3(0, 0, 0)); } } $this->flagForDespawn(); } }