MagicLib

MagicLib

中文

❗Прежде чем сообщать о проблеме, обязательно попробуйте последнюю бета-версию, чтобы проверить, осталась ли проблема.

Описание

Библиотека универсальных зависимостей для модов.

Зависимости

Возможности

Compat API

• Совместимость с несколькими версиями — да, мы использовали ряд средств, чтобы обеспечить совместимость со всеми последними релизами Minecraft (1.14+), работающими на Fabric Loader. Как это сделано? Магия :(
• Мы написали API совместимости для сглаживания различий между версиями. Разработчикам, поддерживающим несколько версий MC для модов одновременно, можно в определённой степени игнорировать изменения MC от Mojang. Вам не нужно заботиться о том, что сделала Mojang, — с этим API вы легко сможете использовать один и тот же код между версиями MC.

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

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

• MagicLibMixinPlugin обеспечивает дополнительную проверку зависимостей для модуля, что компенсирует некоторые недостатки Fabric Loader, например, позволяет задать разные зависимости для клиентской и серверной стороны.
• Проверку зависимостей также можно применять к Mixin, и Mixin будет применён только при выполнении условий.
• Проверку зависимостей также можно применять к управлению конфигурацией, чтобы пункт конфигурации отображался только при выполнении условий.
• В будущих разработках могут появиться и другие возможности.

I18n

• Мы заново реализовали I18n независимо от MC и можем задать список альтернативных языков для MagicLib I18n. Mojang использует некоторые трюки с текстом I18n, из-за чего часть возможностей String.format недоступна, что обычно раздражает.

Расширения Malilib

• Мы написали очень полезный модуль управления конфигурацией для Malilib, в котором по возможности используем базовые типы данных с Java-аннотациями для генерации списков конфигурации. Кроме того, для файлов конфигурации мы добавили систему версионирования конфигурации, которая поможет вам быстро написать собственное решение для миграции в случае серьёзного изменения структуры файла конфигурации.
• Мы перенесли некоторые возможности из более высокой версии Malilib, чтобы было проще использовать те же функции при работе с Malilib, адаптированным под более низкую версию Minecraft

Разработка

Поддержка

Текущая основная разработка ведётся для версии Minecraft: 1.20.1

И используется preprocess для совместимости со всеми версиями.

Примечание: я принимаю issues только для следующих версий. Учтите, что эта информация может устареть, и любой issue с версией, не указанной здесь, будет закрыт

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

Маппинги

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

Документация

Английская и китайская документация синхронизированы построчно.

Лицензия

Этот проект доступен по лицензии LGPLv3. Не стесняйтесь изучать его и включать в свои проекты.