RU/setPlayerName - Revision history

MeowCola at 17:05, 19 September 2014

2014-09-19T17:05:51Z

← Older revision		Revision as of 17:05, 19 September 2014
Line 23:		Line 23:
	* Минимальная длина имени игрока - 1 символ.		* Минимальная длина имени игрока - 1 символ.
	* Максимальная длина имени игрока - 22 символа.		* Максимальная длина имени игрока - 22 символа.
	* Имена игроков чувствительны к регистру. Невозможно, чтобы ~~было~~ два клиента с одинаковым именем, но с разным регистром.		* Имена игроков чувствительны к регистру. Невозможно, чтобы два клиента с одинаковым именем, но с разным регистром, были подключены к одному серверу.

	==Пример==		==Пример==

MeowCola at 15:23, 19 September 2014

2014-09-19T15:23:15Z

← Older revision		Revision as of 15:23, 19 September 2014
Line 1:		Line 1:
	{{RU/Server function}}		__NOTOC__
	~~__NOTOC__~~		{{RU/Server function}}
	~~Эта~~ функция изменяет имя указанного ~~игрока (~~[[~~player~~]]).		Данная функция изменяет имя указанного [[игрок\|игрока]].

	==Синтаксис==		==Синтаксис==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool setPlayerName ( player thePlayer, string newName )		bool setPlayerName ( player thePlayer, string newName )
	</syntaxhighlight>		</syntaxhighlight>

			{{RU/OOP\|\|[[player]]:setName\|name\|getPlayerName}}

	===Обязательные аргументы===		===Обязательные аргументы===
	*'''thePlayer:''' [[~~player\|игрок~~]], которому нужно изменить имя.		*'''thePlayer:''' [[Игрок]], которому нужно изменить имя.
	*'''newName:''' устанавливаемое имя.		*'''newName:''' Новое имя, устанавливаемое игроку.

			===Возвращает===
			* ''true'', если имя было успешно изменено.
			* ''false'', если были переданы неверные аргументы.

	===~~Вывод~~===		===Ограничения===
	~~Возвращает~~ '~~'true'' если имя~~ было ~~успешно изменено~~, ~~''false'' если были переданы некорректные аргументы~~.		* Допускаются только символы ASCII между 33 и 126 (базовая латиница):
			<nowiki>!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{\|}~</nowiki>
			* Минимальная длина имени игрока - 1 символ.
			* Максимальная длина имени игрока - 22 символа.
			* Имена игроков чувствительны к регистру. Невозможно, чтобы было два клиента с одинаковым именем, но с разным регистром.

	==Пример==		==Пример==
	~~<section name="Server" class="server" show="true">~~		Этот пример добавляет тэг перед именем игрока при помощи команды /changetag
	Этот пример ~~позволяет добавлять~~ перед именем игрока ~~дополнительный текст по команде~~ /changetag
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

	-- ~~Определяем функцию~~ для команды (/changetag~~, она определена далее)~~		-- Определение функции для команды /changetag
	-- source = игрок, который вызвал команду		-- source = игрок, который вызвал эту команду
	-- command = команда~~, передаваемая~~ в функцию (changetag)		-- command = команда переданная в функцию (changetag)
	-- thePlayer = игрок, ~~перед именем которого будет добавлен текст~~		-- thePlayer = игрок, которому вы хотите добавить тэг
	-- tag = ~~текст~~, ~~добавляемый перед именем~~		-- tag = тэг, который нужно добавить к нику игрока
	function tagPlayer ( source, command, thePlayer, tag )		function tagPlayer ( source, command, thePlayer, tag )
	--Попытка получить элемент из имени.		-- Попытка получить элемент игрока по указанному имени.
	local sPlayerElement = getPlayerFromName ( thePlayer )		local sPlayerElement = getPlayerFromName ( thePlayer )
	-- Проверка, существует ~~ли такой игрок~~.		-- Проверка на то, что игрок с указанным именем существует.
	if ( sPlayerElement ) then		if ( sPlayerElement ) then
	-- ~~Проверка~~, ~~имеет ли полученный элемент~~ тип ~~[[player]]~~		-- убедимся, что тип элемента thePlayer указывает на игрока
	if getElementType ( sPlayerElement ) == "player" then		if getElementType ( sPlayerElement ) == "player" then
	-- ~~сохраняем~~ текущее имя ~~игрока~~,		-- сохраним текущее имя игрокаwe,
	local oldName = getPlayerName ( sPlayerElement )		local oldName = getPlayerName ( sPlayerElement )
	-- ~~добавляем перед ним переданный в функцию текст~~		-- применим тэг вначале ника
	local taggedName = tag .. oldName		local taggedName = tag .. oldName
	-- затем ~~устанавливаем полученную строку в качестве нового имени игрока~~		-- затем установим новое имя
	setPlayerName ( sPlayerElement, taggedName )		setPlayerName ( sPlayerElement, taggedName )
	-- ~~Сообщаем~~ игроку, ~~вызвавшему~~ команду, что ~~она выполена успешно~~		-- Скажем игроку, который вызвал команду, что тэг был применён
	outputChatBox ( "~~Player~~ " .. thePlayer .. "~~'s tag changed to~~ " .. taggedName, source )		outputChatBox ( "Тэг игрока" .. thePlayer .. " изменён на " .. taggedName, source )
	end		end
	else		else
	-- ~~Сообщаем~~ игроку, ~~вызвавшему~~ команду, что не ~~найден игрок для замены имени~~		-- Скажем игроку, который вызвал команду, что указанный игрок не подключен
	outputChatBox ( "~~Unable to change player tag~~: ~~Player~~ " .. thePlayer .. " ~~not found~~", source )		outputChatBox ( "Нельзя сменить тэг игроку: Игрок " .. thePlayer .. " не найден", source )
	end		end
	end		end
	-- ~~Добавляем обработчик~~ команды ~~для консоли/чата~~		-- Добавление обработчика команды
	-- Пример: /changetag <~~имя~~> <~~текст~~>		-- Пример: /changetag <playername> <tag>
	addCommandHandler ( "changetag", tagPlayer )		addCommandHandler ( "changetag", tagPlayer )
	</syntaxhighlight>		</syntaxhighlight>
	~~</section>~~

	==Смотрите также==		==Смотрите также==
	{{RU/Player functions}}		{{RU/Player functions}}

	[[en:setPlayerName]]		[[en:setPlayerName]]

