Grimoire API - Универсальный фреймворк для загрузки Mixin

Перед вами многоцелевая система для загрузки Mixin, созданная для разработки и применения миксинов в версиях Minecraft 1.7.10 и 1.12.2. Этот проект является независимым продолжением Legacy Grimoire и предлагает более простую и надежную альтернативу SpongeMixins для версии 1.7.10.

Для обычных пользователей

Если вы обычный игрок и попали сюда потому, что один из ваших модов требует Grimoire как зависимость - просто скачайте последнюю версию Grimoire для вашей версии Minecraft, поместите файл в папку mods, и всё готово!

Для разработчиков

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

• Встроенная библиотека Sponge Mixin, избавляющая от необходимости включать полную реализацию Mixin в ваш мод (что является плохой практикой)
• Версионно-независимое ядро - большая часть Grimoire API работает одинаково хорошо как на 1.7.10, так и на 1.12.2
• Система Grimmix для объявления присутствия фреймворка, обработки важных событий и взаимодействия между различными реализациями
• Простой API для создания конфигураций миксинов во время выполнения, вместо необходимости включать их в виде .json файлов
• Автоматическое разделение конфигураций на две категории: для Minecraft/Forge и для других модов, с загрузкой в правильное время
• Версионно-независимая реализация EventBus без лишних ASM элементов, более удобная для расширения
• Интегрированный Omniconfig API для создания конфигурационных файлов через IOmniconfigBuilder или @AnnotationConfig
• Интеграция с EventHelper для безопасного использования EventUtils без проблем с совместимостью в одиночной игре
• Полная поддержка среды разработки

Настройка рабочего пространства

Примеры настройки рабочего пространства для модов, зависящих от Grimoire:

• Для 1.7.10: https://github.com/Aizistral-Studios/ForgeWorkspaceSetup/tree/1.7.10-grimmix
• Для 1.12.2: https://github.com/Aizistral-Studios/ForgeWorkspaceSetup/tree/1.12.2-grimmix

Более подробную информацию вы найдете в наших репозиториях и на Wiki. Особо стоит отметить: Grimoire полностью поддерживает среду разработки! Запуск клиента через задачу runClient или конфигурацию запуска в IDE обеспечит правильную загрузку Grimoire и всех зависимых grimmix. Генерация refmap также работает безупречно, поэтому нет необходимости ориентироваться на обфусцированные имена и жертвовать совместимостью со средой разработки.