RU/addBan: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Reverted edits by Bonzo (talk) to last revision by MeowCola)
 
(14 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Translate}}
__NOTOC__
{{Server function}}
{{RU/Server function}}
Эта функция добавляет в бан лист определенный IP/username/serial.
Эта функция добавляет в бан лист определенный IP/имя пользователя/серийный номер.


==Синтаксис==  
==Синтаксис==  
Line 7: Line 7:
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )         
</syntaxhighlight>
</syntaxhighlight>
'''Note:''' Одно из трех: IP, Username или Serial должно быть указано.


===Необходимые аргументы===  
{{RU/Note| Одно из трех: IP, Username или Serial должно быть указано.}}
 
===Обязательные аргументы===  
*'''IP:''' IP-адрес который необходимо забанить. Если вы не хотите банить по IP, поставьте ''nil''.
*'''IP:''' IP-адрес который необходимо забанить. Если вы не хотите банить по IP, поставьте ''nil''.
'''или'''
'''или'''
*'''Username:''' Имя пользователя которое необходимо забанить. Если вы не хотите банить по имени пользователя, поставьте ''nil''.
*'''Username:''' Имя пользователя на [http://community.mtasa.com/ MTA Community], которое необходимо забанить. Если вы не хотите банить по имени пользователя, поставьте ''nil''.
'''или'''
'''или'''
*'''Serial:''' Серийный номер который необходимо забанить. Если вы не хотите банить по серийному номеру, поставьте ''nil''.
*'''Serial:''' Серийный номер, который необходимо забанить. Если вы не хотите банить по серийному номеру, поставьте ''nil''.
''' или любая их комбинация.'''
''' или любая их комбинация.'''


===Необязательные аргументы===  
===Необязательные аргументы===  
{{RU/OptionalArg}}  
{{RU/OptionalArg}}  
*'''responsibleElement:''' The element that is responsible for banning the IP/username/serial. This can be a player or the root ([[getRootElement]]()).
*'''responsibleElement:''' Элемент который отвечает за бан игрока. Это может быть игрок или корневой элемент ([[RU/getRootElement]]()).
*'''reason:''' Причина по которой IP/username/serial будут забанены.
*'''reason:''' Причина, по которой IP/username/serial будут забанены.
*'''seconds:''' Время в течение которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным).
*'''seconds:''' Время в течении которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным).


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


==Пример==
==Пример==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--TODO
----Если человек умирает, баним его по IP:
function AddBanFunction ()
addBan (getPlayerIP ( source ))
end
addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )
</syntaxhighlight>
<syntaxhighlight lang="lua">
----Если человек умирает, баним его по Serial:
function AddBanFunction ()
addBan (getPlayerSerial ( source ))
end
addEventHandler ("onPlayerWasted",getRootElement(),AddBanFunction )
</syntaxhighlight>
</syntaxhighlight>


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

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