RU/banPlayer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 25: Line 25:


===Необязательные аргументы===  
===Необязательные аргументы===  
{{RU\OptionalArg}}
{{RU/OptionalArg}}  
{{New feature|3|1.0|
{{New feature|3|1.0|
*'''IP:''' Забанить игрока по IP?
*'''IP:''' Забанить игрока по IP?

Revision as of 18:55, 10 August 2012

Эта функция дает бан игроку по IP, serial или имени.

Синтакс

ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )

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

  • bannedPlayer: Игрок, который должен быть забанен сервером.

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

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

  • IP: Забанить игрока по IP?
  • Username: Забанить игрока по имени?
  • Serial: Забанить игрока по serial?
Note: Что бы забанить игрока по имени или serial, verifyserials должна быть включена в серверном файле конфигурации.
  • responsibleElement: Элемент, который отвечает за бан игрока. Это может быть игрок или корневой элемент (getRootElement()).
  • reason: Нарушение, за которое нужно забанить игрока.
  • seconds: Количество секунд для бана игрока. Можеть быть 0 для бесконечного бана.

Возвращения

Возращает ban метку если игрок успешно забанен, или false если не успешно.

Пример

Этот пример банит кого-нибудь, если он имеет ACL права.

--Add the "ban" command handler
-- Example with the player
function banPlayerCommand ( theClient, commandName, bannedName, reason )

	-- Give the player a nice error if he doesn't have rights
	if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
		--Get player element from the name
		local bannedPlayer = getPlayerFromNick ( bannedName )

		--Ban the player
		banPlayer ( bannedPlayer, theClient, reason )
		outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

	else
		outputChatBox ( "ban: You don't have enough permissions", theClient )
	end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Example function with the root element. Here you would pass a player element to the function.
function banCheater(theCheater)
	banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
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