summaryrefslogtreecommitdiffstats
path: root/Server/Plugins/APIDump/Hooks/OnPlayerDestroyed.lua
blob: dc033197abd8c786f5194a530e4f73dac9371cea (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
return
{
	HOOK_PLAYER_DESTROYED =
	{
		CalledWhen = "A player object is about to be destroyed.",
		DefaultFnName = "OnPlayerDestroyed",  -- also used as pagename
		Desc = [[
			This function is called before a {{cPlayer|player}} is about to be destroyed.
			The player has disconnected for whatever reason and is no longer in the server.
			If a plugin returns true, a leave message is not broadcast, and vice versa.
			However, whatever the return value, the player object is removed from memory.
		]],
		Params =
		{
			{ Name = "Player", Type = "{{cPlayer}}", Notes = "The destroyed player" },
		},
		Returns = [[
			If the function returns false or no value, other plugins' callbacks are called and a leave message is broadcast.
			If the function returns true, no other callbacks are called for this event and no leave message appears. Either way the player is removed internally. 
		]],
	},  -- HOOK_PLAYER_DESTROYED
}