Просмотр кода страницы RU:Getting Started with Commands

__TOC__

= Введение =

Команды могут быть вызваны через чат, при помощи них, вы можете выполнять разные вещи. В этом уроке мы покажем Вам как создавать команды и как пользоваться ими. Давайте посмотрим на пример ниже.

<syntaxhighlight lang="javascript">
mp.events.addCommand("weapon", (player, fullText, weapon, ammo) => {
	var weaponHash = mp.joaat(weapon);

	player.giveWeapon(weaponHash, parseInt(ammo) || 10000);

});
</syntaxhighlight>

В этом примере показана команда под название '''weapon''', которая при вызове даёт игроку оружие с боеприпасами. Если игрок не укажет количество боеприпасов, система автоматически выдаст ему 10000 патронов.

Как это работает?

Откройте чат и введите <code>/weapon <weapon_name> <ammo></code>

Пример: <code>/weapon weapon_pistol 100</code>. После введения этой команды, игроку выдаст пистолет со 100 патронами.

Для просмотра списка всех оружии [[Weapons|нажмите здесь]].


= Параметры =

Выше, мы Вам показали пример использования команд. Теперь, мы Вам расскажем как использовать командные параметры:
<syntaxhighlight lang="javascript">
mp.events.addCommand("<name>", (player, args, args1, args2)
</syntaxhighlight>

*'''<name>''': Это место где вы можете дать своей команде имя. К примеру '''Hello'''

Теперь это выглядит так:
<syntaxhighlight lang="javascript">
mp.events.addCommand("Hello", (player, FullText, args1, args1)
</syntaxhighlight>

*'''player''': Это основное определение игрока который, не советую менять данную строку. '''Player''' используется для получения информации про игрока который ввел команду.

* '''<FullText>''': Позволяет получить весь текст, который был введен игроком после имя команды. Для примера я набрал <code>/Hello Добрый день!</code>, оно вернет <code>Добрый день!</code>. Данное значение вы можете менять как хотите.

* '''args1, args2''': Это необязательные аргументы которые могут быть обозначены разными словами. Для примера я ввожу <code>/Hello Добрый день!</code>, если вывести в консоль '''args1''' <code>console.log(args1)</code>, оно вернет '''Добрый'''. Данное значение вы можете менять как хотите.


В конечном итоге команда будет выглядеть так:

<syntaxhighlight lang="javascript">
mp.events.addCommand("hello", (player, fullText, args1, args2) => {
	player.outputChatBox(`Hello! ${player.name}`);
});
</syntaxhighlight>

Сегодня мы узнали как работать с командами и как применять параметры.

Для получения более подробной информации о командах вы можете [[Events::addCommand|нажать здесь]].