Compat API

📖 О моде

Compat API — это лёгкий и универсальный фреймворк совместимости для всей экосистемы «Compat» от fixerlink — включая Compat Delight, будущие Compat Artifacts, Compat Decor и любой сторонний мод, который хочет получить простой автоматизированный способ добавления кросс-модовых интеграций.

Вместо того чтобы прописывать логику совместимости вручную или управлять дата-паками, Compat API берёт всё на себя: автоматически загружает код совместимости, внедряет дата-паки, оборачивает модификаторы лута, применяет условия и включает интеграции только тогда, когда установлены нужные моды.

📃 Возможности

• Умный сканер совместимости: загружает интеграции только из модов, которые явно зависят от Compat API.
• Автоматическая загрузка кода совместимости: Находит модули совместимости в `net...compats.` и автоматически запускает их хуки register, init или bootstrap.
• Автоматическое внедрение дата-паков: Загружает контент из `data///compats/` как встроенные дата-паки — только если целевой мод существует.
• Универсальная система модификаторов лута: Автоматически добавляет условия совместимости и генерирует список глобальных модификаторов лута.
• Условия совместимости: Встроенное условие compatapi:compat_enabled гарантирует, что интеграции загружаются безопасно и только когда это уместно.
• Переключатели конфига для каждой цели: Каждый модуль совместимости можно включать или отключать отдельно через конфиг.
• Безопасная и чистая система: Ошибки совместимости никогда не крашат игру — они логируются и аккуратно пропускаются.

📝 Описание

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

Вы устанавливаете Compat API. Всё.

Если мод зависит от Compat API и содержит модули совместимости, API:

• найдёт его код совместимости
• внедрит его дата-паки
• обернёт его модификаторы лута
• применит условия
• и автоматически включит интеграции

Если целевой мод отсутствует — совместимость просто не загрузится. Никаких ошибок, крашей и ручной настройки. Моды могут свободно добавлять папки и классы совместимости — Compat API делает всю тяжёлую работу. И конечно, каждую интеграцию можно переключить через конфиг.

🎁 Дополнительная информация

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

🧾 Благодарности

Compat API разработан fixerlink как универсальный стандарт для всех модов серии Compat и для разработчиков, которые хотят чистые, модульные и автоматизированные кросс-модовые интеграции.

Отзывы приветствуются!