RU/getBanReason: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{Server function}}
__NOTOC__
Эта функция возвращает причину, по которй был забанен игрок.
{{RU/Server function}}
Эта функция возвращает причину, по которой был забанен игрок.


==Синтакс==  
==Синтаксис==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string getBanReason ( ban theBan )
string getBanReason ( ban theBan )
</syntaxhighlight>
</syntaxhighlight>


===Обязазтельные Аргументы===  
===Обязательные аргументы===  
*'''theBan:''' [[Ban]], у которого вы хотите узнать причину.
*'''theBan:''' [[Бан]], у которого вы хотите узнать причину.


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


==Пример==
==Пример==
'''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}}
{{RU/Admin functions}}
[[en:getBanReason]]
[[en:getBanReason]]

Latest revision as of 22:08, 10 September 2014

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

Синтаксис

string getBanReason ( 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