IsPlayerInWater: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Removed Template:Needs Checking: Tested, verified note (clientside version syntax lacked player arg). Added section for example)
m (Change deprecated function alternative.)
 
(7 intermediate revisions by 7 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
This function is used to determine whether or not a player is currenlty in water.
{{Deprecated|isElementInWater}}
 
This function is used to determine whether or not a player is currently in water. Player is in water only if breath bar appears.


==Syntax==
==Syntax==
<section name="Server and client" class="both" show="true">
<syntaxhighlight lang="lua">bool isPlayerInWater ( player thePlayer )</syntaxhighlight>
<syntaxhighlight lang="lua">bool isPlayerInWater ( player thePlayer )</syntaxhighlight>


Line 12: Line 13:
===Returns===
===Returns===
Returns ''true'' if the player is in water, ''false'' otherwise.
Returns ''true'' if the player is in water, ''false'' otherwise.
</section>


==Example==
==Example==
<section name="Serverside example" class="server" show="true">
<section name="Serverside example" class="server" show="true">
This example shows all players that are in water in a list to the player who enters the 'playersInWater' command.
This example shows all players that are in water in a list to the player who enters the 'playersInWater' command.
<syntaxhighlight lang="lua"> [lua]
<syntaxhighlight lang="lua">
function showPlayersInWater(sourcePlayer, command)
function showPlayersInWater(sourcePlayer, command)
local players = getElementsByType("player")
local players = getElementsByType("player")

Latest revision as of 06:08, 22 September 2021

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use isElementInWater instead.


This function is used to determine whether or not a player is currently in water. Player is in water only if breath bar appears.

Syntax

bool isPlayerInWater ( player thePlayer )

Required Arguments

  • thePlayer: The player you are checking.

Returns

Returns true if the player is in water, false otherwise.

Example

Click to collapse [-]
Serverside example

This example shows all players that are in water in a list to the player who enters the 'playersInWater' command.

function showPlayersInWater(sourcePlayer, command)
	local players = getElementsByType("player")
	local list = ""
	for k,v in ipairs(players) do
		if isPlayerInWater(v) then
			list = list .. " " .. getClientName(v)
		end
	end
	outputChatBox("Players pretending to be trouts: " .. list, sourcePlayer)
end
addCommandHandler("playersInWater", showPlayersInWater)

See Also