RU/getBanNick: Difference between revisions

Revision as of 12:13, 9 September 2014

Эта функция возвращает ник игрока в указанном бане.

Синтаксис

string getBanNick ( ban theBan )

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

theBan: Элемент бана, из которого вы хотите получить ник.

Возвращает

Возвращает строку с ником в случае успеха, false, если аргументы указаны неверно или ник не указан в элементе бана.

Пример

Пример 1: Данный пример выводит имя игрока, админа, который забанил игрока и причину.

function outputBan(ban)
    local plr = getBanNick(ban) -- игрок, который был забанен
    local admin = getBanAdmin(ban) -- админ, который забанил игрока
    local reason = getBanReason(ban) -- причина бана
    if (plr and admin and reason) then
        outputChatBox(plr.." был забанен админом "..admin.." за "..reason, getRootElement(), 255, 0, 0) -- Выводит имя игрока, админа и причину бана
    end
end
addEventHandler("onBan", getRootElement(), outputBan) -- Вызывает функцию outputBan при бане любого игрока

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

Серверные функции

addBan — блокирует доступ по серийному номеру, IP адресу и / или нику
banPlayer — блокирует указанного игрока по серийному номеру, IP адресу и / или нику
getBanAdmin — возвращает ник администратора, ответственного за указанную блокировку
getBanIP — возвращает заблокированный IP адрес для указанной блокировки
getBanNick — возвращает ник заблокированного игрока для указанной блокировки
getBanReason — возвращает причину выдачи для указанной блокировки
getBans — возвращает таблицу выданных блокировок
getBanSerial — возвращает заблокированный серийный номер для указанной блокировки
getBanTime — возвращает время в секундах, прошедшее от 1.01.1970 до момента выдачи указанной блокировки
getBanUsername — возвращает ник заблокированного игрока для указанной блокировки (устарела)
getUnbanTime — возвращает время в секундах, прошедшее от 1.01.1970 до момента снятия указанной блокировки
isBan — проверка значение на соответствие типу ban
kickPlayer — исключает указанного игрока из игры
setBanAdmin — изменяет никнейм ответственного за блокировку администратора
setBanNick — изменяет никнейм игрока для указанной блокировки
setBanReason — изменяет причину указанной блокировки
setUnbanTime — изменяет время разблокировки для указанного игрока
removeBan — удаляет указанную блокировку
reloadBans — обновление данных о выданных блокировках из файла banlist.xml

@@ Line 1: / Line 1: @@
-{{Translate}}
 __NOTOC__
-{{Server function}}
+{{RU/Server function}}
-This function will return the nickname (nickname that the player had when he was banned) of the specified [[ban]] element.
+Эта функция возвращает ник игрока в указанном [[RU/Ban|бане]].
-==Syntax==
+==Синтаксис==
 <syntaxhighlight lang="lua">
 string getBanNick ( ban theBan )
 </syntaxhighlight>
-===Required Arguments===
+===Обязательные аргументы===
-*'''theBan:''' The [[ban]] element which nickname you want to return.
+*'''theBan:''' Элемент [[RU/Ban|бана]], из которого вы хотите получить ник.
-===Returns===
+===Возвращает===
-Returns a ''string'' of the nickname if everything was successfull, ''false'' if invalid arguments are specified if there was no nickname specified for the [[ban]] element.
+Возвращает ''строку'' с ником в случае успеха, ''false'', если аргументы указаны неверно или ник не указан в элементе [[RU/Ban|бана]].
 ==Пример==
-'''Example 1:''' This example outputs the name of the player, the admin who banned the player and the reason.
+'''Пример 1:''' Данный пример выводит имя игрока, админа, который забанил игрока и причину.
 <syntaxhighlight lang="lua">
 function outputBan(ban)
-     local plr = getBanNick(ban) -- the player who got banned
+     local plr = getBanNick(ban) -- игрок, который был забанен
-     local admin = getBanAdmin(ban) -- admin who banned the player
+     local admin = getBanAdmin(ban) -- админ, который забанил игрока
-     local reason = getBanReason(ban) -- reason for banning
+     local reason = getBanReason(ban) -- причина бана
      if (plr and admin and reason) then
-         outputChatBox(plr.." has been banned by "..admin.." for "..reason, getRootElement(), 255, 0, 0) -- Outputs name of the player, admin and the reason for banning
+         outputChatBox(plr.." был забанен админом "..admin.." за "..reason, getRootElement(), 255, 0, 0) -- Выводит имя игрока, админа и причину бана
      end
 end
-addEventHandler("onBan", getRootElement(), outputBan) -- When a player is banned trigger the outputBan function
+addEventHandler("onBan", getRootElement(), outputBan) -- Вызывает функцию outputBan при бане любого игрока
 </syntaxhighlight>
-==See Also==
+==Смотрите также==
 {{RU/Admin functions}}
 [[en:getBanNick]]