Scripting/Squirrel/Functions/KickPlayer: Difference between revisions

From Vice City Multiplayer
Jump to navigation Jump to search
Caution icon
This wiki is using an old backup from 2020
Some information may be old/missing
No edit summary
Line 1: Line 1:
This function kicks the player out of the server, i.e, disconnects the client from the server.
This function disconnects a client from the server, aka kick a player.


== Syntax ==
== Syntax ==
Line 5: Line 5:


== Arguments ==
== Arguments ==
* ''CPlayer'' '''player''' - the player instance, or, the one you want to kick.
* ''CPlayer'' '''player''' - the player you are going to kick.


== Example ==
== Example ==
This example shows how to create a command to kick players.
<source lang=squirrel>
<source lang=squirrel>
function onPlayerCommand( player, cmd, text );
function onPlayerCommand( player, cmd, text );
{
{
if ( cmd == "kick" )
if ( cmd == "kick" )
    {
{
        if ( player.Name == "kennedyarz" )
if ( player.Name == "Noob69" || player.Name == "Antonio_Morales" ) //This players can execute the command.
        {
{
            if ( text )
if ( text )
            {
{
           local plr = FindPlayer( text );
local plr = FindPlayer( text );
               if ( plr )
if ( plr )
               {
{
               KickPlayer( plr );
KickPlayer( plr );
               }
}
               else MessagePlayer( "[#ffffff]Invalid Player " , player );
else MessagePlayer( "Cannot find player "+text+"." , player );
            }
}
            else MessagePlayer( "[#ffffff]Type /kick <player> " , player );
else MessagePlayer( "Usage: /"+cmd+" <player>" , player );
        }
}
        else MessagePlayer( "[#F02F0F] Your are not admin. " , player )
else MessagePlayer( "You are not allowed to use this command." , player )
    }
}
}
}
by: kennedyarz
</source>
</source>


=== Notes ===
=== Notes ===
Call [[Scripting/Squirrel/Events/Player/onPlayerCommand|onPlayerCommand]] were used in this example. More info about them in the corresponding pages.
Call [[Scripting/Squirrel/Events/Player/OnPlayerCommand|onPlayerCommand]] were used in this example. More info about them in the corresponding pages.

Revision as of 19:34, 18 April 2016

This function disconnects a client from the server, aka kick a player.

Syntax

KickPlayer( player )

Arguments

  • CPlayer player - the player you are going to kick.

Example

This example shows how to create a command to kick players.

function onPlayerCommand( player, cmd, text );
{
	if ( cmd == "kick" )
	{
		if ( player.Name == "Noob69" || player.Name == "Antonio_Morales" ) //This players can execute the command.
		{
			if ( text )
			{
				local plr = FindPlayer( text );
				if ( plr )
				{
					KickPlayer( plr );
				}
				else MessagePlayer( "Cannot find player "+text+"." , player );
			}
			else MessagePlayer( "Usage: /"+cmd+" <player>" , player );
		}
		else MessagePlayer( "You are not allowed to use this command." , player )
	}
}

Notes

Call onPlayerCommand were used in this example. More info about them in the corresponding pages.