Mod Remapping API

Mod Remapping API - это не контентный мод, а техническая библиотека для Minecraft на загрузчике Fabric. Она не добавляет блоки, мобов или биомы. Вместо этого она решает куда более фундаментальную проблему: заставляет моды, написанные под одну среду (например, под обфусцированный ванильный код или старый Forge), корректно работать в другой среде с совершенно другими названиями классов и методов.

Зачем вообще нужен ремаппинг в Майнкрафт

Когда вы запускаете Minecraft, игра использует обфусцированный код - все названия классов, методов и полей заменены на бессмысленные комбинации вроде abc.a(). Это сделано специально, чтобы усложнить создание читов. Но мододелы не работают с обфусцированным кодом напрямую. Они используют mappings - специальные таблицы соответствий, которые переводят abc.a() в понятное PlayerEntity.getHealth().

Проблема в том, что разные загрузчики и разные версии игры используют разные mappings. Fabric использует Yarn, Forge - MCP (или Mojang Official Mappings в новых версиях), а старые моды для Rift или Legacy Forge - вообще свои собственные таблицы. Если вы попытаетесь запустить мод, написанный под одни mappings, в среде с другими mappings - игра просто крашнется, потому что мод будет искать метод getHealth(), а найдёт abc.a() или вообще ничего.

Mod Remapping API решает эту проблему. Он перехватывает загрузку модов, которые не были изначально скомпилированы под текущую среду, и на лету переименовывает все классы, методы и поля в соответствии с актуальными mappings вашей версии Minecraft. Проще говоря, это переводчик между разными диалектами моддинга.

Как это работает на практике

По умолчанию мод настроен на ремаппинг из обфусцированной среды (то есть из ванильного кода игры) в текущие runtime mappings Fabric. Но главная фишка - это хуки (hooks). Другие моды могут подключаться к Mod Remapping API и расширять процесс ремаппинга под свои нужды. Например, добавить поддержку специфических mappings старого Forge или Rift.

Сам по себе Mod Remapping API не делает ничего видимого для игрока. Вы не увидите новых предметов или изменений в геймплее. Но без него не запустятся другие проекты, которые позволяют играть в старые моды на новых версиях Майнкрафт. Это инфраструктурная библиотека, фундамент для более крупных проектов.

Какие моды используют Mod Remapping API

На данный момент известны три крупных проекта, которые зависят от этой библиотеки:

• Fabricated Legacy Forge - позволяет запускать моды для старых версий Forge (1.2.5 - 1.5.2) на современном Fabric
• Apron - аналогичный проект для запуска модов эпохи Beta Minecraft
• Fabricated-Rift - даёт возможность запускать моды для Rift (предшественник Fabric для версии 1.13) на актуальных версиях игры

Все эти проекты используют Mod Remapping API как основу для трансляции вызовов из старых модов в современную среду Fabric. Без этой библиотеки им пришлось бы реализовывать ремаппинг с нуля, что крайне сложно и требует глубокого понимания байткода и внутренностей Minecraft.

Совместимость и версии

Разработчик заявляет, что мод не привязан к конкретной версии Minecraft и должен работать на любой версии, которую может запустить Fabric Loader. На практике это означает поддержку широкого диапазона версий - от старых до современных 1.20.x и 1.21.x. Но конкретная комбинация версий игры и загрузчика может меняться от релиза к релизу, поэтому перед установкой лучше проверить актуальную информацию на странице мода.

Сама библиотека требует только Fabric Loader. Fabric API не обязателен, так как Mod Remapping API работает на более низком уровне - он вмешивается в процесс загрузки классов, а не использует готовые хуки Fabric API.

Для кого этот мод

Если вы обычный игрок, который просто хочет добавить новые биомы или мебель в игру - этот мод вам не нужен. Он не добавляет контент и ничего не меняет в геймплее.

Но если вы хотите запустить легендарные моды из эпохи Beta или раннего Forge на современном Майнкрафт - без Mod Remapping API не обойтись. Это незаменимый инструмент для проектов типа Fabricated Legacy Forge, которые возрождают классику моддинга.

Также библиотека полезна для разработчиков, которые портируют старые моды на новые версии или создают прослойки совместимости между разными загрузчиками. Хуки для расширения процесса ремаппинга позволяют адаптировать API под специфические задачи.

Важный нюанс

Mod Remapping API - это инструмент для энтузиастов и разработчиков. Если вы просто установите его в модпак без модов, которые его используют, эффекта не будет никакого. Библиотека активируется только тогда, когда другой мод явно запрашивает ремаппинг.

Также стоит понимать, что ремаппинг - это не магия. Если старый мод использовал методы или классы, которых больше нет в современном Minecraft, никакой ремаппинг не поможет. Mod Remapping API переводит названия, но не добавляет удалённый функционал обратно в игру. Для этого нужны более комплексные решения типа Fabricated Legacy Forge, которые эмулируют старое окружение.

Техническая база

Большая часть оригинального кода для ремаппера взята из мода BetaLoader от paulevsGitch. Это проверенное временем решение, которое адаптировано и расширено для работы в качестве универсального API.

Скачать Mod Remapping API имеет смысл только если вы планируете использовать моды, которые от него зависят. В одиночку он бесполезен, но в связке с проектами типа Fabricated Legacy Forge открывает доступ к огромному пласту классических модов, которые иначе остались бы в прошлом.