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

Неизменённый пример для 26.2, собранный в JAR и загруженный в отдельной игре с Fabric. Поиск Example в Mod Menu помогает быстро его найти. Example Mod и Me! — временные название и автор в шаблоне; вы замените их, когда сделаете проект своим.
Выберите исходники для поддерживаемой версии игры
Откройте Файлы и сначала выберите целевую версию Minecraft. Здесь используется новый снимок исходников для 26.2. Более ранние снимки доступны для своих версий игры; используйте их, если проекту нужна именно эта версия.
Для снимка 26.2 используйте JDK 25. У старых снимков на этой странице свои требования к сборке. Изменение только номера Minecraft в файле сборки не обновляет автоматически весь окружающий код и зависимости.
От ZIP исходников до запущенного мода
- Распакуйте ZIP исходников в новую папку разработки. Откройте папку, где действительно находятся build.gradle, gradlew.bat и gradle.properties. В скачанном архиве репозитория вокруг них может быть дополнительная папка.
- Откройте терминал в этой папке. На Windows выполните .\gradlew.bat build. На macOS или Linux используйте ./gradlew build. Дождитесь завершения скачивания зависимостей сборки при первом запуске.
- После успешного завершения сборки откройте build/libs. Выберите обычный JAR мода. -sources.jar содержит исходный код и не является файлом для установки в обычную игру.
- Поместите обычный JAR в папку mods подходящей установки Fabric. Установите зависимости, заявленные в fabric.mod.json этого примера, затем запустите установку.
- Проверьте, что пример загружается, прежде чем менять его структуру. Сохраните первую работающую сборку для дальнейшего сравнения.
Для отдельной игры разработки выполните .\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 показывает, куда поместить готовый файл.
- В мире ничего нового не появилось: исходный пример — стартовый проект, а не набор контента. Проверьте, что он загружается, прежде чем ждать функцию, которую вы ещё не добавили.
Комментарии 0
Расскажите, что сработало, попросите помощи или ответьте другому игроку.
Войдите в аккаунт Modonix, чтобы участвовать в обсуждении и управлять своими комментариями.
Войти и комментироватьКомментариев пока нет. Расскажите, что помогло вам.