IsPlayerMapForced

From Multi Theft Auto: Wiki
Revision as of 11:53, 9 November 2024 by Fernando187 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This function checks if the specified player's map (F11) has been forced on or not.

Syntax

Click to collapse [-]
Server
bool isPlayerMapForced ( player thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:isMapForced(...)
Variable: .mapForced
Counterpart: forcePlayerMap


Required Arguments

  • thePlayer: A player object referencing the specified player

Returns

Returns true if the player's map is forced on, false otherwise.

Click to collapse [-]
Client
bool isPlayerMapForced ()

OOP Syntax Help! I don't understand this!

Method: Player.isMapForced(...)
Counterpart: forcePlayerMap


Returns

Returns true if the local player's map is forced on, false otherwise.

Example

Click to collapse [-]
Server

This example forces a player's map on for 10 seconds if it hasn't been already.

function forceMapForPlayer ( callingPlayer, command, whoNick )
	local who = getPlayerFromName ( whoNick )                                   -- Look up the specified player
	if ( who ) then
		if ( not isPlayerMapForced ( who ) ) then                           -- if their map isn't already forced on
			forcePlayerMap ( who, true )                                -- force it on
			setTimer ( forcePlayerMap, 10000, 1, who, false )           -- force it off in 10secs
			outputChatBox ( "Forcing Map for " .. whoNick, callingPlayer ) -- output a message to the one who entered the command
		else
			outputChatBox ( "Map already forced for " .. whoNick, callingPlayer ) -- if the map is already forced, output a message
		end
	else
		outputChatBox ( "Couldn't find " .. whoNick, callingPlayer )        -- if the player wasn't found, output a message
	end
end
addCommandHandler ( "forcemap", forceMapForPlayer ) -- add a command handler

See Also