GetPlayerWantedLevel: 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 function}}
{{Server client function}}
This function gets a player's current wanted level. The wanted level is indicated by the amount of stars a player has on the GTA HUD.
This function gets a player's current wanted level. The wanted level is indicated by the amount of stars a player has on the GTA HUD.


Line 22: Line 22:


==Example==
==Example==
<section name="Example 1: Server" class="server" show="true">
This example finds which players in the server have a wanted level:
This example finds which players in the server have a wanted level:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 32: Line 33:
end
end
</syntaxhighlight>
</syntaxhighlight>
</section>
<section name="Example 2: Client" class="client" show="true">
This script output your wanted level when you type /wanted.
<syntaxhighlight lang="lua">
function outputWantedLevel ()
local wantedLvl = getPlayerWantedLevel ( )
  if wantedLvl == 0 then
      outputChatBox ( "You clean", 0, 255, 0)
  else
      outputChatBox ( "You have "..wantedLvl.." wanted stars!", 255, 0, 0)
  end
end
addCommandHandler ( "wanted", outputWantedLevel )
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Player functions}}
{{Player functions}}

Revision as of 07:22, 15 August 2011

This function gets a player's current wanted level. The wanted level is indicated by the amount of stars a player has on the GTA HUD.

Syntax

Click to collapse [-]
Server
int getPlayerWantedLevel ( player thePlayer )

Required Arguments

  • thePlayer: The player whose wanted level you wish to get
Click to collapse [-]
Client
int getPlayerWantedLevel ( )

Returns

Returns an int from 0 to 6 representing the player's wanted level, false if the player does not exist.

Example

Click to collapse [-]
Example 1: Server

This example finds which players in the server have a wanted level: 

local players = getElementsByType ( "player" ) -- get a table of all the players in the server
for theKey,thePlayer in ipairs(players) do -- use a generic for loop to step through each player
   local level = getPlayerWantedLevel ( thePlayer ) -- get the wanted level of the player
   if ( level > 0 ) then -- if the player has any stars, announce it in the chat:
      outputChatBox ( getPlayerName ( thePlayer ) .. " has a wanted level of " .. level .. "  stars!" )
   end 
end
Click to collapse [-]
Example 2: Client

This script output your wanted level when you type /wanted. 

function outputWantedLevel ()
local wantedLvl = getPlayerWantedLevel ( )
   if wantedLvl == 0 then
      outputChatBox ( "You clean", 0, 255, 0)
   else
      outputChatBox ( "You have "..wantedLvl.." wanted stars!", 255, 0, 0)
   end
end
addCommandHandler ( "wanted", outputWantedLevel )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetPlayerWantedLevel?oldid=26711"