RU/kickPlayer: Difference between revisions

Revision as of 17:09, 11 January 2012

This page requires local translation. If page will remain not translated in reasonable period of time it would be deleted.

After translating the page completely, please remove the ‎{{translate}}‎ tag from the page.

Эта функция кикает (т.е. выбрасывает игрока из сервера)

Синтаксис

bool kickPlayer ( игрок kickedPlayer , [ игрок responsiblePlayer , строка reason ] )

Нужные аргументы

kickedPlayer: Игрок, которого кикать

Аргументы на выбор

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

responsiblePlayer: Человек, вызвавший кик другого игрока
reason: Причина кика

Возврашения

Возвращает правду, если игрок был успешно кинут, и ложь если были ошибки

Пример

Данный код позволяет кикнуть выбранного игрока, если вызывающий игрок имеет доступ к кику (админы, модераторы)

function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
	-- Получить игрока из kickedname (чтобы кикнуть игрока)
	local kicked = getPlayerFromNick ( kickedname )
	-- Если вызвавший функцию имеет доступ к кику
	if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
		-- кикнуть игрока
		kickPlayer ( kicked, sourcePlayer, reason )
	end
end
-- Добавляем комманду для кика (функция kickPlayerHandler)
addCommandHandler ( "kick", kickPlayerHandler )

Так же поможет

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

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

@@ Line 2: / Line 2: @@
 {{Server function}}
 __NOTOC__
-This function will kick the specified player from the server.
+Эта функция кикает (т.е. выбрасывает игрока из сервера)
-==Syntax==
+==Синтаксис==
 <syntaxhighlight lang="lua">
-bool kickPlayer ( player kickedPlayer , [ player responsiblePlayer , string reason ] )
+bool kickPlayer ( игрок kickedPlayer , [ игрок responsiblePlayer , строка reason ] )
 </syntaxhighlight>
-===Required Arguments===
+===Нужные аргументы===
-*'''kickedPlayer:''' The player that will be kicked from the server
+*'''kickedPlayer:''' Игрок, которого кикать
-===Optional Arguments===
+===Аргументы на выбор===
 {{OptionalArg}}
-*'''responsiblePlayer:''' The player that is responsible for the event
+*'''responsiblePlayer:''' Человек, вызвавший кик другого игрока
-*'''reason:''' The reason for the kick
+*'''reason:''' Причина кика
-===Returns===
+===Возврашения===
-Returns ''true'' if the player was kicked succesfully, ''false'' if invalid arguments are specified.
+Возвращает правду, если игрок был успешно кинут, и ложь если были ошибки
-==Example==
+==Пример==
-This example lets a player kick anyone who has a lower level.
+Данный код позволяет кикнуть выбранного игрока, если вызывающий игрок имеет доступ к кику (админы, модераторы)
 <syntaxhighlight lang="lua">
 function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-	-- Get player element from the name
+	-- Получить игрока из kickedname (чтобы кикнуть игрока)
 	local kicked = getPlayerFromNick ( kickedname )
-	-- If the client who sent the command has a higher level
+	-- Если вызвавший функцию имеет доступ к кику
 	if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-		-- Kick the player
+		-- кикнуть игрока
 		kickPlayer ( kicked, sourcePlayer, reason )
 	end
 end
--- Add the "kick" command handler
+-- Добавляем комманду для кика (функция kickPlayerHandler)
 addCommandHandler ( "kick", kickPlayerHandler )
 </syntaxhighlight>
-==See Also==
+==Так же поможет==
 {{RU/Admin_functions}}
 [[en:kickPlayer]]