From 331b05c68102b56393122d1910804ce8c084308c Mon Sep 17 00:00:00 2001
From: "Dylan K. Taylor" <dktapps@pmmp.io>
Date: Sat, 21 May 2022 22:11:21 +0100
Subject: [PATCH] Improve documentation of EntitySpawnEvent and
 EntityDespawnEvent

---
 src/event/entity/EntityDespawnEvent.php | 4 +++-
 src/event/entity/EntitySpawnEvent.php   | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/event/entity/EntityDespawnEvent.php b/src/event/entity/EntityDespawnEvent.php
index 0fd0da8a0..73d73dd84 100644
--- a/src/event/entity/EntityDespawnEvent.php
+++ b/src/event/entity/EntityDespawnEvent.php
@@ -26,7 +26,9 @@ namespace pocketmine\event\entity;
 use pocketmine\entity\Entity;
 
 /**
- * Called when a entity is despawned
+ * Called when an entity is removed from the world. This could be for a variety of reasons, including chunks being
+ * unloaded, entity death, etc.
+ *
  * @phpstan-extends EntityEvent<Entity>
  */
 class EntityDespawnEvent extends EntityEvent{
diff --git a/src/event/entity/EntitySpawnEvent.php b/src/event/entity/EntitySpawnEvent.php
index 89e660a42..6feab8cad 100644
--- a/src/event/entity/EntitySpawnEvent.php
+++ b/src/event/entity/EntitySpawnEvent.php
@@ -26,7 +26,8 @@ namespace pocketmine\event\entity;
 use pocketmine\entity\Entity;
 
 /**
- * Called when a entity is spawned
+ * Called when an entity is added to the world. This might be a new entity or an entity loaded from storage.
+ *
  * @phpstan-extends EntityEvent<Entity>
  */
 class EntitySpawnEvent extends EntityEvent{