diff --git a/evennia/commands/default/unloggedin.py b/evennia/commands/default/unloggedin.py
index 6ee497022e..b628436851 100644
--- a/evennia/commands/default/unloggedin.py
+++ b/evennia/commands/default/unloggedin.py
@@ -186,8 +186,8 @@ class CmdUnconnectedConnect(MuxCommand):
         # actually do the login. This will call all other hooks:
         #   session.at_login()
         #   player.at_init()  # always called when object is loaded from disk
+        #   player.at_first_login()  # only once, for player-centric setup
         #   player.at_pre_login()
-        #   player.at_first_login()  # only once
         #   player.at_post_login(sessid=sessid)
         session.sessionhandler.login(session, player)
 
diff --git a/evennia/players/players.py b/evennia/players/players.py
index 9eec629e7f..7a79bf30eb 100644
--- a/evennia/players/players.py
+++ b/evennia/players/players.py
@@ -615,6 +615,10 @@ class DefaultPlayer(PlayerDB):
     def at_first_login(self):
         """
         Called the very first time this player logs into the game.
+        Note that this is called *before* at_pre_login, so no session
+        is established and usually no character is yet assigned at
+        this point. This hook is intended for player-specific setup
+        like configurations.
 
         """
         pass