KickPlayer: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
This function will kick the specified player from the server. | This function will kick the specified player from the server. | ||
Line 10: | Line 8: | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''kickedPlayer:''' The player that will be kicked from the server | ||
===Optional Arguments=== | ===Optional Arguments=== | ||
Line 21: | Line 19: | ||
==Example== | ==Example== | ||
This example | This example lets a player kick anyone who has a lower level. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | --Add the "kick" command handler | ||
addCommandHandler ( "kick", "kickPlayer" ) | |||
-- | function kickPlayer ( player, commandname, kickedname, reason ) | ||
--Get player element from the name | |||
local kicked = getPlayerFromNick ( kickedname ) | |||
--If the client who sent the command has a higher level | |||
if getClientLevel ( player ) > getClientLevel ( kicked ) then | |||
--Kick the player | |||
kickPlayer ( kicked, source, reason ) | |||
end | |||
end | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{Admin_functions}} |
Revision as of 16:58, 11 January 2007
This function will kick the specified player from the server.
Syntax
bool kickPlayer ( player kickedPlayer , [ player responsiblePlayer , string reason ] )
Required Arguments
- kickedPlayer: The player that will be kicked from the server
Optional Arguments
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: The player that is responsible the event
- reason: The reason the player will be kicked from the server
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.
--Add the "kick" command handler addCommandHandler ( "kick", "kickPlayer" ) function kickPlayer ( player, commandname, kickedname, reason ) --Get player element from the name local kicked = getPlayerFromNick ( kickedname ) --If the client who sent the command has a higher level if getClientLevel ( player ) > getClientLevel ( kicked ) then --Kick the player kickPlayer ( kicked, source, reason ) end end
See Also
- addBan
- banPlayer
- getBanAdmin
- getBanIP
- getBanNick
- getBanReason
- getBanSerial
- getBanTime
- getBanUsername
- getBans
- getUnbanTime
- isBan
- kickPlayer
- setBanAdmin
- setBanNick
- setBanReason
- setUnbanTime
- reloadBans
- removeBan