KickPlayer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(33 intermediate revisions by 21 users not shown)
Line 1: Line 1:
__NOTOC__  
{{note| Don't forget to give admin rights to the resource, in which you are using kickPlayer function or it won't work.}}
 
{{Server function}}
__NOTOC__
This function will kick the specified player from the server.
This function will kick the specified player from the server.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer , [ player responsiblePlayer , string reason ] )         
bool kickPlayer ( player kickedPlayer, [ player/string responsiblePlayer, string reason = "" ] )         
</syntaxhighlight>  
</syntaxhighlight>
 
''or''
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )
</syntaxhighlight>
{{OOP||[[player]]:kick||}}
===Required Arguments===  
===Required Arguments===  
*'''kickedPlayer:''' The player that will be kicked from the server
*'''kickedPlayer:''' The player that will be kicked from the server


===Optional Arguments===  
===Optional Arguments===  
{{OptionalArg}}
*'''responsiblePlayer:''' The player that is responsible for the event. '''Note''': If left out as in the second syntax, responsible player for the kick will be "Console" (Maximum 30 characters if using a string).
*'''responsiblePlayer:''' The player that is responsible the event
*'''reason:''' The reason for the kick. (Maximum 64 characters before 1.5.8, Maximum 128 characters after 1.5.8)
*'''reason:''' The reason the player will be kicked from the server


===Returns===
===Returns===
Line 21: Line 27:
This example lets a player kick anyone who has a lower level.
This example lets a player kick anyone who has a lower level.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--Add the "kick" command handler
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, ... )
addCommandHandler ( "kick", "kickPlayer" )
-- Get player element from the name
function kickPlayer ( player, commandname, kickedname, reason )
local kicked = getPlayerFromName ( kickedname )
--Get player element from the name
-- If the client who sent the command has a higher level
local kicked = getPlayerFromNick ( kickedname )
        local reason = table.concat({...}, " ")
--If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
if getClientLevel ( player ) > getClientLevel ( kicked ) then
-- Kick the player
--Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
kickPlayer ( kicked, source, reason )
end
end
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Admin_functions}}
{{Admin_functions}}
[[es:kickPlayer]]
[[ru:kickPlayer]]

Latest revision as of 00:17, 7 March 2021

[[{{{image}}}|link=|]] Note: Don't forget to give admin rights to the resource, in which you are using kickPlayer function or it won't work.

This function will kick the specified player from the server.

Syntax

bool kickPlayer ( player kickedPlayer, [ player/string responsiblePlayer, string reason = "" ] )         

or

bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )

OOP Syntax Help! I don't understand this!

Method: player:kick(...)


Required Arguments

  • kickedPlayer: The player that will be kicked from the server

Optional Arguments

  • responsiblePlayer: The player that is responsible for the event. Note: If left out as in the second syntax, responsible player for the kick will be "Console" (Maximum 30 characters if using a string).
  • reason: The reason for the kick. (Maximum 64 characters before 1.5.8, Maximum 128 characters after 1.5.8)

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.

function kickPlayerHandler ( sourcePlayer, commandname, kickedname, ... )
	-- Get player element from the name
	local kicked = getPlayerFromName ( kickedname )
	-- If the client who sent the command has a higher level
        local reason = table.concat({...}, " ")
	if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
		-- Kick the player
		kickPlayer ( kicked, sourcePlayer, reason )
	end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )

See Also