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
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Scripting/Needs_Text}}
This function disconnects a client from the server, aka kick a player.


== Syntax ==
== Syntax ==
<pre>KickPlayer( player )</pre>
== Arguments ==
* ''CPlayer'' '''player''' - the player you are going to kick.


<pre>KickPlayer( player )</pre>
== 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 == "Your Name" )
{
if ( player.Name == "Noob69" || player.Name == "Antonio_Morales" ) //This players can execute the command.
{
{
local plr = FindPlayer( text );
if ( text )
if ( plr )
{
{
 
local plr = FindPlayer( text );
    ClientMessageToAll( "Admin:[ " + player.Name + " ] Kick:[ " + plr.Name + " ] [ Kick From the server ]" , 500, 102, 103 );                                        
if ( plr )
          KickPlayer( plr )
{
    }
KickPlayer( plr );
        }
}
    else MessagePlayer( "---> Type /kick < player name >." , player);
else MessagePlayer( "Cannot find player "+text+"." , player );
}
else MessagePlayer( "Usage: /"+cmd+" <player>" , player );
}
else MessagePlayer( "You are not allowed to use this command." , player )
}
}
 
}
</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.
 
== Related Functions ==
 
{{Scripting/Squirrel/Functions/Player_Functions}}
[[Category:Scripting/Squirrel/Functions/Player_Functions]]

Latest revision as of 18:45, 30 January 2017

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.

Related Functions

Player Game Functions

These functions exist for compatibility with the R2 Squirrel server.