RU/unbanIP: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(New page: {{Translate}} {{Server function}} {{Deprecated}} This function will unban the specified IP. ==Syntax== <syntaxhighlight lang="lua"> bool unbanIP ( string ipToUnban, [player unbanningPlayer = nil] ) ...)
 
mNo edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Translate}}
{{RU/Server function}}
{{Server function}}
{{RU/Deprecated|removeBan}}
{{Deprecated}}
Эта функция исключает из списка банов указанный IP.
This function will unban the specified IP.


==Syntax==  
==Синтаксис==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool unbanIP ( string ipToUnban, [player unbanningPlayer = nil] )         
bool unbanIP ( string ipToUnban, [player unbanningPlayer = nil] )         
</syntaxhighlight>  
</syntaxhighlight>  


===Required Arguments===
===Обязательные аргументы===
*'''ipToUnban:''' The IP that should be unbanned.
*'''ipToUnban:''' IP, который нужно разбанить.
===Optional Arguments===
===Необязательные аргументы===
{{OptionalArg}}
{{RU/OptionalArg}}
*'''unbanningPlayer:''' The player who is unbanning the IP. Defaults to nil, meaning no one.
*'''unbanningPlayer:''' Игрок, IP которого удаляется из списка банов. По умолчанию nil, то есть не один.


===Returns===
===Возвращает===
Returns ''true'' if the unban was successful, ''false'' otherwise.
Возвращает ''true'' если операция успешна, ''false'' в противном случае.


==Example==
==Пример==
This example adds a unbanip command for only admins to use (uses a ACL permission check).
Этот пример добавляет администраторам команду unbanip(необходимо добавить разрешение в ACL).
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler( "unbanip", -- add a command handler to command 'unbanip'
addCommandHandler( "unbanip", -- добавляем команду 'unbanip' в обработчик
   function ( thePlayer, command, ip )
   function ( thePlayer, command, ip )
       if ( hasObjectPermissionTo ( thePlayer, "command.unbanip", false ) ) then -- check if the player has access to the command (specified in ACL)
       if ( hasObjectPermissionTo ( thePlayer, "command.unbanip", false ) ) then -- проверяем, получал ли игрок доступ к команде
         if not ip then outputChatBox( "No IP specified.", thePlayer ) return end -- if no IP was specified, abort command
         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 -- if IP is not in correct format, abort command
         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 ) -- see whether the function was a success
         local success = unbanIP( ip, thePlayer ) -- смотрим, была ли функция успешно выполнена
         if success then
         if success then
             outputChatBox( "IP " .. ip .. " succesfully unbanned!", thePlayer ) -- if it was, tell that to player
             outputChatBox( "IP " .. ip .. " succesfully unbanned!", thePlayer ) -- если успешно, выводим в чат подтверждение
         else
         else
             outputChatBox( "Unbanning IP " .. ip .. " failed!", thePlayer ) -- if it wasn't, tell that to player
             outputChatBox( "Unbanning IP " .. ip .. " failed!", thePlayer ) -- если нет, выводим ошибку
         end
         end
       else
       else
         outputChatBox( "You have no permission to use this command.", thePlayer ) -- tell player that he hasn't got right permission
         outputChatBox( "You have no permission to use this command.", thePlayer ) -- выводим, что у игрока недостаточно прав
       end
       end
   end
   end
)
)


-- specify the findpattern function used in the command handler
-- назначаем дополнительную функцию форматирования текста для обработчика
function findpattern(text, pattern, start)
function findpattern(text, pattern, start)
local found = string.find(text, pattern, start)
local found = string.find(text, pattern, start)
Line 46: Line 45:
end
end
</syntaxhighlight>
</syntaxhighlight>
==See Also==
==Смотрите также==
{{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
Retrieved from "https://wiki.multitheftauto.com/wiki/RU/unbanIP?oldid=42419"