Differences

This shows you the differences between two versions of the page.

--- ru:tutorial:commands [2022/02/10 18:30] – немного исправлений грамматических ошибок, перевод комментариев в коде furnygo
+++ ru:tutorial:commands [2022/03/03 12:50] – furnygo
@@ Line 2: / Line 2: @@
 Создание команд позволяет разработчику наращивать функционал и способ воздействия с пользователем через, собственно, команды.
-Это руководство расскажет как регистрировать команды и общую инофрмацию о структуре Brigadier.
+Это руководство расскажет как регистрировать команды и общую информацию о структуре Brigadier.
 Примечание: Весь код, описанный здесь, написан для 1.14.4. Что-то может быть изменено в yarn, но большая часть кода всё ещё применима и там.
@@ Line 53: / Line 53: @@
     // Не обращайте внимание, мы объясним про это далее.
     dispatcher.register(CommandManager.literal("foo"))
-        .executes(this::execute); // Это относится к приведённому ранее методу "выполнить".
+        .executes(this::execute); // Это относится к приведённому ниже методу "выполнить".
 }
@@ Line 80: / Line 80: @@
 ''CommandManager.literal("foo")'' даёт brigadier'у понять, что у команды только одна ветвь, это **буквальный ввод** foo. Чтобы команда была выполнена, нужно ввести ''/foo''. Если введено ''/Foo'', ''/FoO'', ''/FOO'', ''/fOO'' или ''/fooo'', команда не будет считаться верной.
-==== Подкоманда ====
+===== Статические импорты =====
+Вы можете вводить ''CommandManager.literal("foo")'' каждый раз, когда хотите создать литерал. Это работает, но вы можете статически импортировать аргументы и сократить оператор до ''literal("foo")''. Это также работает для получения значения аргумента. Это сокращает ''StringArgumentType.getString(ctx, "string")'' до ''getString(ctx, "string")''.
+Это также работает для собственных типов аргументов Minecraft.
+И ваш импорт будет выглядеть примерно так:
+<code java [enable_line_numbers="true"]>
+// getString(ctx, "string")
+import static com.mojang.brigadier.arguments.StringArgumentType.getString;
+// word()
+import static com.mojang.brigadier.arguments.StringArgumentType.word;
+ // literal("foo")
+import static net.minecraft.server.command.CommandManager.literal;
+ // argument("bar", word())
+import static net.minecraft.server.command.CommandManager.argument;
+// Импортировать всё
+import static net.minecraft.server.command.CommandManager.*;
+</code>
+Примечание: Пожалуйста, убедитесь, что вы используете ''literal'' и ''argument'' из CommandManager, иначе у вас могут возникнуть проблемы с дженериками при попытке компиляции.
+Аргументы Brigadier по умолчанию находятся в ''com.mojang.brigadier.arguments''
+Аргументы Minecraft находятся в разделе ''net.minecraft.command.arguments''.
+CommandManager находится в ''net.minecraft.server.command''
+===== Подкоманда =====
 Чтобы добавить команде подкоманду, сначала необходимо зарегистрировать ветвь с буквальным вводом.
@@ Line 90: / Line 115: @@
 В целом, чтобы получить подкоманду, нужно расширить текущую ветвь следующей, уже существующей ветвью. Это можно сделать с помощью метода ''then(ArgumentBuilder)'' который принимает в себя ''ArgumentBuilder''.
-То, что показано ниже, создаёт команду ''foo <bar>''.
+То, что показано ниже, создаёт команду ''foo <bar>'':
 <code java [enable_line_numbers="true", highlight_lines_extra="2"]>
@@ Line 98: / Line 123: @@
 </code>
