SetPlayerNametagColor: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(→‎Syntax: OOP syntax added)
(Removed {{Needs_Checking}} format and added removeHex link instead of setPlayerNametagColor.)
 
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
{{Note box|If the player is using a hexcode in front of their name, it will override this function. You must first strip the name of the hexcode using [[setPlayerNametagText]]}}
{{Needs_Checking|See the note. There should probably be a useful function to do this instead of everyone trying to re-invent the wheel when they need to force nick colors ie TDM/gangwars. If someone makes a useful function, link it in the note.}}
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->
<!-- Describe in plain english what this function does. Don't go into details, just give an overview -->
This allows you to change the RGB color mixture in the name tags of players.
This allows you to change the RGB color mixture in the name tags of players.
{{Note|If the player is using a hexcode in front of their name, it will override this function. You must first strip the name of the hexcode using [[removeHex]]}}


==Syntax==  
==Syntax==  

Latest revision as of 23:24, 6 July 2016

This allows you to change the RGB color mixture in the name tags of players.

[[{{{image}}}|link=|]] Note: If the player is using a hexcode in front of their name, it will override this function. You must first strip the name of the hexcode using removeHex

Syntax

bool setPlayerNametagColor ( player thePlayer, int r, int g, int b )

OR 

bool setPlayerNametagColor ( player thePlayer, false )

OOP Syntax Help! I don't understand this!

Method: player:setNametagColor(...)


Required Arguments

  • thePlayer: The player whose name tag text you wish to change the color of
  • r: The amount of red you want in the mixture of RGB (0-255 is valid)
  • g: The amount of green you want in the mixture of RGB (0-255 is valid)
  • b: The amount of blue you want in the mixture of RGB (0-255 is valid)
  • false: If false is specified instead of the colors, the nametag color will reset to defaulting to your team color.

Returns

Returns true if the function was successful, false otherwise.

Example

This will allow a player to change the RGB color mixture of their nickname. Valid RGB is between 0-255. 

-- The handler function for the console command
function nametagColorChange ( thePlayer, commandName, r, g, b )
    -- Apply the new color mix of RGB to the command handler activator
    setPlayerNametagColor ( thePlayer, r, g, b )
end
-- This is a command handler that activates on text "nametagcolor" in the console. It also asks 
-- the player to provide values for the extra parameters r, g, b after the command name. These will 
-- be the new color mix of RGB to apply to the player's name tag.
addCommandHandler ( "nametagcolor", nametagColorChange )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/SetPlayerNametagColor?oldid=48020"