summaryrefslogtreecommitdiffstats
path: root/MCServer/Plugins/APIDump/Hooks/OnPlayerJoined.lua
blob: 00805af7edc4dfdb9d34ebe29180c4a6bfb869d2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
return
{
	HOOK_PLAYER_JOINED =
	{
		CalledWhen = "After Login and before Spawned, before being added to world. ",
		DefaultFnName = "OnPlayerJoined",  -- also used as pagename
		Desc = [[
			This hook is called whenever a {{cPlayer|player}} has completely logged in. If authentication is
			enabled, this function is called after their name has been authenticated. It is called after
			{{OnLogin|HOOK_LOGIN}} and before {{OnPlayerSpawned|HOOK_PLAYER_SPAWNED}}, right after the player's
			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 {{cPlayer}}:Kick() function.
		]],
		Params =
		{
			{ Name = "Player", Type = "{{cPlayer}}", Notes = "The player who has joined the game" },
		},
		Returns = [[
			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.
		]],
	},  -- HOOK_PLAYER_JOINED
}