GetPlayerWantedLevel

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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 )

OOP Syntax Help! I don't understand this!

Method: player:getWantedLevel(...)
Variable: .wantedLevel
Counterpart: setPlayerWantedLevel


Required Arguments

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

OOP Syntax Help! I don't understand this!

Method: Player.getWantedLevel(...)
Counterpart: setPlayerWantedLevel


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