FoxifiedClassTweaker

Мод FoxifiedClassTweaker для Minecraft — поддержка ClassTweaker для NeoForge

FoxifiedClassTweaker — это библиотека для NeoForge, созданная автором TexTrue, которая добавляет поддержку ClassTweaker и AccessWidener в проект FancyModLoader. Она позволяет разработчикам модов использовать эти инструменты для изменения классов игры и расширения доступа к API внутри среды NeoGradle и других инструментов сборки, аналогично тому, как это делается в Fabric API с помощью ClassTweaker.

Назначение и роль библиотеки

FoxifiedClassTweaker — это техническая библиотека для экосистемы NeoForge, разработанная автором TexTrue. Её главная задача — предоставить функционал ClassTweaker и AccessWidener для модов, использующих загрузчик FancyModLoader. Ранее эти инструменты были стандартом для Fabric, но их отсутствие в NeoForge ограничивало возможности по глубокой модификации классов игры и расширению доступа к API. Этот мод заполняет эту нишу, позволяя разработчикам применять те же методы рефакторинга и изменения структуры кода, что и в других загрузчиках.

Окружение разработки: Loom против Gradle

Для профессиональной разработки модов, требующих ClassTweaker или AccessWidener, рекомендуется использовать среду разработки Loom (например, Architectury Loom или Neo-loom). Эти инструменты предоставляют готовую поддержку обработки классов. Если же вы используете NeoGradle или ModDevGradle, этот мод выступает в роли недостающего звена. В таких случаях необходимо вручную добавить конфигурацию для указания путей к файлам ClassTweaker, так как стандартные плагины Gradle не умеют их обрабатывать без дополнительной настройки.

Конфигурация NeoForge

Чтобы включить поддержку ClassTweaker в свой мод, необходимо добавить соответствующий блок в файл `META-INF/neoforge.mods.toml`. Это сообщает загрузчику, где искать файлы `ClassTweaker` или `AccessWidener`, которые должны быть размещены в соответствующей директории вашего проекта. Файлы должны быть теоретически совместимы с AccessWidener.

Встроенная сборка (Jar-in-Jar)

Если вы не хотите, чтобы игроки скачивали эту библиотеку отдельно, её можно включить как jar-in-jar (вложенный JAR) непосредственно в основной файл вашего мода. Для этого используется специальный процессор, доступный через репозиторий KTTMaven. В этом случае зависимости добавляются в build.gradle, а мод автоматически обрабатывает файлы ClassTweaker во время сборки, скрывая их наличие от конечного пользователя.

Зависимость процессора в Gradle

При использовании NeoGradle для сборки проекта, где требуется обработка через ClassTweaker, необходимо добавить репозиторий и зависимость-процессор. Это позволит компилятору корректно обработать файлы конфигурации и скомпилировать мод с встроенной поддержкой ClassTweaker.

Связанные материалы

• Fabric API — похожий мод
• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Architectury API — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: TexTrue · Лицензия: Apache-2.0