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: Причина по которой IP/username/serial будут забанены.
• seconds: Время в течение которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным).

Returns

Возвращает true если IP/username/serial были успешно забанены, false если введены неверные аргументы.

Пример

--TODO

См. также

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

• 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