Differences

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

--- ru:tutorial:commands [2022/02/28 12:58] – furnygo
+++ ru:tutorial:commands [2022/03/03 12:50] – furnygo
@@ Line 2: / Line 2: @@
 Создание команд позволяет разработчику наращивать функционал и способ воздействия с пользователем через, собственно, команды.
-Это руководство расскажет как регистрировать команды и общую инофрмацию о структуре Brigadier.
+Это руководство расскажет как регистрировать команды и общую информацию о структуре Brigadier.
 Примечание: Весь код, описанный здесь, написан для 1.14.4. Что-то может быть изменено в yarn, но большая часть кода всё ещё применима и там.
@@ Line 100: / Line 100: @@
 Примечание: Пожалуйста, убедитесь, что вы используете ''literal'' и ''argument'' из CommandManager, иначе у вас могут возникнуть проблемы с дженериками при попытке компиляции.
-Аргументы бригадира по умолчанию находятся в ''com.mojang.brigadier.arguments''
+Аргументы Brigadier по умолчанию находятся в ''com.mojang.brigadier.arguments''
 Аргументы Minecraft находятся в разделе ''net.minecraft.command.arguments''.
 CommandManager находится в ''net.minecraft.server.command''
-==== Подкоманда ====
+===== Подкоманда =====
 Чтобы добавить команде подкоманду, сначала необходимо зарегистрировать ветвь с буквальным вводом.
@@ Line 115: / Line 115: @@
 В целом, чтобы получить подкоманду, нужно расширить текущую ветвь следующей, уже существующей ветвью. Это можно сделать с помощью метода ''then(ArgumentBuilder)'' который принимает в себя ''ArgumentBuilder''.
-То, что показано ниже, создаёт команду ''foo <bar>''.
+То, что показано ниже, создаёт команду ''foo <bar>'':
 <code java [enable_line_numbers="true", highlight_lines_extra="2"]>
@@ Line 123: / 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 141: / 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 159: / 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 175: / 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 191: / Line 191: @@
 </code>
-And vice versa
+И наоборот:
 <code java [enable_line_numbers="true", highlight_lines_extra="5,6,7"]>
@@ Line 206: / Line 206: @@
 </code>
-===== Arguments =====
+===== Аргументы =====
-Arguments in Brigadier both parse and error check any inputted arguments.
+Аргументы в Brigadier как анализируют, так и проверяют на ошибки любые введенные аргументы.
-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.
+Minecraft создает некоторые специальные типы аргументов для собственного использования, такие как ''EntityArgumentType'', который представляет внутриигровые селекторы сущностей ''@a, @r, @p, @e[type=!player, limit=1, distance=..2]'', или ''NbtTagArgumentType'', который анализирует строковый nbt (snbt) и проверяет правильность ввода синтаксиса.
-**TODO:** Go into more detail on how to use arguments
+**Будет сделано позже:** Подробнее о том, как использовать аргументы.
-====== Advanced concepts ======
+====== Дополнительные концепции ======
-Below are links to the articles about more complex concepts used in brigadier.
+Ниже приведены ссылки на статьи о более сложных концепциях, используемых в Brigadier.
-^ Page                                                           ^ Description                                                                     ^
+^ Страница                                                           ^ Описание                                                                     ^
-| [[tutorials:commands:requirements|Requirements]]               | Only allow users to execute commands in certain scenarios.                      |
+| [[ru:tutorial:commands:requirements|Условия]]| Разрешать пользователям выполнять команды только в определенных сценариях.|
-| [[tutorials:commands:exceptions  |Exceptions]]                 | Fail execution of a command with a descriptive message and in certain contexts. |
+| [[ru:tutorial:commands:exceptions|Исключения]]| Сбой выполнения команды с описательным сообщением и в определенных контекстах.|
-| [[tutorial:command_suggestions|Suggestions]]                | Suggesting input to be sent to the client.                                      |
+| [[ru:tutorial:commands:suggestions|Предложения]]| Предложение входных данных для отправки клиенту.|
-| [[tutorials:commands:redirects_aliases|Redirects (Aliases)]]   | Allow use of aliases to execute commands.                                       |
+| [[ru:tutorial:commands:redirects_aliases|Редиректы (Разные вариации)]]| Разрешить использование разновидностей команд.|
-| [[tutorials:commands:redirects_chaining|Redirects (Chaining)]] | Allow commands to have repeating elements and flags.                            |
+| [[ru:tutorial:commands:redirects_chaining|Редиректы (Цепочки)]]| Разрешить командам иметь повторяющиеся элементы и флаги.|
-| [[tutorials:commands:argument_types|Custom Argument Types]]    | Parse your own arguments and return your own types.                             |
+| [[ru:tutorial:commands:argument_types|Свои типы аргументов]]| Анализируйте свои аргументы и возвращайте свои типы.|
-**TODO:** Sections are being moved to sub categories and will be added to their respective articles as they are migrated.
+====== Часто задаваемые вопросы ======
-====== FAQ ======
+===== Почему моя команда не компилируется? =====
-===== Why does my command not compile =====
+Есть две непосредственные возможности того, почему это могло произойти.
-There are two immediate possibilities for why this could occur.
+==== Поймать или вызвать исключение CommandSyntaxException ====
-==== Catch or throw a CommandSyntaxException ====
+Решение этой проблемы состоит в том, чтобы заставить методы run или suggest вызывать исключение CommandSyntaxException. Не волнуйтесь, Brigadier обработает исключения и выдаст соответствующее сообщение об ошибке.
-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.
+==== Проблемы с дженериками ====
-==== Issues with generics ====
+Время от времени у вас могут возникать проблемы с типами дженерика. Убедитесь, что вы используете ''CommandManager.literal(...)'' или ''CommandManager.argument(...)'' вместо ''LiteralArgumentBuilder'' или ''RequiredArgumentBuilder''.
-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''.
+===== Могу ли я зарегистрировать команды на стороне клиента? =====
-===== Can I register client side commands? =====
+Fabric в настоящее время не поддерживает команды на стороне клиента. Существует [[https://github.com/CottonMC/ClientCommands|сторонний мод]] от команды Cotton, которая добавляет эту функциональность.
-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.
+===== "Темные искусства" =====
-===== Dark Arts =====
+Несколько вещей, которые мы не рекомендуем, но которые возможны.
-A few things we don't recommend, but are possible.
+==== Могу ли я регистрировать команды во время выполнения? ====
-==== Can I register commands in runtime? ====
+Вы можете это сделать, но это не рекомендуется. Вы получите ''CommandManager'' с сервера и добавите любые команды, которые пожелаете, в его ''CommandDispatcher''.
-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''.
+После этого вам нужно снова отправить дерево команд каждому игроку, используя ''sendCommandTree(ServerPlayerEntity)''. Это необходимо, поскольку клиент локально кэширует дерево команд, которое он получает во время входа в систему (или при отправке пакетов оператора) для локальных завершений и сообщений об ошибках.
-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.
+==== Могу ли я отменить регистрацию команд во время выполнения? ====
-==== Can I unregister commands in runtime? ====
+Вы также можете сделать это, однако это гораздо менее стабильно, чем регистрация команд, и может вызвать нежелательные побочные эффекты. Чтобы все было просто, вам нужно использовать отражение для бригадира и удалить узлы. После этого вам нужно снова отправить дерево команд каждому игроку, используя ''sendCommandTree(ServerPlayerEntity)''. Если вы не отправите обновленное дерево команд, клиент может подумать, что команда все еще существует, даже если сервер завершит выполнение с ошибкой.
-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.
 ----
-====== 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.__**