UniMixins

Унимиксины

UniMixins — это загрузчик миксинов для Minecraft 1.7.10 (с частичной поддержкой 1.8.9~1.12.2), разработанный для максимальной совместимости. Он направлен на объединение функций как можно большего количества миксинов-загрузчиков, а его модульная природа позволяет при желании использовать вместе с другими загрузчиками.

Фон

Для версии 1.7.10 существует множество загрузчиков Mixin, и каждый из них предоставляет свой набор дополнительных функций, которые мы называем "дополнительными" помимо предоставления Mixin.

Поскольку каждый из этих загрузчиков является монолитным, одновременное использование разных загрузчиков невозможно из-за неизбежного дублирования функций. Чтобы избежать этой проблемы, UniMixins предлагает каждую функцию в виде отдельного модуля (но для удобства по-прежнему предоставляется комбинированный jar-файл).

Сравнительная таблица

Ниже приведена таблица, в которой сравниваются наборы функций известных загрузчиков Mixin.

Примечание. Более подробная версия этой таблицы доступна здесь.

• [NOP]: Ничего не делает. (выпуск)
• [SEP]: доступен как отдельный мод.

Использование

Загрузите jar -all и поместите его в каталог модов. Удалите все другие конфликтующие загрузчики Mixin (см. таблицу выше).

Примечание: важно, чтобы jar-файл назывался так, чтобы он шел первым в алфавитном порядке, чтобы избежать проблем с сортировкой с модами, встраивающими Mixin. Вот почему jar начинается с символа +. Возможно, вам придется изменить его на символ !, если у вас возникнут проблемы с переименованными jar-файлами.

Для справки, вот порядок сортировки некоторых примечательных символов: ! < + < 0 < [ < _ < a

Advanced usage

You can also assemble your own combination of modules using the module jars. Some modules depend on other modules, see the List of modules section.

Assuming no other Mixin loaders are present, you will generally want the following modules:

• Mixin (any single fork)
• Compat and Mixingasm (optional but highly recommended)
• Modules providing any extras you need

The game will crash if modules are missing dependencies. This can be disabled in the config.

List of modules

All modules depend on the Mixin module. Note that the dependents don't necessarily have to come from UniMixins modules, other mods may also be used to provide them.

Included in all-jar

• Mixin (UniMix): Provides a Mixin fork maintained by the UniMixins developers, based on the Fabric fork.

• SpongeMixins [только для версии 1.7.10]: Обеспечивает эмуляцию дополнительных возможностей SpongeMixins.

• MixinBooterLegacy [только для версии 1.7.10]: Обеспечивает эмуляцию дополнительных возможностей MixinBooterLegacy и перемещенный файл MixinExtras.

• MixinExtras: предоставляет MixinExtras.

• GasStation [только для версии 1.7.10]: Обеспечивает эмуляцию дополнительных возможностей GasStation.

  • Зависит от SpongeMixins.
  • Зависит от MixinBooterLegacy.
  • Зависит от MixinExtras

• GTNHMixins [только для версии 1.7.10]: Обеспечивает эмуляцию дополнений GTNHMixins] и перемещенный MixinExtras.

  • Зависит от SpongeMixins.

• Совместимость: различные настройки совместимости:

  • Переназначает неверные ссылки на классы Mixin (в частности, затененный ASM) в модах.
  • Добавляет информацию о миксинах в отчеты о сбоях. [только для версии 1.7.10]

• Mixingasm: улучшена совместимость Mixin с преобразователями ASM.

Необязательно

• Будущая совместимость [только для версии 1.8.9+]: делает многие модули пригодными для использования в версии 1.8.9+. Необходим для запуска мода на версии 1.8+. (Не требуется для Mixingasm.)

Очень необязательно

Они не включены в релизы, они в основном существуют для целей тестирования. (Примечание: одновременно можно использовать только один модуль Mixin.)

• Mixin (SpongePowered): предоставляет восходящую вилку Mixin.
• Mixin (Fabric): предоставляет вилку Fabric Mixin.
• Mixin (GasMix): предоставляет вилку GasStation Mixin.
• Mixin (GTNH): предоставляет вилку GTNH Mixin.

Часто задаваемые вопросы

Зачем еще один загрузчик миксинов? Разве вы не видели эту полоску xkcd?

До создания UniMixins загрузчики Mixin в версии 1.7.10 были слишком сильно фрагментированы: разные моды требовали разных несовместимых загрузчиков. Частично это произошло из-за конфликтов между их разработчиками, а частично по техническим причинам (загрузчики были спроектированы монолитно, что влечет за собой несовместимость). В этом проекте нет ни одной из этих проблем.

Почему вы используете вилку Mixin Fabric? Разве это не мод Forge?

Вилка Fabric Mixin поддерживается более активно, чем предыдущая вилка, и имеет некоторые дополнительные исправления. Большинство изменений вилки Fabric не относятся к конкретной Fabric.

Чем вообще занимаются «статусы»?

• SpongeMixins, Grimoire, MixinBooterLegacy, GasStation и GTNHMixins предлагают различные способы, позволяющие вам смешиваться с классами неосновных модов. (Это то, что Mixin изначально не поддерживает, поскольку все его этапы происходят до того, как Forge обнаружит некоровые моды и поместит их в путь к классам.)
  • MixinBooterLegacy, GasStation и GTNHMixins добавляют «позднюю» фазу миксина, которая запускается непосредственно перед отправкой первого события создания мода. На данный момент все моды обнаружены.
  • SpongeMixins позволяет заранее вручную добавлять моды в путь к классам, используя их имена файлов. Старое, хакерское решение.
  • Мы рекомендуем новым модам использовать GTNHMixins, поскольку это наиболее активно используемый и поддерживаемый вариант.
• Mixingasm исправляет проблему Mixin , которая ломала некоторые преобразователи ASM из-за того, что Mixin менял способ их вызова.
• MixinExtras добавляет новые функции Mixin, которые позволяют модам писать менее навязчивые миксины.

Миксин? миксин? Губка-миксины? Губка Powered? Какая разница?

• Mixin: библиотека Java, позволяющая плавно преобразовывать классы Java.
• SpongePowered: организация, создавшая Mixin (которая также разработала API для моддинга под названием Sponge).
• mixin: специальный класс Java, определяющий «изменение», которое должно быть применено к классу. Они применяются Mixin.
• SpongeMixins: загрузчик миксинов, созданный TimeConqueror, с очень общим именем.

Лицензия

UniMixins распространяется по лицензии Unlicense, за исключением некоторых модулей. Подробную информацию см. в ЛИЦЕНЗИЯ].