Fabric Example Mod: соберите свой первый работающий мод для Java

Превратите исходный шаблон Fabric в работающий JAR мода, разберитесь в расположении файлов и внесите первое небольшое изменение, не затрагивая основную игру.

Язык материала

Самый полезный первый мод — тот, который вы умеете собрать, найти и снова запустить. Проект-пример Fabric даёт такую отправную точку: небольшую папку исходников, где код, ресурсы и настройки сборки уже связаны. Ваша задача — превратить эту работающую основу в собственную идею.

Что будет при первом запуске

Неизменённый пример не добавляет новый меч, механизм или биом. Первый успех состоит в том, что проект собирается и загружается. Mod Menu — отдельный помощник для просмотра загруженных модов, а не функция самого шаблона.

Fabric Example Mod загружен в Minecraft Java 26.2 и выбран в игровом Mod Menu.

Неизменённый пример для 26.2, собранный в JAR и загруженный в отдельной игре с Fabric. Поиск Example в Mod Menu помогает быстро его найти. Example Mod и Me! — временные название и автор в шаблоне; вы замените их, когда сделаете проект своим.

Выберите исходники для поддерживаемой версии игры

Откройте Файлы и сначала выберите целевую версию Minecraft. Здесь используется новый снимок исходников для 26.2. Более ранние снимки доступны для своих версий игры; используйте их, если проекту нужна именно эта версия.

Для снимка 26.2 используйте JDK 25. У старых снимков на этой странице свои требования к сборке. Изменение только номера Minecraft в файле сборки не обновляет автоматически весь окружающий код и зависимости.

От ZIP исходников до запущенного мода

  1. Распакуйте ZIP исходников в новую папку разработки. Откройте папку, где действительно находятся build.gradle, gradlew.bat и gradle.properties. В скачанном архиве репозитория вокруг них может быть дополнительная папка.
  2. Откройте терминал в этой папке. На Windows выполните .\gradlew.bat build. На macOS или Linux используйте ./gradlew build. Дождитесь завершения скачивания зависимостей сборки при первом запуске.
  3. После успешного завершения сборки откройте build/libs. Выберите обычный JAR мода. -sources.jar содержит исходный код и не является файлом для установки в обычную игру.
  4. Поместите обычный JAR в папку mods подходящей установки Fabric. Установите зависимости, заявленные в fabric.mod.json этого примера, затем запустите установку.
  5. Проверьте, что пример загружается, прежде чем менять его структуру. Сохраните первую работающую сборку для дальнейшего сравнения.

Для отдельной игры разработки выполните .\gradlew.bat runClient на Windows или ./gradlew runClient на macOS/Linux. Это запуск среды разработки шаблона, а не повод копировать исходные файлы в папку повседневных сохранений.

Внесите одно заметное изменение

Начните с отображаемого названия и автора в src/main/resources/fabric.mod.json, пересоберите проект и найдите новое название в списке модов. Это небольшое изменение с очевидным результатом. Освоив такой цикл, переходите к первому предмету или другой функции.

Переименование ID мода — более серьёзный шаг, чем смена отображаемого названия: от него могут зависеть точки входа, пакеты Java, ресурсы и ссылки mixin. Сохраняйте согласованность этих названий и меняйте по одному за раз. Небольшая работающая функция — лучшая основа для роста, чем большая папка наполовину связанных изменений.

Если вашей идее нужна модель или текстура, наше руководство по Blockbench начинается с небольшого фонаря. Отдельно решайте, что объект делает в моде и как он выглядит.

Если первая сборка застряла

  • Ошибка версии Java: выполните .\gradlew.bat --version и проверьте JVM, которую действительно использует Gradle. Установка нового JDK не всегда выбирает его в вашем редакторе.
  • Не скачивается зависимость: прочитайте сообщение о первом неудачном скачивании и повторите попытку, когда связь появится. Смена расширения ZIP не поможет.
  • JAR есть, но игра его не видит: проверьте запущенную установку, её версию Minecraft и загрузчик. Наше руководство по установке Fabric показывает, куда поместить готовый файл.
  • В мире ничего нового не появилось: исходный пример — стартовый проект, а не набор контента. Проверьте, что он загружается, прежде чем ждать функцию, которую вы ещё не добавили.
Пока нет оценок

Файлы

Фильтр файлов Файлов: 4Стабильная версия
Показать все файлы

Версия 26.2-source-1ce1c77a

Стабильный

fabric-example-26.2-1ce1c77a.zip

0 скачиваний
Скачать · 62,7 KB
Требования и подробности
  • Формат файла: .zip

ZIP исходников для Minecraft 26.2, а не устанавливаемый мод. Распакуйте его, используйте JDK 25, запустите сборку через Gradle wrapper, затем установите полученный обычный JAR в подходящую установку Fabric.

Требования и примечания
Обновление с предыдущей версии
Создавайте отдельную папку разработки для каждой целевой версии игры. Храните редактируемые исходники и готовый JAR отдельно.

Версия 1.21.1-source-684b5812

Стабильный

fabric-example-1.21.1.zip

0 скачиваний
Скачать · 64,6 KB
Требования и подробности
  • Формат файла: .zip

Версия 1.20.1-source-cf6a5284

Стабильный

fabric-example-1.20.1.zip

2 скачивания
Скачать · 64,6 KB
Требования и подробности
  • Формат файла: .zip

Версия 1.19.2-source-3ea0867c

Стабильный

fabric-example-1.19.2.zip

2 скачивания
Скачать · 64,6 KB
Требования и подробности
  • Формат файла: .zip

Изменения версий

Версия 26.2-source-1ce1c77a

Стабильный

Зафиксированные официальные исходники примера Fabric для Minecraft 26.2. В сопровождающем руководстве они собраны с JDK 25 и загружены как обычный JAR. Старые целевые версии исходников остаются в истории.

Посмотреть файлы

Версия 1.21.1-source-684b5812

Стабильный

Снимок исходников для Minecraft 1.21.1; исходный проект не присваивает этой ветке номер выпуска.

Источник: Исходные файлы Fabric Example Mod
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Версия 1.20.1-source-cf6a5284

Стабильный

Снимок исходников для Minecraft 1.20.1; исходный проект не присваивает этой ветке номер выпуска.

Источник: Исходные файлы Fabric Example Mod
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Версия 1.19.2-source-3ea0867c

Стабильный

Снимок исходников для Minecraft 1.19.2; исходный проект не присваивает этой ветке номер выпуска.

Источник: Исходные файлы Fabric Example Mod
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Комментарии 0

Расскажите, что сработало, попросите помощи или ответьте другому игроку.

Присоединиться к обсуждению

1Ваше имя и почта

Аккаунт не нужен. Подтвердите почту кодом перед первым комментарием. Рядом с именем показывается только частично скрытый адрес. Комментарии гостей проверяются перед публикацией.

2Подтвердить и опубликовать

Комментариев пока нет. Расскажите, что помогло вам.

Поиск по Modonix

Искать в