PlayerCommand: Difference between revisions

From RAGE Multiplayer Wiki
m (Replaced HTML with template)
No edit summary
Line 1: Line 1:
This event is triggered when a player sends a command.


This event is triggered when player send command .
{{ServersideCsJsEvent}}
 
{{JSContainer|
==Parameters==
{{Parameters}}
* '''player''' - player, who send command.  
* '''player''' - player, who send command.  
* '''command''' - string with arguments.  
* '''command''' - string with arguments.  


==Example #1==
{{Example}}
This example will write "Hello!" to player, who will enter command /meetme into chatbox.s
This example will write "Hello!" to player, who will enter command /meetme into chatbox.s
{{ServersideCode|
<pre>
<pre>
mp.events.add("playerCommand", (player, command) => {
mp.events.add("playerCommand", (player, command) => {
Line 19: Line 19:
});
});
</pre>
</pre>
}}


==Example #2==
{{Example}}
This example will output info about entered command into client chatbox.
This example will output info about entered command into client chatbox.


if you enter "/blah 123 566", it will output next message:
if you enter "/blah 123 566", it will output next message:
"You enter command a "blah", and all arguments it a [123,566]"
"You enter command a "blah", and all arguments it a [123,566]"
{{ServersideCode|
<pre>
<pre>
mp.events.add("playerCommand", (command) => {
mp.events.add("playerCommand", (command) => {
Line 40: Line 38:
</pre>
</pre>
}}
}}
{{ClientsideCsJsEvent}}
{{CSharpContainer|
<syntaxhighlight lang="c#">
public delegate void OnPlayerCommandDelegate(string cmd, CancelEventArgs cancel);
</syntaxhighlight>
{{Parameters}}
* '''cmd''': colshape, expects '''System.String''' type.
* '''cancel''': cancel, expects '''RAGE.Events.CancelEventArgs''' type.


{{Example}}
This example will set player restore player health to max when command '''/heal''' is used, or set players armour to max when command '''/armour''' is used.
<syntaxhighlight lang="c#">
Events.OnPlayerCommand += OnPlayerCommand;
</syntaxhighlight>
<syntaxhighlight lang="c#">
public void OnPlayerCommand(string cmd, RAGE.Events.CancelEventArgs cancel)
{
    if (cmd == "heal")
    {
        RAGE.Elements.Player.LocalPlayer.SetHealth(100);
    }
    else if (cmd == "armour")
    {
        RAGE.Elements.Player.LocalPlayer.SetArmour(100);
    }
}
</syntaxhighlight>
}}
==See also==
==See also==
{{Player_events}}
{{Player_events}}

Revision as of 00:13, 29 November 2018

This event is triggered when a player sends a command.

Server-Side
Event

 C#  JavaScript



JavaScript Syntax

Parameters

  • player - player, who send command.
  • command - string with arguments.

Example

This example will write "Hello!" to player, who will enter command /meetme into chatbox.s

mp.events.add("playerCommand", (player, command) => {
	const args = command.split(/[ ]+/);
	const commandName = args.splice(0, 1)[0];
		
	if (commandName === "meetme") {
		player.outputChatBox("Hello!");
	}
});

Example

This example will output info about entered command into client chatbox.

if you enter "/blah 123 566", it will output next message: "You enter command a "blah", and all arguments it a [123,566]"

mp.events.add("playerCommand", (command) => {
	const args = command.split(/[ ]+/);
	const commandName = args[0];

	args.shift();
		
	if (commandName === "blah") {
		mp.gui.chat.push(`You enter command a "${commandName}", and all arguments it a [${args.join(",")}]`);
	}
});


Client-Side Event

 C#  JavaScript


C# Syntax

public delegate void OnPlayerCommandDelegate(string cmd, CancelEventArgs cancel);

Parameters

  • cmd: colshape, expects System.String type.
  • cancel: cancel, expects RAGE.Events.CancelEventArgs type.

Example

This example will set player restore player health to max when command /heal is used, or set players armour to max when command /armour is used.

Events.OnPlayerCommand += OnPlayerCommand;
public void OnPlayerCommand(string cmd, RAGE.Events.CancelEventArgs cancel)
{
    if (cmd == "heal")
    {
         RAGE.Elements.Player.LocalPlayer.SetHealth(100);
    }
    else if (cmd == "armour")
    {
         RAGE.Elements.Player.LocalPlayer.SetArmour(100);
    }
}


See also

Checkpoint

Colshape

Entity

Player

Streaming

Vehicle

Waypoint