MagicLib

MagicLib представляет собой универсальную библиотеку зависимостей для модов Minecraft, которая значительно упрощает процесс разработки и обеспечивает совместимость между различными версиями игры.

Основные возможности

Совместимость между версиями

Библиотека предлагает мощный API для обеспечения совместимости, позволяющий разработчикам создавать моды, которые работают на всех современных версиях Minecraft (начиная с 1.14) под управлением Fabric Loader. Специально разработанные интерфейсы сглаживают различия между версиями, что избавляет от необходимости постоянно адаптировать код под изменения, вносимые Mojang.

Система проверки зависимостей

Встроенная система проверки зависимостей использует выражения и пользовательские условия для определения доступности необходимых компонентов. Эта функциональность применяется в различных сценариях:

• MagicLibMixinPlugin предоставляет дополнительную проверку зависимостей для модулей
• Возможность настройки разных зависимостей для клиентской и серверной сторон
• Условное применение Mixin только при выполнении определенных условий
• Управление отображением элементов конфигурации в зависимости от доступности компонентов

Локализация (I18n)

Реализована независимая от Minecraft система локализации с возможностью установки альтернативных языков. Решена проблема с ограничениями стандартной системы локализации Mojang, которая делает недоступными некоторые функции String.format.

Расширения для MaliLib

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

Технические особенности

Поддерживаемые версии

Основная разработка ведется для Minecraft 1.20.1 с использованием технологии preprocess для обеспечения совместимости со всеми версиями. Поддерживаются следующие версии Minecraft:

• 1.14.4
• 1.15.2
• 1.16.5
• 1.17.1
• 1.18.2
• 1.19.2
• 1.19.3
• 1.19.4
• 1.20.1

Зависимости

• Carpet (опционально) - клиент/сервер
• MaliLib (опционально) - клиент
• Mod Menu (опционально) - клиент

Техническая информация

Для деобфускации Minecraft и применения патчей используются официальные маппинги Mojang. Документация на английском и китайском языках синхронизирована построчно.

Лицензия

Проект распространяется под лицензией LGPLv3, что позволяет свободно изучать код и использовать его в собственных проектах.