RU/addBan: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Server function}} | {{RU/Server function}} | ||
Эта функция добавляет в бан лист определенный IP/username/serial. | Эта функция добавляет в бан лист определенный IP/username/serial. | ||
| Line 6: | Line 6: | ||
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> | ||
{{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:''' Элемент который отвечает за бан игрока. Это может быть игрок или корневой элемент ([[getRootElement]]()). | *'''responsibleElement:''' Элемент который отвечает за бан игрока. Это может быть игрок или корневой элемент ([[RU/getRootElement]]()). | ||
*'''reason:''' Причина по которой IP/username/serial будут забанены. | *'''reason:''' Причина, по которой IP/username/serial будут забанены. | ||
*'''seconds:''' Время в | *'''seconds:''' Время в течении которого игрок будет забанен. Если 0 то бан будет бессрочным(вечным). | ||
===Возвращает=== | ===Возвращает=== | ||
| Line 27: | Line 27: | ||
==Пример== | ==Пример== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
----Если человек | ----Если человек умирает,баним его по IP: | ||
function AddBanFunction () | function AddBanFunction () | ||
addBan (getPlayerIP ( source )) | addBan (getPlayerIP ( source )) | ||
| Line 34: | Line 34: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
----Если человек | ----Если человек умирает,баним его по Serial: | ||
function AddBanFunction () | function AddBanFunction () | ||
addBan (getPlayerSerial ( source )) | addBan (getPlayerSerial ( source )) | ||
Revision as of 15:58, 8 September 2014
Эта функция добавляет в бан лист определенный IP/username/serial.
Синтаксис
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )
Template:RU/Note Одно из трех: 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