summaryrefslogblamecommitdiffstats
path: root/MCServer/Plugins/APIDump/Hooks/OnDisconnect.lua
blob: 204cb63d27ea79360e7527c7fda06a63ff8b50d8 (plain) (tree)
1
2
3
4
5
6
7
8
9
10



                         



                                                                                                                             

                                                                         










                                                                                                                               


                        
                                                                                                                   


                                                                                                                                     

                                                                                                                          
                                                   






                              
return
{
	HOOK_DISCONNECT =
	{
		CalledWhen = [[
			A client has disconnected, either by explicitly sending the disconnect packet (in older protocols) or
			their connection was terminated
		]],
		DefaultFnName = "OnDisconnect",  -- also used as pagename
		Desc = [[
			This hook is called when a client has disconnected from the server, for whatever reason. It is also
			called when the client sends the Disconnect packet (only in pre-1.7 protocols). This hook is not called
			for server ping connections.</p>
			<p>
			Note that the hook is called even for connections to players who failed to auth. In such a case there's
			no {{cPlayer}} object associated with the client.</p>
			<p>
			See also the {{OnHandshake|HOOK_HANDSHAKE}} hook which is called when the client connects (and presents
			a handshake message, so that they are not just status-pinging). If you need to store a per-player
			object, use the {{OnPlayerJoined|HOOK_PLAYER_JOINED}} and {{OnPlayerDestroyed|HOOK_PLAYER_DESTROYED}}
			hooks instead, those are guaranteed to have the {{cPlayer}} object associated.
		]],
		Params =
		{
			{ Name = "Client", Type = "{{cClientHandle}}", Notes = "The client who has disconnected" },
			{ Name = "Reason", Type = "string", Notes = "The reason that the client has sent in the disconnect packet" },
		},
		Returns = [[
			If the function returns false or no value, MCServer calls other plugins' callbacks for this event.
			If the function returns true, no other plugins are called for this event. In either case,
			the client is disconnected.
		]],
	},  -- HOOK_DISCONNECT
}