Введение в Fabric и создание модов
Краткое знакомство с Fabric и созданием модов для Minecraft: Java Edition.
WARNING
Эта страница написана для версии 1.21.10. Документация для более старых версий может быть неполной.
Предварительные условия
Перед тем как начать, вам следует иметь базовые знания разработки на Java и понимание концепций объектно-ориентированного программирования (ООП).
Если эти концепции вам не знакомы, рекомендуем сначала изучить несколько учебных материалов по Java и ООП. Эти ресурсы могут помочь:
Терминология
Прежде чем начнём, давайте рассмотрим некоторые термины, с которыми вы столкнётесь при создании мода на Fabric:
- Мод: изменение игры, добавляющее новые функции или изменяющее существующие;
- Загрузчик модов: инструмент для загрузки модов в игру, такой как Fabric Loader;
- Миксин: инструмент для модификации кода игры во время её выполнения — подробнее в знакомстве с миксинами;
- Gradle: инструмент автоматизации сборки, применяемый для создания и компиляции модов. Fabric использует его для сборки своих модов;
- Маппинги: набор маппингов, преобразующих обфусцированный код в тот, который может прочесть человек;
- Обфускация: процесс усложнения кода для его затруднённого понимания, используемый Mojang для защиты кода Minecraft;
- Ремаппинг: процесс преобразования обфусцированного кода в тот, который будет читаем для людей.
Что такое Fabric?
Fabric — лёгкий инструмент для создания модов для Minecraft: Java Edition.
Он разработан как простая и удобная платформа для разработки модов. Fabric — это проект, который ведёт сообщество, и у него открытый исходный код, что означает, что любой может внести в него свой вклад.
Вам следует знать о четырёх основных компонентах Fabric:
- Fabric Loader: гибкий загрузчик модов, не зависящий от платформы, предназначенный для Minecraft и других игр и приложений;
- Fabric Loom: плагин для Gradle, позволяющий разработчикам легко разрабатывать и отлаживать моды;
- Fabric API: набор API и инструментов для разработчиков модов, которые можно использовать при создании модов;
- Yarn: набор открытых маппингов Minecraft, свободных для использования под лицензией Creative Commons Zero.
Почему Fabric необходим для модификации Minecraft?
Модификация игры — это процесс изменения игры с целью изменения её поведения или добавления новых возможностей. В случае Minecraft это может включать в себя всё, от добавления новых предметов, блоков или существ до изменения механик игры или добавления новых режимов игры.
Minecraft: Java Edition обфусцирован компанией Mojang, что делает самостоятельное модифицирование сложным. Однако с помощью инструментов для модификации, таких как Fabric, процесс становится намного проще. Существуют различные системы маппинга, которые могут помочь в этом процессе.
Loom преобразует обфусцированный код в читаемый формат с помощью этих маппингов, что облегчает мододелам понимание и изменение кода игры. Yarn является популярным и отличным выбором для маппинга, но также существуют и другие варианты. Каждый проект маппинга может иметь свои собственные достоинства и фокусироваться на различных аспектах.
Loom позволяет с лёгкостью разрабатывать и компилировать моды на основе кода, над которым провели ремаппинг, а Fabric Loader позволяет загружать эти моды в игру.
Что даёт Fabric API и зачем это нужно?
Fabric API — это набор API и инструментов для разработчиков модов, которые можно использовать при создании модов.
Fabric API предоставляет широкий набор API, которые расширяют существующие функциональные возможности Minecraft. Например, он предлагает новые хуки и события, которые могут использоваться мододелами, или новые утилиты и инструменты, упрощающие процесс модификации игры, такие как транзитивные расширители доступа и возможность доступа к внутренним реестрам, таким как реестр предметов, которые можно использовать в компостнице.
Хотя Fabric API предлагает довольно мощные функции, некоторые задачи, такие как базовая регистрация блоков, можно выполнять и без него, используя стандартные API Minecraft.