RU/addBan

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.

Эта функция добавляет в бан лист определенный IP/username/serial.

Синтаксис

ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         

Note: Одно из трех: IP, Username или Serial должно быть указано.

Необходимые аргументы

• IP: IP-адрес который необходимо забанить. Если вы не хотите банить по IP, поставьте nil.

или

• Username: Имя пользователя которое необходимо забанить. Если вы не хотите банить по имени пользователя, поставьте nil.

или

• Serial: Серийный номер который необходимо забанить. Если вы не хотите банить по серийному номеру, поставьте nil.

или любая их комбинация.

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

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

• responsibleElement: The element that is responsible for banning the IP/username/serial. This can be a player or the root (getRootElement()).
• reason: The reason the IP/username/serial will be banned from the server.
• seconds: The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

Returns

Returns true if the IP/username/serial was banned succesfully, false if invalid arguments are specified.

Example

--TODO

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