Crash Assistant отображает графический интерфейс после сбоя Minecraft, сразу показывая и анализируя все логи, отчёты о сбоях и файлы hs_err.
После аварийного завершения игры мод отображает все затронутые игровые и лаунчерные логи, отчёты о сбоях и ошибки JVM. Предоставляется возможность одним кликом загрузить эти файлы, скопировать ссылку и выполнить дополнительные действия для удобного отчёта и устранения неполадок. Инструмент анализирует логи на предмет множества известных причин сбоев и предлагает подробные решения. Кроме того, он предупреждает, если Minecraft запущен на интегрированной видеокарте, хотя доступна дискретная, и включает автоисправления для часто встречающихся проблем.
Мод работает только на клиенте и не оказывает влияния на сервер.
Графический интерфейс
Поддерживается перетаскивание файлов (drag&drop). Логи можно перемещать из интерфейса в нужные папки или перетаскивать все сразу с метки «Available log files».
Анализ логов
Crash Assistant выявляет известные причины сбоев и отображает окно с описанием проблемы и подробным решением.
Поддерживаемый анализ:
- hs_err (сбои JVM): обнаружение проблем с драйверами AMD (
atio6axx.dll), Nvidia (nvoglv64.dll), Intel (ig7icd64.dll), общих ошибок GPU (glfw.dll), нехватки оперативной памяти, ошибок Java версии, а также ошибок с библиотеками на Linux и macOS и других распространённых проблем. - Логи и отчёты о сбоях: выявление несовместимых модов (например, Fabric-модов с Sinytra Connector), конфигурационных ошибок, нехватки дискового пространства, конфликтов модов, проблем с Forge/NeoForge, ошибок загрузки datapack, проблем с OptiFine, устаревших модов и других распространённых ошибок.
- Журналы событий Windows: обнаружение завершения игры системой из-за зависания.
Интеграция с Codex Logs Analyzer
После загрузки каждый поддерживаемый лог анализируется сервисом mclo.gs. При сложных сообщениях мод показывает подробное описание ошибки и рекомендации по устранению, например, указывает проблемный блок или сущность.
Инструменты анализа
- Проверка совместимости дополнений для Create и Epic Fight;
- Обнаружение модов, созданных с помощью MCreator;
- Поиск Java-классов или пакетов по модам;
- Анализ зависимостей классов для отладки ошибок
NoClassDefFoundError.
Определение использования интегрированной видеокарты
Мод проверяет, запущена ли игра на интегрированной видеокарте, если доступна дискретная, и предупреждает об этом. В интерфейсе есть кнопка автоисправления, которая настраивает Windows на использование правильного GPU для Java.
Предупреждение о критической ошибке процессоров Intel 13-го и 14-го поколения
Определяется модель CPU и версия микрокода, при обнаружении известных проблем выводится подробное предупреждение с рекомендациями.
Совместимость и стабильность
Crash Assistant запускается как отдельный процесс, ожидающий завершения JVM Minecraft. Загружается очень рано как Coremod (Forge) или LanguageAdapter (Fabric/Quilt), что позволяет фиксировать сбои на начальной стадии загрузки.
Сохранение списка модов
Мод автоматически сохраняет список модов при запуске игры в модпаках, а также позволяет сохранить список вручную командой /crash_assistant modlist save. Для модпаков отображается список изменений относительно официального набора, для индивидуальных сборок — изменения с последнего успешного запуска.
Локализация
Поддерживаются английский, немецкий, русский, китайский, испанский и итальянский языки. Все видимые строки можно изменять.
Команды для моделирования сбоев
/crash_assistant crash game— аварийное завершение Minecraft с crash-отчётом;/crash_assistant crash jvm— аварийное завершение JVM с созданием hs_err файла;/crash_assistant crash no_crash— применение дополнительных параметров без аварии.
Дополнительные параметры:
--withThreadDump — создание дампа потоков;
--withHeapDump — создание дампа памяти;
--GCBeforeHeapDump — запуск сборщика мусора перед дампом памяти.
Конфиг для проблемных модов
Файл problematic_mods_config.json позволяет отмечать несовместимые моды. В режиме аварии игра прервётся при обнаружении таких модов, в режиме уведомления — игроку покажут сообщение с объяснением и предложением удалить мод.
