GetPlayerPing: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
This function returns the ping of a specified [[player]]. The ping is the number of milliseconds that data takes to travel from the player's client to the server or the reverse.
This function returns the ping of a specified [[player]]. The ping is the number of milliseconds that data takes to travel from the player's client to the server or the reverse.



Revision as of 11:32, 7 August 2007

This function returns the ping of a specified player. The ping is the number of milliseconds that data takes to travel from the player's client to the server or the reverse.

Syntax

int getPlayerPing ( player thePlayer )

Required Arguments

  • thePlayer: The player whose ping you want to determine.

Returns

Returns an int with the ping, or false if the player is invalid.

Example

This example checks the ping of every player joining and warns him if it's over 100.

function checkPing()
	local ping = getPlayerPing(source) -- get the ping from the source element (the player who joined)
	if (ping > 100) then -- if its higher than 100..
		outputChatBox("Your ping is pretty high! Please try to lower it if possible.",source) -- output a message to the player
	end
end
addEventHandler("onPlayerJoin",getRootElement(),checkPing) -- add the event handler

See Also