From 62245befb14ef9718095dacf771d06b53a25c4ef Mon Sep 17 00:00:00 2001
From: Octol1ttle <l1ttleofficial@outlook.com>
Date: Sun, 9 Mar 2025 13:58:18 +0000
Subject: [PATCH] fix(javadocs): clarify the player's networking state when
 ServerPlayerEvents.COPY_FROM is called (#4484)

---
 .../fabric/api/entity/event/v1/ServerPlayerEvents.java        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/fabric-entity-events-v1/src/main/java/net/fabricmc/fabric/api/entity/event/v1/ServerPlayerEvents.java b/fabric-entity-events-v1/src/main/java/net/fabricmc/fabric/api/entity/event/v1/ServerPlayerEvents.java
index 2b915540d..462a95c6a 100644
--- a/fabric-entity-events-v1/src/main/java/net/fabricmc/fabric/api/entity/event/v1/ServerPlayerEvents.java
+++ b/fabric-entity-events-v1/src/main/java/net/fabricmc/fabric/api/entity/event/v1/ServerPlayerEvents.java
@@ -26,8 +26,10 @@ public final class ServerPlayerEvents {
 	/**
 	 * An event that is called when the data from an old player is copied to a new player.
 	 *
-	 * <p>This event is typically called before a player is completely respawned.
+	 * <p>This event is called <strong>after</strong> the old player is removed and untracked, but <strong>before</strong> the new player is added and tracked.
 	 * Mods may use this event to copy old player data to a new player.
+	 *
+	 * @see ServerPlayerEvents#AFTER_RESPAWN
 	 */
 	public static final Event<ServerPlayerEvents.CopyFrom> COPY_FROM = EventFactory.createArrayBacked(ServerPlayerEvents.CopyFrom.class, callbacks -> (oldPlayer, newPlayer, alive) -> {
 		for (CopyFrom callback : callbacks) {