RU/setPlayerName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with '{{RU/Server function}} __NOTOC__ Эта функция изменяет имя указанного игрока (player). ==Синтаксис== <syntaxhighlight lang="lua"> bool setPl…')
 
m (Перевод примера)
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>

Revision as of 08:46, 14 July 2010

Эта функция изменяет имя указанного игрока (player).

Синтаксис

bool setPlayerName ( player thePlayer, string newName )

Обязательные аргументы

  • thePlayer: игрок, которому нужно изменить имя.
  • newName: устанавливаемое имя.

Вывод

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

Пример

Click to collapse [-]
Server

Этот пример позволяет добавлять перед именем игрока дополнительный текст по команде /changetag


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

Смотрите также