OnPlayerQuit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
 
(23 intermediate revisions by 13 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__
This event is triggered when a player leaves the game, for whatever reason.
{{Server event}}
This event is triggered when a player disconnects from the server.


==Syntax==  
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
void onPlayerQuit ( string reason ) 
string quitType, string reason, element responsibleElement
</syntaxhighlight>  
</syntaxhighlight>  


==Example==  
*'''quitType''': How the player left. Possible values:
This example destroys the blips attached to a player and removes him from his team when he quits.
**''"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 [[event system#Event source|source]] of this event is the [[player]] that left the server.
 
==Cancel effect==
This event cannot be canceled.
 
==Example==
This example gets a quitting player's name and outputs that they left the server.
 
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function onPlayerQuit ()                    -- When the player quits
-- we register quitPlayer as a handler for the event
destroyBlipsAttachedTo ( source )   -- Destroy his blips
addEventHandler("onPlayerQuit", root,
removePlayerFromTeam ( source )     -- And remove him from the team he was in
function(quitType)
end
outputChatBox(getPlayerName(source).." has left the server ("..quitType..")")
end
)
</syntaxhighlight>


addEventHandler ( "onPlayerQuit", root, onPlayerQuit ) -- Tell MTA to call above function when the event occurs
{{See also/Server event|Player events}}
</syntaxhighlight>

Latest revision as of 13:14, 25 January 2024

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.

Cancel effect

This event cannot be canceled.

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
addEventHandler("onPlayerQuit", root,
	function(quitType)
		outputChatBox(getPlayerName(source).." has left the server ("..quitType..")")
	end
)

See Also

Player events


Event functions

Shared



Retrieved from "https://wiki.multitheftauto.com/wiki/OnPlayerQuit?oldid=78786"