KickPlayer: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(removed the note about optional parameters, as this is exactly wrong for kickPlayer) |
||
| Line 16: | Line 16: | ||
===Optional Arguments=== | ===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). | *'''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. | *'''reason:''' The reason for the kick. | ||
Revision as of 01:38, 7 October 2012
This function will kick the specified player from the server.
Syntax
bool kickPlayer ( player kickedPlayer, [ player responsiblePlayer, string reason = "" ] )
or
bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )
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.
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, reason ) -- Get player element from the name local kicked = getPlayerFromName ( 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 addCommandHandler ( "kick", kickPlayerHandler )