SetClientName - Revision history

AlexTMjugador: Visual improvement

2014-06-26T12:31:42Z

Visual improvement

← Older revision		Revision as of 12:31, 26 June 2014
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
	{{Deprecated}}		{{Deprecated\|setPlayerName}}
	__NOTOC__		__NOTOC__

	~~Please use [[setPlayerName]]~~

	This function changes the specified [[client]]'s name.		This function changes the specified [[client]]'s name.

Arran Fortuna at 21:34, 20 April 2011

2011-04-20T21:34:53Z

← Older revision		Revision as of 21:34, 20 April 2011
Line 2:		Line 2:
	{{Deprecated}}		{{Deprecated}}
	__NOTOC__		__NOTOC__

			Please use [[setPlayerName]]

	This function changes the specified [[client]]'s name.		This function changes the specified [[client]]'s name.

Awwu at 14:26, 27 March 2009

2009-03-27T14:26:26Z

← Older revision		Revision as of 14:26, 27 March 2009
Line 1:		Line 1:
	{{Server function}}		{{Server function}}
			{{Deprecated}}
	__NOTOC__		__NOTOC__
	This function changes the specified [[client]]'s name.		This function changes the specified [[client]]'s name.

Arc at 12:13, 16 August 2007

2007-08-16T12:13:19Z

← Older revision		Revision as of 12:13, 16 August 2007
Line 16:		Line 16:

	==Example==		==Example==
	<section name="Server" class="server" show="~~false~~">		<section name="Server" class="server" show="true">
	This example adds a tag before a player's nickname via a /changetag command		This example adds a tag before a player's nickname via a /changetag command
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

AlienX at 11:58, 12 August 2007

2007-08-12T11:58:57Z

← Older revision		Revision as of 11:58, 12 August 2007
Line 15:		Line 15:
	Returns ''true'' if the client's name was changed succesfully, ''false'' if invalid arguments are specified.		Returns ''true'' if the client's name was changed succesfully, ''false'' if invalid arguments are specified.

			==Example==
	<section name="Server" class="server" show="false">		<section name="Server" class="server" show="false">
	~~==Example==~~
	This example adds a tag before a player's nickname via a /changetag command		This example adds a tag before a player's nickname via a /changetag command
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

AlienX at 15:28, 11 August 2007

2007-08-11T15:28:28Z

← Older revision		Revision as of 15:28, 11 August 2007
Line 1:		Line 1:
			{{Server function}}
	__NOTOC__		__NOTOC__
	This function changes the specified [[client]]'s name.		This function changes the specified [[client]]'s name.
Line 14:		Line 15:
	Returns ''true'' if the client's name was changed succesfully, ''false'' if invalid arguments are specified.		Returns ''true'' if the client's name was changed succesfully, ''false'' if invalid arguments are specified.

			<section name="Server" class="server" show="false">
	==Example==		==Example==
	This example adds a tag before a player's nickname via a /changetag command		This example adds a tag before a player's nickname via a /changetag command
Line 48:		Line 50:
	addCommandHandler ( "changetag", tagPlayer )		addCommandHandler ( "changetag", tagPlayer )
	</syntaxhighlight>		</syntaxhighlight>
			</section>

	==See Also==		==See Also==
	{{Client_functions}}		{{Client_functions}}

AlienX: /* Example */

2007-08-03T08:08:08Z

Example

← Older revision		Revision as of 08:08, 3 August 2007
Line 15:		Line 15:

	==Example==		==Example==
	This example adds a tag before a player's ~~nick~~ via a /changetag command		This example adds a tag before a player's nickname via a /changetag command
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

AlienX: /* Example */

2007-08-03T08:07:31Z

Example

← Older revision		Revision as of 08:07, 3 August 2007
Line 15:		Line 15:

	==Example==		==Example==
	This example adds a tag before a player's nick.		This example adds a tag before a player's nick via a /changetag command
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function tagPlayer( command, thePlayer, tag )
	--~~we check~~ thePlayer is a player~~, otherwise this function could be used with admins~~		--Define the function for this command (/changetag, as defined below)
	if getElementType( ~~thePlayer~~ ) == "player" then		--Source = the player that triggered this command
	--we store the player's current name,		--Command = The command passed into the function (changetag)
	local oldName = getClientName( ~~thePlayer~~ )		--thePlayer = The player argument that you wish to add a tag too
	--append the tag passed to this function before it,		--tag = The tag to add to the players nickname
	local taggedName = tag .. oldName		function tagPlayer( source, command, thePlayer, tag )
	--then set it as his new name		--Attempt to grab the elemennt id for the player from the parsed name.
	~~setClientName~~( thePlayer, ~~taggedName~~ )		local sPlayerElement = getPlayerFromNick(thePlayer)
			--Check to see if the player were changing the tag for exists.
			if (sPlayerElement) then
			--make sure that the element type of thePlayer is acctually pointing to a player element
			if getElementType( sPlayerElement ) == "player" then
			--we store the player's current name,
			local oldName = getClientName( sPlayerElement )
			--append the tag passed to this function before it
			local taggedName = tag .. oldName
			--then set it as his new name
			setClientName( sPlayerElement, taggedName )
			--Tell the player who triggerd the command that the tag has been applied
			outputChatBox ( "Player " .. thePlayer .. "'s tag changed to " .. taggedName, source )
			end
			else
			--Tell the player who triggerd the command that the player could not be found
			outputChatBox ( "Unable to change player tag: Player " .. thePlayer .. " not found", source )
	end		end
	end		end

AlienX: /* Example */

2007-08-03T07:56:28Z

Example

← Older revision		Revision as of 07:56, 3 August 2007
Line 28:		Line 28:
	end		end
	end		end
			--Add a command handler for either the console or / chat commands
			--Example: /changetag <playername> <tag>
	addCommandHandler ( "changetag", tagPlayer )		addCommandHandler ( "changetag", tagPlayer )
	</syntaxhighlight>		</syntaxhighlight>

AlienX: /* Example */

2007-08-03T07:55:22Z

Example

← Older revision		Revision as of 07:55, 3 August 2007
Line 17:		Line 17:
	This example adds a tag before a player's nick.		This example adds a tag before a player's nick.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function tagPlayer( thePlayer, tag )		function tagPlayer( command, thePlayer, tag )
	--we check thePlayer is a player, otherwise this function could be used with admins		--we check thePlayer is a player, otherwise this function could be used with admins
	if getElementType( thePlayer ) == "player" then		if getElementType( thePlayer ) == "player" then
Line 28:		Line 28:
	end		end
	end		end
			addCommandHandler ( "changetag", tagPlayer )
	</syntaxhighlight>		</syntaxhighlight>

	==See Also==		==See Also==
	{{Client_functions}}		{{Client_functions}}