RU/getBanNick: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 15: Line 15:
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.
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.


==Example==
==Пример==
'''Example 1:''' This example outputs the name of the player, the admin who banned the player and the reason. 
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--TODO
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>
</syntaxhighlight>


==See Also==
==See Also==
{{RU/Admin functions}}
{{RU/Admin functions}}
[[Category:Needs Example]]
[[en:getBanNick]]
[[en:getBanNick]]

Revision as of 18:31, 18 January 2014

Warning.png This page requires local translation. If page will remain not translated in reasonable period of time it would be deleted.
After translating the page completely, please remove the ‎{{translate}}‎ tag from the page.


This function will return the nickname (nickname that the player had when he was banned) of the specified ban element.

Syntax

string getBanNick ( ban theBan )

Required Arguments

  • theBan: The ban element which nickname you want to return.

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.

Пример

Example 1: This example outputs the name of the player, the admin who banned the player and the reason.

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

See Also

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

  • 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