NeoBackports

Библиотека для использования возможностей и методов NeoForge 1.21.1 на Forge 1.20.1

Этот мод предназначен для использования в качестве библиотеки, включаемой в другие моды. На данный момент единственные самостоятельные функции — размытые фоны интерфейса в стиле 1.21. Установка вручную более новой версии, чем упакованная, полезна только для исправления багов

Текущие возможности включают:

• Datamaps
• Компоненты данных
• Присоединения данных
• Stream codecs
• Размытые фоны интерфейса (включаются встроенным ресурспаком)
• DeferredHolders (и их подтипы)
• Сетевое взаимодействие в стиле 1.21.1
• Сериализаторы рецептов с кодеками
• Методы useItemOn и useWithoutItem для блоков

... и множество удобных расширений интерфейсов

Вопросы и ответы

• Зачем портировать обратно на 1.20.1? Разве не логичнее помочь разработчикам портировать вперёд, а не назад?
• Создавать библиотеку для прямого портирования принципиально бессмысленно, так как она несёт технический долг и потребует портирования библиотеки вверх с каждой новой версией. Разработчики никогда не привыкнут к новым возможностям, даже когда они объективно лучше, и будут делать более лагучие и багованные моды. Такой подход позволяет удовлетворить аудиторию 1.20, одновременно подталкивая её к новым версиям
• Это звучит как мод типа synitra connector, мог бы он так работать?
• Теоретически, если я вложу в это много работы, он мог бы заставить очень маленькие моды для 1.21.1 работать на 1.20.1, но поддержка была бы крайне ограниченной, так что это не стоит времени. Короче: НЕТ

Инструкция по установке

Поскольку эта библиотека использует инъекции интерфейсов, требуется переключиться с ForgeGradle на gradle-плагин ModDevGradle Legacy. Документация здесь и рабочий MDK здесь

В build.gradle:

repositories {
    // Some other repositories you might have...
    
    maven {
        url = 'https://nikdo53.github.io'
    }
}


dependencies {
    // Some other dependencies you might have...

    jarJar(modImplementation("net.nikdo53:NeoBackports:${neobackports_version}"))
    interfaceInjectionData("net.nikdo53:NeoBackports:${neobackports_version}")
}

В gradle.properties:

# Set to whatever is latest
neobackports_version=1.4.1

Технические отличия

Возможности не портированы один в один (из-за различий бэкенда между версиями), но должны быть достаточно похожи, чтобы большинство модов просто работало без серьёзных отличий

Названия классов

Чтобы различать оригинальные классы forge/vanilla и портированные, портированные классы получают суффикс "neo", например:

• SmithingRecipe -> SmithingRecipeNeo
• PacketDistributor -> PacketDistributorNeo
• DeferredRegister -> DeferredRegisterTyped (этот отличается, потому что я забыл)

Компоненты данных/присоединения

В отличие от 1.21.1, это всего лишь умные обёртки для существующих возможностей (item nbt и capabilities соответственно), что означает, что другие моды, не использующие этот API, смогут обращаться к ним как обычно.

Datamaps

Они были (с разрешения) портированы напрямую из кода neoforge с минимальными отличиями. Учтите, что пакет входа, который согласовывал известные datamaps, был удалён, и необязательные обычно не поддерживаются. Возможно, я вернусь к этому в будущем, но поскольку этот мод требуется и на клиенте, и на сервере, это, вероятно, не очень полезно (и пакеты входа 1.20.1 странные)

Stream codecs

Дженерик ByteBuf был удалён, поскольку всё использует FriendlyByteBuf:

StreamCodec<RegistryFriendlyByteBuf, SomeClass> -> StreamCodec