RU/getBanReason: Difference between revisions

Revision as of 12:20, 10 September 2014

Эта функция возвращает причину, по которой был забанен игрок.

Синтаксис

string getBanReason ( ban theBan )

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

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

Возвращения

Возвращает строку с причиной если всё успешно, 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: @@
-{{Server function}}
+__NOTOC__
-Эта функция возвращает причину, по которй был забанен игрок.
+{{RU/Server function}}
+Эта функция возвращает причину, по которой был забанен игрок.
-==Синтакс==
+==Синтаксис==
 <syntaxhighlight lang="lua">
 string getBanReason ( ban theBan )
 </syntaxhighlight>
-===Обязазтельные Аргументы===
+===Обязательные Аргументы===
 *'''theBan:''' [[Ban]], у которого вы хотите узнать причину.
@@ Line 14: / Line 15: @@
 ==Пример==
-'''Example 1:''' This example outputs the name of the player, the admin who banned the player and the reason.
+'''Пример 1:'''{{RU/Example/viewBanParameters}}
-<syntaxhighlight lang="lua">
-function outputBan(ban)
-    local plr = getBanNick(ban) -- the player who got banned
-    local admin = getBanAdmin(ban) -- admin who banned the player
-    local reason = getBanReason(ban) -- reason for banning
-    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
-    end
-end
-addEventHandler("onBan", getRootElement(), outputBan) -- When a player is banned trigger the outputBan function
-</syntaxhighlight>
 ==Смотрите также==
 {{RU/Admin functions}}
 [[en:getBanReason]]