SetPlayerNametagText

	This article needs checking.
	Reason(s): Read my description. This function seems kinda silly if its only going to change the text of the tag inside the world on the player. --Ransom 21:58, 10 April 2007 (CDT)

This will change the text of a player's nickname in the world to something besides the nickname he choose. This will not change the player's actual nickname, it only changes the visible aspect inside the world (you will see his original nickname in the scoreboard and will refer to his original name in scripts).

Syntax

bool setPlayerNametagText ( player thePlayer, string text )

Required Arguments

• thePlayer: The player whose nickname text you wish to change
• text: The new nickname text that will be displayed

Returns

Returns true if successful, false otherwise.

Example

This example does...

addCommandHandler ( "lamer", "ihatelamers" )
function ihatelamers ( player, commandName, playername )
--This is a command handler that activates on text "lamer" followed by the playername
--in the console. The playername argument was added as an extra varible to store the
--name of the player whose text will be changed.
 	if playername == false then
 	--Prevents the command from running if the player did not specify a value for playername
	outputChatBox ( "You MUST define a player to change his name tag!" )
	else
	culprit = getPlayerFromNick ( playername )
	--This varible stores the result of trying to find the player associated with the playername
	--that the user of the command specified
		if culprit ~= false then
		--This checks to make sure a player nick was found. If it was not then the playername argument
		--specified by the command user was not equivalent to the name of any players in the server
		setPlayerNametagText ( culprit, "IM_LAME" )
		--finally, the nickname text is changed since the command arguments were checked and are valid
		else
		outputChatBox ( "Player does not exist!" )
		end
	end
end

See Also

• forcePlayerMap
• getAlivePlayers
• getDeadPlayers
• getPlayerACInfo
• getPlayerAnnounceValue
• getPlayerBlurLevel
• getPlayerCount
• getPlayerFromName
• getPlayerIdleTime
• getPlayerIP
• getPlayerMoney
• getPlayerName
• getPlayerNametagColor
• getPlayerNametagText
• getPlayerPing
• getPlayerScriptDebugLevel
• getPlayerSerial
• getPlayerTeam
• getPlayerVersion
• getPlayerWantedLevel
• getRandomPlayer
• givePlayerMoney
• isPlayerMapForced
• isPlayerMuted
• isPlayerNametagShowing
• isVoiceEnabled
• redirectPlayer
• resendPlayerACInfo
• resendPlayerModInfo
• setPlayerAnnounceValue
• setPlayerBlurLevel
• setPlayerHudComponentVisible
• setPlayerMoney
• setPlayerMuted
• setPlayerName
• setPlayerNametagColor
• setPlayerNametagShowing
• setPlayerNametagText
• setPlayerScriptDebugLevel
• setPlayerTeam
• setPlayerVoiceBroadcastTo
• setPlayerVoiceIgnoreFrom
• setPlayerWantedLevel
• spawnPlayer
• takePlayerMoney
• takePlayerScreenShot

-- leave this unless you complete the function