Привет! В этом посте я расскажу, как запустить проект на Forge в Intellij IDEA. Шаги достаточно просты, и следуя им, вы быстро настроите среду разработки для работы над модами Minecraft.

Первым делом нужно скачать и установить IntelliJ IDEA Community Edition. Перейдите по ссылке и выберите версию для своей операционной системы:

Для работы Forge проекта понадобится JDK (Java Development Kit). Рекомендую использовать JDK 17. Вот ссылка для загрузки:

Теперь нужно скачать Forge MDK. Можете выбрать версию "Latest" или "Recommended", в зависимости от ваших нужд. Я использовал Recommended, проблем не возникло:

Распакуйте архив с Forge MDK в любую удобную папку.

Откройте Intellij IDEA и нажмите File → Open (левый верхний угол). Выберите именно папку распакованного архива.

Теперь переходим непосредственно к настройке проекта!

После того как вы открыли проект в IntelliJ IDEA, нужно выполнить несколько шагов для корректной настройки.

Если IntelliJ IDEA предложит установить дополнительные плагины (например, для работы с Gradle), примите все предложения и дождитесь завершения установки.

Далее IntelliJ IDEA автоматически распознает ваш проект как Gradle-проект. Однако, если этого не произошло, вам нужно вручную указать Gradle как систему сборки.

Для этого перейдите в File → Settings → Build, Execution, Deployment → Build Tools → Gradle и выберите Use Gradle from: wrapper.

Затем в окне "Gradle" нажмите Refresh для обновления зависимостей.

В любом случае после открытия распакованной папки, должна появится такая панель:

Откройте файл gradle.properties, который находится в корне вашего проекта.

Убедитесь, что там указаны корректные версии Minecraft и Forge.

Далее прокрутите вниз до раздела, помеченного как ## Mod Properties (обычно это строка 41). Здесь необходимо указать информацию о вашем моде. Рассмотрим каждый параметр подробнее:

mod_id — это уникальный идентификатор вашего мода. Он должен быть написан в нижнем регистре (без заглавных букв). Если в названии есть пробелы, замените их на знак _.

Например, для мода Rinova я укажу: mod_id=rinova

mod_name — это название вашего мода. Оно отображается в списке модов Minecraft. Например: mod_name=Rinova

mod_version — версия вашего мода. Здесь можно указать любую строку, но лучше придерживаться структуры версий (например, 0.0.1 для начальной разработки или 1.0.0 для первого релиза). Например: mod_version=0.0.1

mod_group_id — это путь к ядру вашего мода, который должен соответствовать реальной структуре папок в вашем проекте. Например, если я укажу: mod_group_id=com.ringo.rinova

То в папке src/main/java у меня должна быть структура папок: com/ringo/rinova:

ringo — мой никнейм, а rinova — идентификатор моего мода (mod_id).  

mod_authors — авторы мода. Укажите здесь ваше имя (и других участников разработки, если они есть). Например: mod_authors=Ringo

mod_description — краткое описание вашего мода. Это то, что будет видно другим пользователям.

По итогу у меня вышло как то так:

Теперь откроем файл build.gradle, который отвечает за конфигурацию сборки проекта. 

При старте работы над проектом, файл build.gradle может не требовать значительных изменений, так как многие параметры уже подтягиваются из файла gradle.properties. Этот файл является основным местом для задания таких настроек, как версии Minecraft и Forge, а также конфигурации, специфичные для вашего мода.

В файле gradle.properties мы указали важные параметры, которые будут использоваться в процессе сборки проекта, например:

Версия Minecraft (minecraft_version) (уже было указано)

Версия Forge (forge_version) (уже было указано)

ID мода (mod_id)

Название мода (mod_name)

И другие параметры, такие как авторы, описание и версия мода.

Все эти значения автоматически подтянутся в файл build.gradle через переменные, которые мы настроили в gradle.properties.

Пример:

Здесь переменные ${minecraft_version} и ${forge_version} будут заменены на соответствующие значения из gradle.properties. Это упрощает процесс настройки и минимизирует количество ручных изменений в файле build.gradle.

Или очевидный пример уже с нашим полем:

Дополнительно:
Если вы хотите, чтобы при сборке мода у вас указывалась версия игры. К примеру rinova-1.20.1-0.0.1, то следует поле version переделать в такой вид:
version = "${project.minecraft_version}-${project.mod_version}".

После окончания работы с build.gradle и gradle.properties, нужно чтобы gradle сохранил эти изменения (если что это будет работать только с подобными файлами в будущем). У вас справа сверху появится слоник, на который нужно нажать:

Ошибки, которые могли появится при старте проекта:

Главный класс мода — это центральное место, где будет начинаться выполнение вашего мода. В нем обычно инициализируются все компоненты мода, регистрируются блоки, предметы, события и другие элементы. Давайте рассмотрим, как настроить такой класс для вашего проекта. Находится этот файл по пути на картинке снизу:

Для начала переименуйте файл ExampleMod в соответствие с названием вашего мода, например RinovaMod или просто Rinova. Имейте в виду, что имена классов в Java пишутся в формате CamelCase (каждое новое слово с заглавной буквы). После удалите файл (класс) Config, он нам пока не нужен.

Открываем RinovaMod(ваше название).

Во первых для удобства в будущем (сам так делаю) переименуйте переменную MODID в MOD_ID. Используйте инструмент Refactor (выделите переменную MODID и нажмите Shift + F6), чтобы переименовать ее по всему проекту. И дайте этому поле значение, которое представляет собой айди вашего мода:

После нужно почистить этот файл (класс) от ненужного кода. Удаляем все, кроме того, что осталось на картинке:

Дополнительно:
Если нажать CTRL + ALT + L, то будет "чистый код" - правильно расставятся пробелы, скобки, переменные, удалятся ненужные импорты и т.д.

Чтобы запустить майнкрафт из проекта, откройте Gradle и обнаружьте runClient, дважды нажмите на него и ждите

Если вы все сделали правильно, то открыв "Моды" в майнкрафте, то обнаружите свой мод со всей информацией

Весь доступный код и изменения находятся по ссылке. Можете сравнить/скопировать и т.д. Я лично убрал так же все комментарии (//text), чтобы не мешало:
https://github.com/ringoway/Rinova/commit/b9e60e3e68590314d6ea77b94c67fa3ad200eb9c

Спасибо за внимание, Ждите следующих лекции!