Fabric Wiki

User Tools

Site Tools

Trace:
ru:tutorial:setup

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
ru:tutorial:setup [2022/02/17 08:57] – furnygoru: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'':    - Отредактируйте ''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 === === IntelliJ IDEA ===
 Если вы используете IntelliJ IDEA от JetBrains, пожалуйста, выполните следующие действия: Если вы используете IntelliJ IDEA от JetBrains, пожалуйста, выполните следующие действия:
Line 30: Line 34:
  
 //Необязательно, но рекомендуется//: //Необязательно, но рекомендуется//:
-По умолчанию IntelliJ делегирует Gradle создание проекта. Это не нужно для Fabric и вызывает более длительное время сборки и связанные с горячей заменой странности, среди прочих проблем. Чтобы исправить это используйте встроенный компилятор:+По умолчанию IntelliJ делегирует Gradle для создания проекта. Это не требуется для Fabric и, помимо прочих проблем, приводит к увеличению времени сборки и странностям, связанным с горячей заменой. Чтобы сделать это, используйте встроенный компилятор:
     - Откройте диалоговое окно 'Gradle Settings' на вкладке Gradle.     - Откройте диалоговое окно 'Gradle Settings' на вкладке Gradle.
     - Измените поля 'Build and run using' и 'Run tests using' на 'IntelliJ IDEA'.     - Измените поля 'Build and run using' и 'Run tests using' на 'IntelliJ IDEA'.
Line 37: Line 41:
 К сожалению, в настоящее время невозможно установить значение IDE по умолчанию для параметров 'Build and run using' и 'Run tests using', поэтому эти шаги должны повторяться для каждого нового проекта. К сожалению, в настоящее время невозможно установить значение IDE по умолчанию для параметров 'Build and run using' и 'Run tests using', поэтому эти шаги должны повторяться для каждого нового проекта.
  
-**ПРИМЕЧАНИЕ:** Не запускайте ''./gradlew idea'', так как это портит gradle и нарушает среду разработки.+**ПРИМЕЧАНИЕ:** Не запускайте задачу gradle ''./gradlew idea'', так как это портит gradle и нарушает среду разработки.
  
 === Eclipse === === Eclipse ===
-Если вы используете Eclipse и хотите, чтобы IDE запускала конфигурации, вы можете запустить ''gradlew eclipse''.+Если вы используете Eclipse и хотите, чтобы IDE запускала конфигурации, вы можете запустить ''gradlew eclipse''. Затем проект можно импортировать как обычный (не gradle) проект Eclipse в вашу рабочую область, используя меню 'File' - 'Import...', затем 'General' -> 'Existing Projects into Workspace'.
  
 === Visual Studio Code === === Visual Studio Code ===
-Если вы используете VSCode от Microsoft, пожалуйста, следуйте [[ru:tutorial:vscode_setup|этим инструкциям]]+Если вы используете VSCode, следуйте [[ru:tutorial:vscode_setup|этим инструкциям]]
  
-==== MinecraftDev IntelliJ IDEA Plugin ==== +===== Генерация Minecraft исходников ===== 
-Если вы используете IntelliJ IDEA, вы можете использовать плагин MinecraftDev. Этот плагин добавляет поддержку автоматического создания проектов Fabric, а также некоторых функций, связанных с mixin, таких как проверки, генерация accessors/shadow полей и копирование целевых ссылок Mixin (дескрипторов JVM). +Чтение исходного кода Minecraft является неотъемлемой частью моддинга. 
-Плагин можно найти в [[https://plugins.jetbrains.com/plugin/8327|репозитории плагинов IntelliJ]], таким образом, вы можете установить его с помощью внутреннего браузера плагинов IntelliJ, перейдя в File → Settings → Plugins, затем перейдите на вкладку Marketplace и выполните поиск по слову Minecraft.+К сожалению, мы не можем опубликовать исходный код Minecraft, потому что это нарушает лицензионное соглашение Minecraft. 
 +Вам нужно самостоятельно сгенерировать исходный код Minecraft.
  
-==== Generator ==== +Чтобы сгенерировать исходный код Minecraft. запустите задачу gradle ''genSources''. 
-Если вы не можете использовать плагин MinecraftDev или [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]], вы также можете использовать [[https://github.com/ExtraCrafTX/GeneratorFabricMod|GeneratorFabricMod]] от ExtraCrafTX, удобный инструмент для автоматического создания новых модов Fabric из шаблона. Выполните следующие действия: +Если ваша IDE не имеет интеграции с gradle, выполните следующую команду в терминале: ''gradlew genSources'' (или ''./gradlew genSources'' в Linux/macOS). 
-  - Скачайте последнюю версию GeneratorFabricMod [[https://github.com/ExtraCrafTX/GeneratorFabricMod/releases|здесь]] и извлеките его. +Это может занять некоторое время, в зависимости от мощности вашего компьютера. 
-  - Создайте новый каталог, затем запустите там командную строку и введите ''path/to/GeneratorFabricMod/bin/GeneratorFabricMod''. +Возможно, вам потребуется обновить gradle после выполнения задачи. 
-  - После того как он получите свои зависимости, следуйте инструкциям и введите необходимую информацию. + 
-  - Теперь все готово, просто откройте папку проекта в вашей IDE. +Смотрите [[ru:tutorial:reading_mc_code|Чтение исходного кода Minecraft]] о том, как прочитать исходный код. 
-===== Приступая к работе =====+ 
 +===== Приступаем к работе =====
 Попробуйте [[ru:tutorial:items|добавить предмет]] или [[ru:tutorial:blocks|блок]]. Также посетите [[ru:tutorial:applychanges|Применение изменений без перезапуска Minecraft]]. Попробуйте [[ru:tutorial:items|добавить предмет]] или [[ru:tutorial:blocks|блок]]. Также посетите [[ru:tutorial:applychanges|Применение изменений без перезапуска Minecraft]].
  
 ===== Совет ===== ===== Совет =====
-  * Хотя Fabric API не является строго необходимым для разработки модов, его основная цель-обеспечить кросс-совместимость, где этого не делает игровой движок, и поэтому он настоятельно рекомендуется! Даже некоторые учебники в вики неявно требуют Fabric API. +  * Хотя Fabric API не является строго необходимым для разработки модов, его основная цель обеспечить кросс-совместимость, где этого не делает игровой движок, и поэтому он настоятельно рекомендуется! Даже некоторые учебники в вики неявно требуют Fabric API. 
-  * Иногда при разработке fabric-loom (нашего плагина Gradle build plugin) могут возникать проблемы, требующие сброса файлов кэша. Это можно сделать, запустив ''gradlew cleanloom''. Запуск ''gradlew %%--%%stop'' также может помочь с несколькими редкими проблемами.+  * Иногда при разработке fabric-loom (нашего плагина Gradle build) могут возникать проблемы, требующие сброса файлов кэша. Это можно сделать, запустив ''gradlew cleanloom''. Запуск ''gradlew %%--%%stop'' также может помочь с несколькими редкими проблемами.
   * Не стесняйтесь задавать вопросы! Мы здесь, чтобы помочь вам и работать с вами, чтобы сделать ваш мод мечты реальностью.   * Не стесняйтесь задавать вопросы! Мы здесь, чтобы помочь вам и работать с вами, чтобы сделать ваш мод мечты реальностью.
  
ru/tutorial/setup.txt · Last modified: 2022/02/25 21:10 by furnygo