RU/getBanNick: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(New page: {{Translate}} __NOTOC__ {{Server function}} This function will return the nickname (nickname that the player had when he was banned) of the specified ban element. ==Syntax== <syntaxhighlight lang="lua">[...)
 
mNo edit summary
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Translate}}
__NOTOC__  
__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.
Эта функция возвращает ник игрока в указанном бане.


==Syntax==  
==Синтаксис==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string getBanNick ( ban theBan )
string getBanNick ( ban theBan )
</syntaxhighlight>
</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==
==Пример==
<syntaxhighlight lang="lua">
'''Пример 1:''' {{RU/Example/viewBanParameters}}
--TODO
</syntaxhighlight>


==See Also==
==Смотрите также==
{{Admin functions}}
{{RU/Admin functions}}
[[Category:Needs Example]]
[[en:getBanNick]]
[[en:getBanNick]]

Latest revision as of 13:59, 10 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