Compat API

Знакомая ситуация: собираешь огромную сборку модов для Майнкрафт, ставишь кучу аддонов, а половина из них просто не видит друг друга. Предметы из одного мода не работают в крафтах другого, интеграции нет. Разработчикам тоже несладко - приходится вручную прописывать костыли для каждого нового мода. Compat API (или Компат АПИ, как его часто ищут) решает эту проблему раз и навсегда.

Это легкая и универсальная библиотека для Fabric, Forge, NeoForge и Quilt, которая берет на себя всю грязную работу по обеспечению кросс-совместимости. Проект создавался как стандарт для целой экосистемы - Compat Delight, Compat Artifacts, Compat Decor и других. Суть проста: вместо жесткого прописывания логики в коде, API автоматически подгружает нужные классы, датапаки и модификаторы добычи (loot modifiers), но только если целевой мод уже установлен в клиенте.

Как это работает

По факту, от игрока или админа сервера требуется только одно - скачать мод Compat API и закинуть его в папку mods. Дальше магия происходит автоматически.

Если какой-то мод зависит от этой библиотеки и содержит в себе папки с интеграциями, АПИ сам их найдет. Он подхватит код, добавит нужные датапаки и настроит условия. А если целевого мода нет - интеграция просто не загрузится. Никаких ошибок, крашей или ручных настроек не нужно.

Ключевые особенности

• Умный сканер совместимости - система сканирует только те моды, которые явно требуют Compat API. Остальные просто игнорируются, что экономит ресурсы.
• Автозагрузка кода - библиотека сама находит классы совместимости (в директории вроде net.<owner>.<modid>.compats.<target>) и запускает их инициализацию.
• Инъекция датапаков - если в игре есть нужный мод, API автоматически подключает встроенные датапаки из data/<owner>/<modid>/compats/<target>. Рецепты и лут заработают сразу.
• Глобальные модификаторы лута - автоматическая генерация списка модификаторов и добавление условий для них. Сундуки будут правильно генерировать предметы из других модов.
• Безопасность и стабильность - даже если в коде совместимости есть ошибка, игра не вылетит. Проблема запишется в лог и интеграция просто пропустится. Это мастхэв для тяжелых сборок, где краш одного аддона может убить весь сервер.
• Индивидуальные настройки - каждую интеграцию можно включить или выключить через конфиг. Не нравится, как мод X работает с модом Y? Просто отключи это в конфигурационном файле.

Важный нюанс

Если вы собираете крупную сборку модов для Minecraft (например, на основе чего-то вроде All The Mods), обязательно держите Compat API в списке. Главная фишка в том, что библиотека не нагружает процессор лишними проверками - она не сканирует каждый мод в папке, а берет только те, что зависят от нее напрямую. На слабом железе это критично.

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

В итоге, Compat API - это фундамент для бесшовной интеграции. Он экономит время разработчикам и нервы игрокам. Скачайте мод Compat API для Майнкрафт, установите его в клиент, и забудьте о проблемах с совместимостью аддонов.