RU/addBan: Difference between revisions

Latest revision as of 03:06, 1 April 2016

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

Синтаксис

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

[[{{{image}}}\|link=\|]]	Примечание: Одно из трех: IP, Username или Serial должно быть указано.

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

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

или

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

или

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

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

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

Примечание. При использовании необязательных аргументов Вам может потребоваться предоставить все аргументы перед тем аргументом, который Вы хотите использовать. Для более подробной информации ознакомьтесь с необязательными аргументами.

responsibleElement: Элемент который отвечает за бан игрока. Это может быть игрок или корневой элемент (RU/getRootElement()).
reason: Причина, по которой IP/username/serial будут забанены.
seconds: Время в течении которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным).

Возвращает

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

Пример

----Если человек умирает, баним его по IP:
function AddBanFunction ()
addBan (getPlayerIP ( source ))
end
addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )

----Если человек умирает, баним его по Serial:
function AddBanFunction ()
addBan (getPlayerSerial ( source ))
end
addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )

Смотрите также

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

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

@@ Line 1: / Line 1: @@
-{{Translate}}
+__NOTOC__
-{{Server function}}
+{{RU/Server function}}
-This function will add a ban for the specified IP/username/serial to the server.
+Эта функция добавляет в бан лист определенный IP/имя пользователя/серийный номер.
-==Syntax==
+==Синтаксис==
 <syntaxhighlight lang="lua">
 ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )
 </syntaxhighlight>
-'''Note:''' One of the three: IP, Username or Serial have to be specified.
-===Required Arguments===
+{{RU/Note| Одно из трех: IP, Username или Serial должно быть указано.}}
-*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.
-'''or'''
-*'''Username:''' The username to be banned. If you don't want to ban by username, set this to ''nil''.
-'''or'''
-*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.
-''' or any combination.'''
-===Optional Arguments===
+===Обязательные аргументы===
-{{OptionalArg}}
+*'''IP:''' IP-адрес который необходимо забанить. Если вы не хотите банить по IP, поставьте ''nil''.
-*'''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.
+*'''Username:''' Имя пользователя на [http://community.mtasa.com/ MTA Community], которое необходимо забанить. Если вы не хотите банить по имени пользователя, поставьте ''nil''.
-*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.
+'''или'''
+*'''Serial:''' Серийный номер, который необходимо забанить. Если вы не хотите банить по серийному номеру, поставьте ''nil''.
+''' или любая их комбинация.'''
-===Returns===
+===Необязательные аргументы===
-Returns ''true'' if the IP/username/serial was banned succesfully, ''false'' if invalid arguments are specified.
+{{RU/OptionalArg}}
+*'''responsibleElement:''' Элемент который отвечает за бан игрока. Это может быть игрок или корневой элемент ([[RU/getRootElement]]()).
+*'''reason:''' Причина, по которой IP/username/serial будут забанены.
+*'''seconds:''' Время в течении которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным).
-==Example==
+===Возвращает===
+Возвращает ''true'' если IP/username/serial были успешно забанены, ''false'' если введены неверные аргументы.
+==Пример==
+<syntaxhighlight lang="lua">
+----Если человек умирает, баним его по IP:
+function AddBanFunction ()
+addBan (getPlayerIP ( source ))
+end
+addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )
+</syntaxhighlight>
 <syntaxhighlight lang="lua">
---TODO
+----Если человек умирает, баним его по Serial:
+function AddBanFunction ()
+addBan (getPlayerSerial ( source ))
+end
+addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )
 </syntaxhighlight>
-==See Also==
+==Смотрите также==
 {{RU/Admin functions}}
-[[Category:Needs Example]]
 [[en:addBan]]