Weave

Weave

Weave — это слой совместимости и производительности для Kilt на Minecraft 1.20.1 Fabric. Он исправляет проблемы совместимости, которые могут возникать при загрузке Forge-модов через Kilt вместе с нативными Fabric-модами, стараясь сохранить обычное поведение Forge в Kilt там, где оно действительно нужно. Это МОЖЕТ улучшить совместимость с вашим модпаком, а может и не улучшить — тестирование проводилось на моём собственном паке примерно с 1k модов, так что, думаю, я загружаю Forge-моды в худшем случае. Изначально я сделал это, потому что даже не мог ЗАГРУЗИТЬ Kilt, конкретно из-за мультилоадерных модов, у которых совместимость с Forge и Fabric была в одном .jar

Что исправляет Weave

Лучшее разделение между Fabric- и Forge-модами

Kilt иногда может применять поведение, специфичное для Forge, к нативным Fabric-модам просто потому, что присутствуют связанные с Forge классы или код совместимости. Weave проверяет, действительно ли нужно поведение Forge, прежде чем позволить этим путям совместимости Kilt выполняться. Это также предотвращает:

• Случайный запуск Kilt собственных систем совместимости.
• Обращение с нативными Fabric-модами как с Forge-модами.
• Включение поведения Forge у мультилоадерных модов только потому, что они содержат опциональный код Forge.
• Автоматическое обращение с Fabric-модами, содержащими классы под net.minecraftforge.*, как с настоящими Forge-модами.
• Оставание активными несвязанных миксинов совместимости Kilt только потому, что где-то ещё нужна другая функция Forge.

Меньше конфликтов миксинов Kilt

Некоторые миксины совместимости Kilt должны существовать только тогда, когда от них зависит настоящий Forge-мод. Weave отключает ненужные хуки совместимости Kilt, сохраняя связанные части совместимости вместе, когда они требуются. Это уменьшает конфликты между Kilt и нативными Fabric-модами, не убирая поведение Forge, от которого зависят настоящие Forge-моды.

Исправления совместимости клавиш

Fabric-клавиши могли проходить через регистрацию клавиш, специфичную для Forge, и вызывать краши, включая проблемы с клавишами-модификаторами, такими как Alt. Weave разделяет привязки клавиш, принадлежащие Fabric и Forge, чтобы каждая использовала правильный путь регистрации.

Исправляет зависание при запуске FREEZE_DATA

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

Более безопасный запуск клиента и сетевое взаимодействие

Некоторые Forge-моды могут пытаться отправлять сетевые пакеты до того, как Minecraft полностью перейдёт в допустимое игровое состояние. Weave предотвращает выполнение этих вызовов слишком рано и ждёт, пока клиент действительно будет готов.

Улучшения совместимости с Architectury

Некоторые функции совместимости Kilt зависят от совместной работы нескольких хуков. Weave включает или отключает эти связанные части как группу, не позволяя частично активным системам совместимости оставлять после себя сломанное состояние во время выполнения.

Исправления совместимости подсказок

Хуки подсказок Forge могли оставаться активными там, где они не были нужны, и мешать нативному поведению Fabric. Weave ограничивает эти хуки путями кода, которые действительно в них нуждаются.

Поддержка AsyncParticles для частиц Forge

Weave добавляет поддержку AsyncParticles для частиц Forge, загружаемых через Kilt. Частицы Forge могут использовать асинхронную обработку, когда их рендерер с ней совместим. Рендереры, которым требуется обычный путь рендеринга Kilt/Forge, автоматически остаются на более безопасном синхронном пути вместо принудительного использования несовместимого рендерера. Тикинг и рендеринг частиц обрабатываются отдельно, поэтому частица не обязательно теряет асинхронный тикинг только потому, что её рендереру нужен обычный путь Forge.

Совместимость с кастомными моделями Forge

Система кастомных моделей Kilt зависит от совместной работы нескольких частей. Weave сохраняет эти части вместе, чтобы кастомные модели Forge не оставались в частично включённом состоянии, когда они десериализуются, но не рендерятся правильно, или наоборот.

Исправление краша Creative Inventory

Creative Inventory в Fabric может ненадолго оказаться в состоянии, когда его контекст отображения предметной группы ещё не создан. Совместимость Kilt могла попасть в это состояние и вызвать краш. Weave безопасно обрабатывает это конкретное временное состояние, не трогая несвязанные ошибки.

Исправляет испорченный текст и гигантские треугольники в меню

Kilt может глобально заменять обычные RenderTypes текста Minecraft на версии Forge. При пакетном рендеринге GUI некоторые текстовые украшения — особенно зачёркнутый текст с тенями — могли повредить буфер рендеринга и создать огромные диагональные треугольники или полосы по меню. Weave оставляет обычный Fabric- и ванильный текст на обычном пути рендеринга Minecraft и сохраняет путь текста Forge только тогда, когда код Forge действительно в нём нуждается.

Лучшая параллельность перестройки чанков Kilt + Sodium

Kilt использует глобальную блокировку синхронизации для определённых поисков Forge ModelData во время перестройки чанков Sodium. Weave сужает эту синхронизацию для моделей, использующих обычное поведение Forge по умолчанию getModelData, позволяя несвязанным чанкам перестраиваться более независимо. Модели с кастомным поведением Forge ModelData остаются на оригинальном безопасном пути Kilt.

Безопасный откат оптимизаций

Изменения производительности Weave рассчитаны на безопасный отказ. Если Weave не может распознать ожидаемый код Kilt, оптимизация просто не активируется и вместо неё используется оригинальное поведение Kilt.

Исправления совместимости для конкретных модов

Эти исправления были обнаружены через отдельные Forge-моды, но Weave обрабатывает их автоматически, и они не требуют изменённых версий этих модов.

Bosses Rise

Исправляет сбой Crossbow Pirate, которому нужен доступ к обычно package-private состоянию арбалета Minecraft при работе через Kilt. Weave предоставляет необходимый доступ автоматически.

Monster Expansion

Исправляет краш загрузки модели, вызванный попыткой Porting Lib вызвать clear() у неизменяемого пустого списка элементов модели. Weave безопасно обрабатывает именно этот случай пустого списка, не скрывая несвязанные ошибки моделей.