PlayerCommand: Difference between revisions
m (Replaced HTML with template) |
No edit summary |
||
| Line 1: | Line 1: | ||
This event is triggered when a player sends a command. | |||
{{ServersideCsJsEvent}} | |||
{{JSContainer| | |||
{{Parameters}} | |||
* '''player''' - player, who send command. | * '''player''' - player, who send command. | ||
* '''command''' - string with arguments. | * '''command''' - string with arguments. | ||
{{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 | ||
<pre> | <pre> | ||
mp.events.add("playerCommand", (player, command) => { | mp.events.add("playerCommand", (player, command) => { | ||
| Line 19: | Line 19: | ||
}); | }); | ||
</pre> | </pre> | ||
{{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]" | ||
<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
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# 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
- playerChat
- playerCommand
- playerDamage
- playerDeath
- playerJoin
- playerQuit
- playerReady
- playerSpawn
- playerWeaponChange
Streaming
Vehicle
- playerStartEnterVehicle
- playerEnterVehicle
- playerStartExitVehicle
- playerExitVehicle
- trailerAttached
- vehicleDamage
- vehicleDeath
- vehicleHornToggle
- vehicleSirenToggle