imported>RoboN1X в 14:53, 23 мая 2019

2019-05-23T14:53:32Z

Новая страница

This event is triggered when a player sends a command.

{{ServersideJsEvent}}

{{JSContainer|
{{Parameters}}
* '''player''': {{RageType|Player}} - [[:Category:Player API|player]], who send command.
* '''command''': {{RageType|String}} - command (without slash) with arguments.

{{Example}}
This example will write "Hello!" to player, who will enter command /meetme into chatbox.s
<pre>
mp.events.add("playerCommand", (player, command) => {
const args = command.split(/[ ]+/);
const commandName = args.splice(0, 1)[0];

if (commandName === "meetme") {
player.outputChatBox("Hello!");
}
});
</pre>

{{Example}}
'''Detecting Invalid Commands: '''
<pre>
mp.events.add('playerCommand', (player, command) => {
player.outputChatBox(`${command} is not a valid command. Use /help to find a list of commands.`);
});
</pre>
}}

{{ClientsideCsJsEvent}}

{{CSharpContainer|
<syntaxhighlight lang="csharp">
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>
}}

{{JSContainer|
{{Parameters}}
* '''command''': {{RageType|String}} - command (without slash) with arguments.

{{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]"
<pre>
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(",")}]`);
}
});
</pre>
}}

==See also==
{{Player_events}}

[[Category:Player]]
[[Category:Server-side Event]]
[[Category:Client-side Event]]

PlayerCommand - История изменений

imported>RoboN1X в 14:53, 23 мая 2019