Differences

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

--- ru:tutorial:setup [2020/11/06 16:53] – created falseresync
+++ ru:tutorial:setup [2022/02/25 21:10] (current) – обновил информацию с английской версии furnygo
@@ Line 1: / Line 1: @@
-====== Настройка среды разработки ======
+====== Настройка среды разработки модов ======
-===== Необходимо перед началом =====
+===== Обязательно нужно =====
+   * Java Development Kit (JDK) для Java 17 (рекомендуется) или новее. Чтобы установить его, зайдите на [[https://adoptium.net/releases.html]].
+       * Если вы профессионал, вы можете получить JDK [[http://jdk.java.net/|здесь]], который необходимо извлечь и настроить системные переменные вручную.
+   * Любая Java IDE, например [[https://www.jetbrains.com/idea/download/#section=windows|Intellij IDEA]] или [[https://www.eclipse.org/downloads/|Eclipse]]. Вы также можете использовать любые другие редакторы кода, такие как [[https://code.visualstudio.com/|Visual Studio Code]].
+       * Если вы не знакомы ни с одним из них, мы рекомендуем использовать Intellij IDEA, поскольку это то, что большинство людей выбирают для моддинга.
-   * Java Development Kit (JDK) для Java 8 (рекомендуем) или новее [[https://adoptopenjdk.net/]]
+==== Плагин MinecraftDev IntelliJ IDEA ====
-   * Любая среда разработки Java, например [[https://www.jetbrains.com/idea/download/#section=windows|Intellij IDEA]] или [[https://www.eclipse.org/downloads/|Eclipse]]. Однако, Вы также можете использовать любые текстовые редакторы, вроде [[https://code.visualstudio.com/|Visual Studio Code]].
+Если вы используете IntelliJ IDEA, вы можете использовать плагин MinecraftDev. Этот плагин добавляет поддержку автоматического создания проектов Fabric, а также некоторых функций, связанных с mixin, таких как проверки, генерация accessors/shadow полей и копирование целевых ссылок Mixin (дескрипторов JVM).
+Плагин можно найти в [[https://plugins.jetbrains.com/plugin/8327|репозитории плагинов IntelliJ]], таким образом, вы можете установить его с помощью внутреннего браузера плагинов IntelliJ, перейдя в File → Settings → Plugins, затем перейдите на вкладку Marketplace и выполните поиск по слову Minecraft.
-===== Первые шаги =====
-Существует два основных способа создать мод для Minecraft, используя Fabric. Вы можете либо вручную скачать fabric-example-mod и установить его самостоятельно, или же воспользоваться автоматическим инструментарием.
 ==== Ручное управление ====
-   - Скопируйте начальные файлы [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] (или [[https://github.com/natanfudge/fabric-example-mod-kotlin|версию для Kotlin]], если вы хотите использовать Kotlin,), за исключением файлов ''LICENSE'' и ''README.md'', так как они нужны только для самого шаблона и не обязательны для Вашего мода.
+   - Скопируйте начальные файлы [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] (или [[https://github.com/natanfudge/fabric-example-mod-kotlin|версию для Kotlin]], если вы хотите использовать Kotlin), за исключением файлов ''LICENSE'' и ''README.md'', так как они нужны только для самого шаблона и не обязательны для Вашего мода.
    - Отредактируйте ''gradle.properties'':
-       * Установите полям ''archives_base_name'' и ''maven_group'' Ваши предпочтитаемые значения.
+       * Установите полям ''archives_base_name'' и ''maven_group'' ваши предпочтительные значения.
-       * Не забудьте обновить поля версий Minecraft, маппингов и Loader, - все из них Вы можете узнать на [[https://modmuss50.me/fabric.html|этом сайте]] - чтобы они совпадали с теми, что Вы хотите.
+       * Не забудьте обновить версию Minecraft, маппингов, Loom и Loader, - все это может быть запрошено через https://fabricmc.net/develop/ - чтобы соответствовать версиям, на которые вы настроены.
-   - Добавьте в ''build.gradle'' иные зависимости, которые Вы планируете использовать.
+       * Добавьте в ''build.gradle'' иные зависимости, которые Вы планируете использовать.
-   - Импортируйте файл ''build.gradle'' в Вашу среду разработки. Вы можете взглянуть на секцию, соответствующую Вашей среде, ниже.
+   - Импортируйте файл ''build.gradle'' в вашу среду разработки. Вы можете обратиться к следующему разделу для получения информации о конкретных IDE.
    - Счастливой разработки!
-Вы можете сгенерировать исходники Minecraft ради справки (так как IDEA умеет декомпилировать, это полезно только для поиска по исходному коду):
+Если вы не можете использовать плагин MinecraftDev или [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]], вы также можете использовать [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]] от ExtraCrafTX, удобный инструмент для автоматического создания новых модов Fabric из шаблона. Выполните следующие действия:
- Запустите задачу Gradle ''genSources''. Если в Вашей среде разработки нет интеграции с Gradle, то запустите следующую команду в терминале: ''./gradlew genSources''
+  - Скачайте последнюю версию GeneratorFabricMod [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|здесь]] и извлеките его.
+  - Создайте новый каталог, затем запустите там командную строку и введите ''path/to/GeneratorFabricMod/bin/GeneratorFabricMod''.
+  - После того как он получит свои зависимости, следуйте инструкциям и введите необходимую информацию.
+  - Теперь все готово, просто откройте папку проекта в вашей IDE.
 === IntelliJ IDEA ===
-If you are using IntelliJ IDEA by JetBrains, please follow these steps:
+Если вы используете IntelliJ IDEA от JetBrains, пожалуйста, выполните следующие действия:
-    - In the IDEA main menu, select 'Import Project' (or File -> Open... if you already have a project open).
+    - В главном меню IDEA, выберите 'Import Project' (или File -> Open... если у вас уже есть открытый проект).
-    - Select the project's build.gradle file to import the project.
+    - Выберите файл build.gradle проекта, чтобы импортировать его.
-    - After Gradle is done setting up, close (File -> Close Project) and re-open the project to fix run configurations not displaying correctly.
+    - После того как Gradle закончит настройку, закройте проект (File -> Close Project) и снова откройте, чтобы исправить неверное отображение конфигураций запуска.
-    - (If the run configurations still don't show up, try reimporting the Gradle project from the Gradle tab in IDEA.)
+    - (Если конфигурации запуска по-прежнему не отображаются, попробуйте повторно импортировать проект Gradle с вкладки Gradle в IDEA.)
-//Optional, but recommended//:
+//Необязательно, но рекомендуется//:
-By default, IntelliJ delegates to Gradle to build the project. This is unnecessary for Fabric and causes longer build times and hotswapping related weirdness, among other problems. To make it use the builtin compiler:
+По умолчанию IntelliJ делегирует Gradle для создания проекта. Это не требуется для Fabric и, помимо прочих проблем, приводит к увеличению времени сборки и странностям, связанным с горячей заменой. Чтобы сделать это, используйте встроенный компилятор:
-    - Open the 'Gradle Settings' dialog from the Gradle tab.
+    - Откройте диалоговое окно 'Gradle Settings' на вкладке Gradle.
-    - Change the 'Build and run using' and 'Run tests using' fields to 'IntelliJ IDEA'.
+    - Измените поля 'Build and run using' и 'Run tests using' на 'IntelliJ IDEA'.
-    - Go to File -> Project Structure -> Project and set 'Project compiler output' to ''$PROJECT_DIR$/out''.
+    - Перейдите в File -> Project Structure -> Project и установите 'Project compiler output' на ''$PROJECT_DIR$/out''.
-Unfortunately, it is currently impossible to set an IDE-wide default for the 'Build and run using' and 'Run tests using' options, so these steps have to be repeated for every new project.
+К сожалению, в настоящее время невозможно установить значение IDE по умолчанию для параметров 'Build and run using' и 'Run tests using', поэтому эти шаги должны повторяться для каждого нового проекта.
-**NOTE:** Don't run ''./gradlew idea'' as it messes up with gradle and breaks develop environment.
+**ПРИМЕЧАНИЕ:** Не запускайте задачу gradle ''./gradlew idea'', так как это портит gradle и нарушает среду разработки.
 === Eclipse ===
-If you are using Eclipse and you would like to have the IDE run configs you can run ''gradlew eclipse''.
+Если вы используете Eclipse и хотите, чтобы IDE запускала конфигурации, вы можете запустить ''gradlew eclipse''. Затем проект можно импортировать как обычный (не gradle) проект Eclipse в вашу рабочую область, используя меню 'File' - 'Import...', затем 'General' -> 'Existing Projects into Workspace'.
 === Visual Studio Code ===
-If you are using VSCode by Microsoft, please follow [[tutorial:vscode_setup|these instructions]]
+Если вы используете VSCode, следуйте [[ru:tutorial:vscode_setup|этим инструкциям]]
+===== Генерация Minecraft исходников =====
+Чтение исходного кода Minecraft является неотъемлемой частью моддинга.
+К сожалению, мы не можем опубликовать исходный код Minecraft, потому что это нарушает лицензионное соглашение Minecraft.
+Вам нужно самостоятельно сгенерировать исходный код Minecraft.
+Чтобы сгенерировать исходный код Minecraft. запустите задачу gradle ''genSources''.
+Если ваша IDE не имеет интеграции с gradle, выполните следующую команду в терминале: ''gradlew genSources'' (или ''./gradlew genSources'' в Linux/macOS).
+Это может занять некоторое время, в зависимости от мощности вашего компьютера.
+Возможно, вам потребуется обновить gradle после выполнения задачи.
-==== MinecraftDev IntelliJ IDEA Plugin ====
+Смотрите [[ru:tutorial:reading_mc_code|Чтение исходного кода Minecraft]] о том, как прочитать исходный код.
-If you are using IntelliJ IDEA you can use the MinecraftDev plugin. This plugin adds support for automatically generating Fabric projects as well as some mixin related features like inspections, generating accessors/shadow fields, and copying Mixin Target References (JVM Descriptors).
-The plugin can be found [[https://plugins.jetbrains.com/plugin/8327|in the IntelliJ plugin repository]], so you can install it using IntelliJ's internal plugin browser by navigating to File → Settings → Plugins, then clicking the Marketplace tab and searching for Minecraft.
-==== Generator ====
+===== Приступаем к работе =====
-If you are unable to use the MinecraftDev plugin or the [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] repo, you may also use [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]] by ExtraCrafTX, a convenient tool to automatically generate new fabric mods from template. Follow these steps:
+Попробуйте [[ru:tutorial:items|добавить предмет]] или [[ru:tutorial:blocks|блок]]. Также посетите [[ru:tutorial:applychanges|Применение изменений без перезапуска Minecraft]].
-  - Download latest release of GeneratorFabricMod [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|here]] and extract them.
-  - Make a new directory, then run a command shell there and type ''path/to/GeneratorFabricMod/bin/GeneratorFabricMod''.
-  - After letting it get its dependencies, follow the instructions and input required information.
-  - You're now done, just open the project folder with in your IDE.
-===== Getting started =====
-Try [[tutorial:items|adding an item]] or [[tutorial:blocks|a block]]. It's also a good idea to visit [[tutorial:applychanges|Applying changes without restarting Minecraft]].
-===== Advice =====
+===== Совет =====
-  * While Fabric API is not strictly necessary for developing mods, its primary goal is to provide cross-compatibility and hooks where the game engine does not, and as such it is highly recommended! Even some of the tutorials on the wiki implicitly require Fabric API.
+  * Хотя Fabric API не является строго необходимым для разработки модов, его основная цель обеспечить кросс-совместимость, где этого не делает игровой движок, и поэтому он настоятельно рекомендуется! Даже некоторые учебники в вики неявно требуют Fabric API.
-  * Occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require resetting the cache files. This can be done by running ''gradlew cleanloom''. Running ''gradlew %%--%%stop'' can also help with a few rare issues.
+  * Иногда при разработке fabric-loom (нашего плагина Gradle build) могут возникать проблемы, требующие сброса файлов кэша. Это можно сделать, запустив ''gradlew cleanloom''. Запуск ''gradlew %%--%%stop'' также может помочь с несколькими редкими проблемами.
-  * Don't hesitate to ask questions! We're here to help you and work with you to make your dream mod a reality.
+  * Не стесняйтесь задавать вопросы! Мы здесь, чтобы помочь вам и работать с вами, чтобы сделать ваш мод мечты реальностью.
-===== Troubleshooting =====
+===== Диагностика =====
-==== Missing sounds ====
+==== Отсутствующие звуки ====
-Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the ''downloadAssets'' task manually - either using IDE's built-in menu or by simply running ''gradlew downloadAssets''.
+Иногда при импорте проекта Gradle в IDE ресурсы могут загружаться неправильно. В этом случае запустите задачу ''downloadAssets'' вручную - либо с помощью встроенного меню IDE, либо просто запустив ''gradlew downloadAssets''.