KGB: Перевод примера

2010-07-14T08:46:11Z

Перевод примера

← Older revision		Revision as of 08:46, 14 July 2010
Line 20:		Line 20:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

	-- ~~Define the function for this command~~ (/changetag, ~~as defined below~~)		-- Определяем функцию для команды (/changetag, она определена далее)
	-- source = ~~the player that triggered this command~~		-- source = игрок, который вызвал команду
	-- command = ~~the command passed into the function~~ (changetag)		-- command = команда, передаваемая в функцию (changetag)
	-- thePlayer = ~~the player that you wish to add a tag to~~		-- thePlayer = игрок, перед именем которого будет добавлен текст
	-- tag = ~~the tag to add to the players nickname~~		-- tag = текст, добавляемый перед именем
	function tagPlayer ( source, command, thePlayer, tag )		function tagPlayer ( source, command, thePlayer, tag )
	-- ~~Attempt to grab the element id for the player from the parsed name~~.		--Попытка получить элемент из имени.
	local sPlayerElement = ~~getPlayerFromNick~~ ( thePlayer )		local sPlayerElement = getPlayerFromName ( thePlayer )
	-- ~~Check to see if the player were changing the tag for exists~~.		-- Проверка, существует ли такой игрок.
	if ( sPlayerElement ) then		if ( sPlayerElement ) then
	-- ~~make sure that the element type of thePlayer is acctually pointing to a~~ player ~~element~~		-- Проверка, имеет ли полученный элемент тип [[player]]
	if getElementType ( sPlayerElement ) == "player" then		if getElementType ( sPlayerElement ) == "player" then
	-- ~~we store the player's current name~~,		-- сохраняем текущее имя игрока,
	local oldName = getPlayerName ( sPlayerElement )		local oldName = getPlayerName ( sPlayerElement )
	-- ~~append the tag passed to this function before it~~		-- добавляем перед ним переданный в функцию текст
	local taggedName = tag .. oldName		local taggedName = tag .. oldName
	-- ~~then set it as his new name~~		-- затем устанавливаем полученную строку в качестве нового имени игрока
	setPlayerName ( sPlayerElement, taggedName )		setPlayerName ( sPlayerElement, taggedName )
	-- ~~Tell the player who triggerd the command that the tag has been applied~~		-- Сообщаем игроку, вызвавшему команду, что она выполена успешно
	outputChatBox ( "Player " .. thePlayer .. "'s tag changed to " .. taggedName, source )		outputChatBox ( "Player " .. thePlayer .. "'s tag changed to " .. taggedName, source )
	end		end
	else		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 )		outputChatBox ( "Unable to change player tag: Player " .. thePlayer .. " not found", source )
	end		end
	end		end
	-- ~~Add a command handler for either the console or~~ / ~~chat commands~~		-- Добавляем обработчик команды для консоли/чата
	-- ~~Example~~: /changetag <~~playername~~> <~~tag~~>		-- Пример: /changetag <имя> <текст>
	addCommandHandler ( "changetag", tagPlayer )		addCommandHandler ( "changetag", tagPlayer )
	</syntaxhighlight>		</syntaxhighlight>