-It is advised to indent your code as you add nodes to the command. Usually the indentation corresponds to how many nodes deep one is on the command tree. The new line also makes it visible that another node is being added. There are alternative styles to formatting the tree command that are shown later on in this tutorial.
+Рекомендуется делать отступы в вашем коде при добавлении узлов в команду. Обычно отступ соответствует количеству глубоких узлов в дереве команд. Новая строка также делает видимым, что добавляется еще один узел. Существуют альтернативные стили для форматирования команды дерева, которые будут показаны позже в этом руководстве.
-**So let's try running the command**
+**Итак, давайте попробуем выполнить команду**
-Most likely if you typed ''/foo bar'' in game, the command will fail to run. This is because there is no code for the game to execute when all the required arguments have been met. To fix this, you need to tell the game what to run when the command is being executed using the ''executes(Command)'' method. Below is how the command should look as an example.
+Скорее всего, если вы наберете ''/foo bar'' в игре, команда не будет выполнена. Это происходит потому, что нет кода для игры, который выполнялся бы после выполнения всех требуемых аргументов. Чтобы исправить это, вам нужно указать игре, что запускать, когда выполняется команда, используя метод ''executes(Command)''. Ниже в качестве примера показано, как должна выглядеть команда:
 <code java [enable_line_numbers="true", highlight_lines_extra="3,4,5,6,7"]>
@@ Line 116: / Line 141: @@
 </code>
-===== Registering the commands =====
+===== Регистрация команд =====
-Registering commands is done by registering a callback using the ''CommandRegistrationCallback''. For information on registering callbacks, please see the [[tutorial:callbacks|callbacks article]].
+Регистрация команд выполняется путем регистрации обратного вызова с помощью ''CommandRegistrationCallback''. Для получения информации о регистрации обратных вызовов, ознакомьтесь с [[ru:tutorial:callbacks|статьёй об обратных вызовах]].
-The event should be registered in your mod's initializer. The callback has two parameters. The ''CommmandDispatcher<S>'' is used to register, parse and execute commands. ''S'' is the type of command source the command dispatcher supports. The second parameter is a boolean which identifies the type of server the commands are being registered. on is an ''dedicated'' or ''integrated'' (false) server.
+Событие должно быть зарегистрировано в инициализаторе вашего мода. Обратный вызов имеет два параметра. ''CommmandDispatcher<S>'' используется для регистрации, анализа и выполнения команд. ''S'' i- это тип источника команд, который поддерживает диспетчер команд. Второй параметр - это логическое значение, которое определяет тип сервера, на котором регистрируются команды. Это может быть ''dedicated'' (выделенный) или ''integrated''(интегрированный) (false) сервер:
@@ Line 134: / Line 159: @@
 </code>
-Inside your lambda, method reference or whatever you have chosen, you will register your commands.
+Внутри вашего лямбда-выражения, ссылки на метод или чего бы вы ни выбрали, зарегистрируете свои команды:
 <code java [enable_line_numbers="true", highlight_lines_extra="5,6,7,8"]>
@@ Line 150: / Line 175: @@
 </code>
-If desired, you can make sure a command is only registered on a dedicated server by checking the ''dedicated'' flag
+При желании вы можете убедиться, что команда зарегистрирована только на выделенном сервере, установив флажок ''dedicated''(выделенный):
@@ Line 166: / Line 191: @@
 </code>
-And vice versa
+И наоборот:
 <code java [enable_line_numbers="true", highlight_lines_extra="5,6,7"]>
@@ Line 181: / Line 206: @@
 </code>
