====== OnPlayerJoined hook callback function ======
OnPlayerJoined() is called whenever a player has completely logged in. It is called after [[api:plugin:onlogin|OnLogin]] and before [[api:plugin:onplayerspawned|OnPlayerSpawned]], right after the player is entity is created, but not added to the world yet. The player is not yet visible to other players. This is a notification-only event, plugins wishing to refuse player's entry should kick the player using the [[API:cPlayer|cPlayer]]:Kick() function.

===== Function signature =====
<code lua>
function OnPlayerJoined(Player)
</code>
Parameters:
| Player | [[API:cPlayer|cPlayer]] | The player who has joined |

===== Return values =====
If the function returns false or no value, other plugins' callbacks are called. If the function returns true, no other callbacks are called for this event. Either way the player is let in.

===== Registering the callback =====
To register your plugin to receive a callback through this function, use the hook [[api:plugin:hooks|HOOK_PLAYER_JOINED]]
<code lua>
cPluginManager:Get():AddHook(Plugin, cPluginManager.HOOK_PLAYER_JOINED);
</code>