Damage22: Created page with '{{RU/Server function}} NOTOC Эта функция изменяет имя указанного игрока (player). ==Синтаксис== bool setPl…'

2010-07-09T14:32:37Z

Created page with '{{RU/Server function}} __NOTOC__ Эта функция изменяет имя указанного игрока (player). ==Синтаксис== <syntaxhighlight lang="lua"> bool setPl…'

New page

{{RU/Server function}}
__NOTOC__
Эта функция изменяет имя указанного игрока ([[player]]).

==Синтаксис==
<syntaxhighlight lang="lua">
bool setPlayerName ( player thePlayer, string newName )
</syntaxhighlight>

===Обязательные аргументы===
*'''thePlayer:''' [[player|игрок]], которому нужно изменить имя.
*'''newName:''' устанавливаемое имя.

===Вывод===
Возвращает ''true'' если имя было успешно изменено, ''false'' если были переданы некорректные аргументы.

==Пример==
<section name="Server" class="server" show="true">
Этот пример позволяет добавлять перед именем игрока дополнительный текст по команде /changetag
<syntaxhighlight lang="lua">

-- Define the function for this command (/changetag, as defined below)
-- source = the player that triggered this command
-- command = the command passed into the function (changetag)
-- thePlayer = the player that you wish to add a tag to
-- tag = the tag to add to the players nickname
function tagPlayer ( source, command, thePlayer, tag )
-- Attempt to grab the element id for the player from the parsed name.
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 = getPlayerName ( sPlayerElement )
-- append the tag passed to this function before it
local taggedName = tag .. oldName
-- then set it as his new name
setPlayerName ( 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
-- Add a command handler for either the console or / chat commands
-- Example: /changetag <playername> <tag>
addCommandHandler ( "changetag", tagPlayer )
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Player functions}}
[[en:setPlayerName]]

RU/setPlayerName - Revision history

MeowCola at 17:05, 19 September 2014

MeowCola at 15:23, 19 September 2014

KGB: Перевод примера

Damage22: Created page with '{{RU/Server function}} __NOTOC__ Эта функция изменяет имя указанного игрока (player). ==Синтаксис== bool setPl…'

Damage22: Created page with '{{RU/Server function}} NOTOC Эта функция изменяет имя указанного игрока (player). ==Синтаксис== bool setPl…'