OnPlayerQuit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
(7 intermediate revisions by 3 users not shown)
Line 8: Line 8:
</syntaxhighlight>  
</syntaxhighlight>  


*'''quitType''': How the player left.
*'''quitType''': How the player left. Possible values:
This argument can be:
**''"Unknown"''
* "Unknown"
**''"Quit"''
* "Quit"
**''"Kicked"''
* "Kicked"
**''"Banned"''
* "Banned"
**''"Bad Connection"''
* "Bad Connection"
**''"Timed out"''
* "Timed out"


{{New feature|3|1.0|
*'''reason''': If the player was kicked or banned, the reason given goes here. If the player was '''not''' kicked or banned, this will be false.
*'''reason''': If the player was kicked or banned, the reason given goes here. If the player was '''not''' kicked or banned, this will be false.
*'''responsibleElement''': The element that was responsible for kicking or banning the player. This is commonly another player, but can also be the console element.
*'''responsibleElement''': The element that was responsible for kicking or banning the player. This is commonly another player, but can also be the console element.
}}


==Source==
==Source==
Line 27: Line 23:


==Example==
==Example==
This example gets the quitting client's name and outputs that he is gone
This example gets a quitting player's name and outputs that they left the server.


<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- we register quitPlayer as a handler for the event
-- we register quitPlayer as a handler for the event
function quitPlayer ( quitType )
function quitPlayer ( quitType )
-- we store the player's name
-- send the message to the server telling players that the player has left.
local quittingPlayerName = getPlayerName ( source )
outputChatBox ( getPlayerName(source).. " has left the server (" .. quitType .. ")" )
-- and send the message to the server
outputChatBox ( quittingPlayerName .. " has left the server (" .. quitType .. ")" )
end
end
addEventHandler ( "onPlayerQuit", getRootElement(), quitPlayer )
addEventHandler ( "onPlayerQuit", root, quitPlayer )
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Player events}}
{{See also/Server event|Player events}}

Revision as of 03:02, 27 September 2018

This event is triggered when a player disconnects from the server.

Parameters

string quitType, string reason, element responsibleElement
  • quitType: How the player left. Possible values:
    • "Unknown"
    • "Quit"
    • "Kicked"
    • "Banned"
    • "Bad Connection"
    • "Timed out"
  • reason: If the player was kicked or banned, the reason given goes here. If the player was not kicked or banned, this will be false.
  • responsibleElement: The element that was responsible for kicking or banning the player. This is commonly another player, but can also be the console element.

Source

The source of this event is the player that left the server.

Example

This example gets a quitting player's name and outputs that they left the server.

-- we register quitPlayer as a handler for the event
function quitPlayer ( quitType )
	-- send the message to the server telling players that the player has left.
	outputChatBox ( getPlayerName(source).. " has left the server (" .. quitType .. ")" )
end
addEventHandler ( "onPlayerQuit", root, quitPlayer )

See Also

Player events


Event functions