From 43b01394e5a03cd7a2818087008be08de519ccfd Mon Sep 17 00:00:00 2001
From: Bukkit/Spigot <noreply+git-bukkit@papermc.io>
Date: Sat, 10 Nov 2018 20:30:27 +1100
Subject: [PATCH] SPIGOT-4478: Update PlayerLoginEvent docs

By: md_5 <git@md-5.net>
---
 .../main/java/org/bukkit/event/player/PlayerLoginEvent.java | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java
index 8b012ea9b7..6368c2123f 100644
--- a/paper-api/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java
+++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java
@@ -6,7 +6,11 @@ import org.bukkit.entity.Player;
 import org.bukkit.event.HandlerList;
 
 /**
- * Stores details for players attempting to log in
+ * Stores details for players attempting to log in.
+ * <br>
+ * Note that this event is called <i>early</i> in the player initialization
+ * process. It is recommended that most options involving the Player
+ * <i>entity</i> be postponed to the {@link PlayerJoinEvent} instead.
  */
 public class PlayerLoginEvent extends PlayerEvent {
     private static final HandlerList handlers = new HandlerList();