-===== Arguments =====
+===== Аргументы =====
-Arguments in Brigadier both parse and error check any inputted arguments.
-Minecraft creates some special argument types for it's own use such as the ''EntityArgumentType'' which represents the in-game entity selectors ''@a, @r, @p, @e[type=!player, limit=1, distance=..2]'', or an ''NbtTagArgumentType'' that parses stringified nbt (snbt) and verifies that the input is the correct syntax.
-**TODO:** Go into more detail on how to use arguments
-===== Static Imports =====
-You could type out ''CommandManager.literal("foo")'' every time you want to create a literal. This works, but you can statically import the arguments and shorten the statement to ''literal("foo")''. This also works for getting the value of an argument. This shortens ''StringArgumentType.getString(ctx, "string")'' to ''getString(ctx, "string")''.
-This also works for Minecraft's own argument types.
-And your imports would look something like this:
-<code java [enable_line_numbers="true"]>
-// getString(ctx, "string")
-import static com.mojang.brigadier.arguments.StringArgumentType.getString;
-// word()
-import static com.mojang.brigadier.arguments.StringArgumentType.word;
- // literal("foo")
-import static net.minecraft.server.command.CommandManager.literal;
- // argument("bar", word())
-import static net.minecraft.server.command.CommandManager.argument;
-// Import everything
-import static net.minecraft.server.command.CommandManager.*;
-</code>
-Note: Please be sure you use the ''literal'' and ''argument'' from CommandManager or you may have issues with generics when trying to compile.
-Brigadier's default arguments are at ''com.mojang.brigadier.arguments''
-Minecraft's arguments are in ''net.minecraft.command.arguments''.
+Аргументы в Brigadier как анализируют, так и проверяют на ошибки любые введенные аргументы.
-CommandManager is in ''net.minecraft.server.command''
+Minecraft создает некоторые специальные типы аргументов для собственного использования, такие как ''EntityArgumentType'', который представляет внутриигровые селекторы сущностей ''@a, @r, @p, @e[type=!player, limit=1, distance=..2]'', или ''NbtTagArgumentType'', который анализирует строковый nbt (snbt) и проверяет правильность ввода синтаксиса.
-====== Advanced concepts ======
+**Будет сделано позже:** Подробнее о том, как использовать аргументы.
-Below are links to the articles about more complex concepts used in brigadier.
+====== Дополнительные концепции ======
-^ Page                                                           ^ Description                                                                     ^
+Ниже приведены ссылки на статьи о более сложных концепциях, используемых в Brigadier.
-| [[tutorials:commands:requirements|Requirements]]               | Only allow users to execute commands in certain scenarios.                      |
-| [[tutorials:commands:exceptions  |Exceptions]]                 | Fail execution of a command with a descriptive message and in certain contexts. |
-| [[tutorial:command_suggestions|Suggestions]]                | Suggesting input to be sent to the client.                                      |
-| [[tutorials:commands:redirects_aliases|Redirects (Aliases)]]   | Allow use of aliases to execute commands.                                       |
-| [[tutorials:commands:redirects_chaining|Redirects (Chaining)]] | Allow commands to have repeating elements and flags.                            |
-| [[tutorials:commands:argument_types|Custom Argument Types]]    | Parse your own arguments and return your own types.                             |
-**TODO:** Sections are being moved to sub categories and will be added to their respective articles as they are migrated.
+^ Страница                                                           ^ Описание                                                                     ^
+| [[ru:tutorial:commands:requirements|Условия]]| Разрешать пользователям выполнять команды только в определенных сценариях.|
+| [[ru:tutorial:commands:exceptions|Исключения]]| Сбой выполнения команды с описательным сообщением и в определенных контекстах.|
+| [[ru:tutorial:commands:suggestions|Предложения]]| Предложение входных данных для отправки клиенту.|
+| [[ru:tutorial:commands:redirects_aliases|Редиректы (Разные вариации)]]| Разрешить использование разновидностей команд.|
+| [[ru:tutorial:commands:redirects_chaining|Редиректы (Цепочки)]]| Разрешить командам иметь повторяющиеся элементы и флаги.|
+| [[ru:tutorial:commands:argument_types|Свои типы аргументов]]| Анализируйте свои аргументы и возвращайте свои типы.|
-====== FAQ ======
+====== Часто задаваемые вопросы ======
-===== Why does my command not compile =====
+===== Почему моя команда не компилируется? =====
-There are two immediate possibilities for why this could occur.
+Есть две непосредственные возможности того, почему это могло произойти.
-==== Catch or throw a CommandSyntaxException ====
+==== Поймать или вызвать исключение CommandSyntaxException ====
-The solution to this issue is to make the run or suggest methods throw a CommandSyntaxException. Don't worry, brigadier will handle the exceptions and output the proper error message.
+Решение этой проблемы состоит в том, чтобы заставить методы run или suggest вызывать исключение CommandSyntaxException. Не волнуйтесь, Brigadier обработает исключения и выдаст соответствующее сообщение об ошибке.
-==== Issues with generics ====
+==== Проблемы с дженериками ====
-You may have an issue with generic types once in a while. Verify you are using ''CommandManager.literal(...)'' or ''CommandManager.argument(...)'' instead ''LiteralArgumentBuilder'' or ''RequiredArgumentBuilder''.
+Время от времени у вас могут возникать проблемы с типами дженерика. Убедитесь, что вы используете ''CommandManager.literal(...)'' или ''CommandManager.argument(...)'' вместо ''LiteralArgumentBuilder'' или ''RequiredArgumentBuilder''.
-===== Can I register client side commands? =====
+===== Могу ли я зарегистрировать команды на стороне клиента? =====
-Fabric doesn't currently support client side commands. There is a [[https://github.com/CottonMC/ClientCommands|third-party mod]] by the Cotton team that adds this functionality.
+Fabric в настоящее время не поддерживает команды на стороне клиента. Существует [[https://github.com/CottonMC/ClientCommands|сторонний мод]] от команды Cotton, которая добавляет эту функциональность.
-===== Dark Arts =====
+===== "Темные искусства" =====
-A few things we don't recommend, but are possible.
+Несколько вещей, которые мы не рекомендуем, но которые возможны.
-==== Can I register commands in runtime? ====
+==== Могу ли я регистрировать команды во время выполнения? ====
-You can do this but it is not recommended. You would get the ''CommandManager'' from the server and add anything commands you wish to it's ''CommandDispatcher''.
+Вы можете это сделать, но это не рекомендуется. Вы получите ''CommandManager'' с сервера и добавите любые команды, которые пожелаете, в его ''CommandDispatcher''.
-After that you need to send the command tree to every player again using ''sendCommandTree(ServerPlayerEntity)''. This is required because the client locally caches the command tree it receives during login (or when operator packets are sent) for local completions rich error messages.
+После этого вам нужно снова отправить дерево команд каждому игроку, используя ''sendCommandTree(ServerPlayerEntity)''. Это необходимо, поскольку клиент локально кэширует дерево команд, которое он получает во время входа в систему (или при отправке пакетов оператора) для локальных завершений и сообщений об ошибках.
-==== Can I unregister commands in runtime? ====
+==== Могу ли я отменить регистрацию команд во время выполнения? ====
-You can also do this, however it is much less stable than registering commands and could cause unwanted side effects. To keep things simple, you need to use reflection on brigadier and remove the nodes. After this, you need to send the command tree to every player again using ''sendCommandTree(ServerPlayerEntity)''. If you don't send the updated command tree, the client may think a command still exists, even though the server will fail execution.
+Вы также можете сделать это, однако это гораздо менее стабильно, чем регистрация команд, и может вызвать нежелательные побочные эффекты. Чтобы все было просто, вам нужно использовать отражение для бригадира и удалить узлы. После этого вам нужно снова отправить дерево команд каждому игроку, используя ''sendCommandTree(ServerPlayerEntity)''. Если вы не отправите обновленное дерево команд, клиент может подумать, что команда все еще существует, даже если сервер завершит выполнение с ошибкой.
 ----
-====== Sorry for the mess ======
+====== Со временем уберётся ======
 **__Currently this article is being migrated, so things may be a mess. Below is are the parts of the article that are yet to be migrated to the new format.__**