GetPlayerNametagText: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(→‎Syntax: OOP syntax added)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server client function}}
<!-- 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 will allow you to retrieve the name tag a player is currently using.
This will allow you to retrieve the name tag a player is currently using.
Line 8: Line 9:
string getPlayerNametagText ( player thePlayer )
string getPlayerNametagText ( player thePlayer )
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[player]]:getNametagText|nametagText|setPlayerNametagText}}
===Required Arguments===  
===Required Arguments===  
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
<!-- List each argument one per line. This should be the argument's name as in the argument list above, NOT the argument's data type -->
Line 15: Line 16:
===Returns===
===Returns===
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check -->
<!-- Make this descriptive. Explain what cases will return false. If you're unsure, add a tag to it so we can check -->
Returns ''true'' if successful, ''false'' otherwise.
Returns a ''string'' with the nametag text, ''false'' if the player is invalid.


==Example==  
==Example==  
<!-- Explain what the example is in a single sentance -->
<!-- Explain what the example is in a single sentance -->
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
<!-- Add the code below, an emphasis should be on making it clear, not optimized. You could provide two versions if you wish, one clear and well commented, the other optimized -->
This will announce that a player has entered a car whenever a player enters a car.
This will output the nametag text of the player who enters the command 'myNametag'.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onVehicleEnter", root, "VehicleEnter" )
function showNametag ( thePlayer, command )
function VehicleEnter ( player, seat, jacked )
local nameTag = getPlayerNametagText ( thePlayer )
playersname = getPlayerNametagText ( player )
outputChatBox ( "Your nametag text is: " .. nameTag, thePlayer )
--Store the name of the person who entered the car
outputChatBox ( playersname.." entered a car!" )
--output the name tag of the person who entered the car
end
end
addCommandHandler("myNametag", showNametag)
</syntaxhighlight>
</syntaxhighlight>


Latest revision as of 05:18, 15 July 2014

This will allow you to retrieve the name tag a player is currently using.

Syntax

string getPlayerNametagText ( player thePlayer )

OOP Syntax Help! I don't understand this!

Method: player:getNametagText(...)
Variable: .nametagText
Counterpart: setPlayerNametagText


Required Arguments

  • thePlayer: The person whose name tag you want to retrieve

Returns

Returns a string with the nametag text, false if the player is invalid.

Example

This will output the nametag text of the player who enters the command 'myNametag'. 

function showNametag ( thePlayer, command )
	local nameTag = getPlayerNametagText ( thePlayer )
	outputChatBox ( "Your nametag text is: " .. nameTag, thePlayer )
end
addCommandHandler("myNametag", showNametag)

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetPlayerNametagText?oldid=40793"