RU/unbanIP: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Translate}}
{{RU/Server function}}
{{Server function}}
{{RU/Deprecated|removeBan}}
{{Deprecated}}
Эта функция исключает из списка банов указанный IP.
Эта функция исключает из списка банов указанный IP.


Line 9: Line 8:
</syntaxhighlight>  
</syntaxhighlight>  


===Необходимые аргументы===
===Обязательные аргументы===
*'''ipToUnban:''' IP, который нужно разбанить.
*'''ipToUnban:''' IP, который нужно разбанить.
===Опциональные аргументы===
===Необязательные аргументы===
{{OptionalArg}}
{{RU/OptionalArg}}
*'''unbanningPlayer:''' Игрок, IP которого удаляется из списка банов. По умолчанию nil, то есть не один.
*'''unbanningPlayer:''' Игрок, IP которого удаляется из списка банов. По умолчанию nil, то есть не один.


===Вывод===
===Возвращает===
Возвращает ''true'' если операция успешна, ''false'' в противном случае.
Возвращает ''true'' если операция успешна, ''false'' в противном случае.


Line 46: Line 45:
end
end
</syntaxhighlight>
</syntaxhighlight>
==Смотри также==
==Смотрите также==
{{RU/Admin_functions}}
{{RU/Admin_functions}}
[[en:unbanIP]]
[[en:unbanIP]]

Latest revision as of 20:15, 29 September 2014


Emblem-important.png Эта функция устарела. Это означает, что её применение настоятельно не рекомендуется, и вполне возможно, что она перестанет существовать в последующих версиях.

Пожалуйста используйте вместо неё removeBan.

Эта функция исключает из списка банов указанный IP.

Синтаксис

bool unbanIP ( string ipToUnban, [player unbanningPlayer = nil] )         

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

  • ipToUnban: IP, который нужно разбанить.

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

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

  • unbanningPlayer: Игрок, IP которого удаляется из списка банов. По умолчанию nil, то есть не один.

Возвращает

Возвращает true если операция успешна, false в противном случае.

Пример

Этот пример добавляет администраторам команду unbanip(необходимо добавить разрешение в ACL).

addCommandHandler( "unbanip", -- добавляем команду 'unbanip' в обработчик
   function ( thePlayer, command, ip )
      if ( hasObjectPermissionTo ( thePlayer, "command.unbanip", false ) ) then -- проверяем, получал ли игрок доступ к команде
         if not ip then outputChatBox( "No IP specified.", thePlayer ) return end -- если не введен IP, останавливаем выполнение
         if not findpattern( ip, '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+', 1 ) then outputChatBox( "Given IP is not valid.", thePlayer ) return end -- если формат IP некорректен, останавливаем выполнение 
         local success = unbanIP( ip, thePlayer ) -- смотрим, была ли функция успешно выполнена
         if success then
            outputChatBox( "IP " .. ip .. " succesfully unbanned!", thePlayer ) -- если успешно, выводим в чат подтверждение
         else
            outputChatBox( "Unbanning IP " .. ip .. " failed!", thePlayer ) -- если нет, выводим ошибку
         end
      else
         outputChatBox( "You have no permission to use this command.", thePlayer ) -- выводим, что у игрока недостаточно прав
      end
   end
)

-- назначаем дополнительную функцию форматирования текста для обработчика
function findpattern(text, pattern, start)
	local found = string.find(text, pattern, start)
	if found ~= nil then
		return string.gsub(text, found)
	else return nil end
end

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

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

  • 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