Create Collision Crashfix

Create Collision Crashfix - небольшой технический мод для Minecraft 1.21.1, который устраняет критический краш сервера в Create 6.0.10. Ошибка возникает при проверке столкновений движущегося механизма: в редком случае игра обращается к отсутствующей оси столкновения и завершает серверный тик с NullPointerException: mf.axis is null.

Чаще всего проблему вызывают карьеры на rope pulley с буровой установкой, особенно если блок шкива расположен в центральной колонне. Похожий сбой возможен у вращающихся подшипников и ферм с механической пилой. Если механизм загружает мир и снова вызывает ошибку каждый тик, сохранение может попасть в цикл крашей. Create Collision Crashfix закрывает этот сбой, не меняя поведение обычных столкновений.

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

При точном совпадении центра хитбокса существа с центром блока движущегося механизма расстояние между ними становится нулевым. В этом пограничном случае Create не записывает ось разделения столкновения, а затем пытается прочитать её как обычный вектор. В результате сервер падает.

Фикс добавляет проверку двух потенциально пустых векторов. Если ось отсутствует, вместо неё используется Vec3.ZERO: это нейтрализует столкновение только на текущем тике. Ненулевую ось подставлять нельзя, поскольку вместе с ней может примениться предельное значение расстояния и сущность будет отброшена на огромное расстояние. На следующем тике столкновение рассчитывается штатно.

Изменение сделано точечно через один Mixin и затрагивает только проблемное чтение полей в коде Create. Обычная физика механизмов не меняется, а существа не должны застревать или проходить сквозь блоки из-за этого исправления.

Совместимость и установка

• Minecraft 1.21.1 и NeoForge 21.1.x.
• Требуется строго Create 6.0.10. На других версиях Create мод не загрузится и сообщит о несовпадении зависимости.
• Установите мод и на клиент, и на сервер. Версии должны совпадать.
• Create Big Cannons, Aeronautics и Sable могут использовать Mixin в ContraptionCollider; этот фикс не внедряется в классы аддонов и рассчитан на совместную работу с ними.

Это временный хотфикс именно для Create 6.0.10, а не общее исправление столкновений Create. В Create 6.0.9 этой ошибки нет. Для сборки модов, где откатиться на 6.0.9 нельзя из-за требований аддонов, Create Collision Crashfix помогает сохранить Create 6.0.10 и избежать падения сервера на карьерах и других движущихся конструкциях.

После перехода на Create 6.0.11 удалите этот мод: официальное исправление ожидается в этой версии. Если мир уже падает при загрузке, причиной может быть сохранённая конструкция, которая повторно запускает проблемную проверку столкновения.

Технические сведения

• Версия мода: 1.0.0.
• Категории: оптимизация и утилиты.
• Лицензия: MIT.
• Мод не содержит код Create, только Mixin и метаданные.