Показывает графический интерфейс после сбоя Minecraft, немедленно отображая все затронутые логи игры/лаунчера, отчеты о сбоях или файлы hs_err. Предоставляет решение в один клик для их загрузки, копирования ссылки и выполнения других действий для упрощения отчетности, отладки и устранения неполадок. Анализирует логи на множество известных причин сбоев. Предоставляет множество полезных инструментов анализа. Предупреждает, если Minecraft запущен на интегрированном GPU, когда доступен дискретный. Включает автоматические исправления для многих распространенных проблем.
Мод работает только на стороне клиента. На сервере он ничего не делает.
Функции:
Графический интерфейс:
Поддерживает перетаскивание. Вы можете перемещать файлы непосредственно из графического интерфейса куда угодно или перетащить все логи, перетаскивая их из метки «Доступные файлы логов:».
Анализ логов:
Анализирует логи на множество известных причин сбоев. Если обнаружена известная проблема, отображается диалоговое окно с описанием проблемы и подробным решением.
Поддерживаемый анализ:
hs_err (Сбой JVM):
AlLibAlcCleanup(Проклятая проблема, связанная с выделением оперативной памяти)atio6axx.dll(Проблема с драйвером AMD)glfw.dll(Общая проблема драйвера GPU)ig7icd64.dll(Проблема со старым драйвером интегрированного GPU Intel)InsufficientMemory(В системе закончилась оперативная память или файл подкачки)JavaTooHigh(Например, мод Spark crashing на Java ≥ 22)jemalloc.dll(Проблема с аллокатором памяти jemalloc)jvm.dll(Возможная проблема с оборудованием или ошибка в самой JVM)libglfw.so/libopenal.so(Распространенные проблемы с библиотеками в Linux)libGLProgrammability.dylib(Несовместимый набор шейдеров на macOS)~StubRoutines::SafeFetch32(macOS на Apple Silicon с некорректным JDK)nglMultiDrawElementsBaseVertex/0x0000(Проблема с драйвером GPU)nvoglv64.dll(Проблема с драйвером Nvidia)
log / crash-report:
ConnectorIncompatibleFabricMods(Обнаруживает несовместимые моды Fabric, такие как Sodium/Iris, при использовании Sinytra Connector)Create6Addons(Несовместимость между версиями Create и его аддонами)CtovWithoutLithostitched(Мод ChoiceTheorem's Overhauled Village отсутствует обязательная зависимость)CurseForgeCorrupted(Поврежденная установка Minecraft/Loader из лаунчера CurseForge)DiskSpaceEnded(В системе закончилось место на диске)DuplicatedMods(Установлены несколько версий одного и того же мода)EpicFightAddons(Несовместимость между версиями Epic Fight и его аддонами)FeatureOrderCycle(Циклическая зависимость в функциях генерации мира)FerriteCoreNeighborTable(Обнаруживает, когда мод неправильно обращается к таблице соседей FerriteCore, предоставляет временное обходное решение через конфигурацию)GeckoLibOculusCompat(Предупреждает, что мод GeckoLib Oculus Compat больше не нужен на Minecraft 1.20.1+ и вызывает сбои)GroovyModLoaderIPv6(GML не удалось загрузить маппинги из-за проблем с IPv6, включает Авто-Исправление для поиска модов, зависящих от GML)KubeJSDataPack(Ошибка при загрузке датапака с KubeJS)LanguageProviderMismatch(Моду требуется другая версия Forge/NeoForge)LegacyTooManyIds(Превышен лимит ID блоков/предметов в старых версиях Minecraft, таких как 1.12.2)MixinApply(Обнаруживает широкий спектр сбоев, вызванных конфликтами или ошибками Mixin, включает обнаружение отсутствующих классов и Авто-Исправление для поиска модов, зависящих от отсутствующего класса)MissingEmbeddiumForOculus(Мод Oculus установлен без своей обязательной зависимости, Embeddium)MissingIndium(Моду требуется Indium для совместимости с Fabric Renderer API, но он не установлен)MissingUnsupportedDependencies(Общие конфликты зависимостей, обнаруженные Forge/NeoForge)ModernFixWatchDog(Встроенный сервер заблокирован)NeoForgeVersion1_20_1(Уведомляет, что Neo на 1.20.1 заброшен и вызывает множество сбоев, и переход на Forge является официальной рекомендацией от Neo для этой версии.)ModuleFind/ModuleResolution(Ошибки системы модулей Java, часто из-за конфликтов зависимостей, немедленно идентифицирует, какой мод вызывает проблему; без нашего мода для поиска этого требовался бинарный поиск)Optifine(Предупреждает, что OptiFine известен множеством проблем совместимости и предлагает современные альтернативы)OutOfMemoryError(В Minecraft закончилась выделенная оперативная память)ResourceLocationException(Имя ресурса содержит недопустимые символы, часто из-за системных настроек не на английском языке)Rubidium(Предупреждает, что Rubidium заброшен и вызывает проблемы, предлагает Embeddium)ServerConfigCorrupted(Файл конфигурации на стороне сервера поврежден)UnsupportedClassVersion(Мод был скомпилирован с более новой версией Java, чем используемая)UsedByAnotherProcess(Файл заблокирован другой программой)Version1_21(Предупреждает, что Minecraft 1.21 устарел и вызывает множество проблем; предлагает перейти на 1.21.1)
win_event (Журнал событий Windows):
WasClosedByWindows(Игра зависла и была завершена операционной системой, часто из-за пользовательского ввода во время загрузки)
Интеграция с анализатором логов Codex:
- После загрузки каждый поддерживаемый лог анализируется анализатором логов Codex от
mclo.gs. Иногда сообщения Codex могут быть непонятны обычным пользователям. В таких случаях отображается подробное сообщение с руководством по исправлению:- Вызывающий ошибку блок/сущность
Это значительно снижает нагрузку на поддержку модпаков, так как большая часть (более 75%) проблем — это распространенные и легко решаемые вопросы. Вы можете добавить любой анализ в черный список в конфигурации, если пожелаете.
Инструменты анализа
Crash Assistant включает набор мощных инструментов анализа, доступных из меню графического интерфейса:
- Совместимость аддонов Create/Epic Fight: Сканирует ваши моды для поиска аддонов, несовместимых с установленной версией Create или Epic Fight.
- Детектор модов MCreator: Перечисляет все моды, созданные с помощью инструмента MCreator.
- Поиск пакетов/классов: Ищет во всех модах, чтобы найти, какой из них содержит определенный класс или пакет Java.
- Анализ зависимостей Jdeps: Определяет, какие моды зависят от определенного класса или пакета, помогая в отладке сбоев
NoClassDefFoundError.
Обнаружение интегрированного GPU:
Проверяет, запущена ли игра на интегрированном GPU, когда доступен более мощный дискретный GPU, и отображает предупреждение. Включает кнопку Авто-Исправление в один клик для настройки Windows на использование правильного GPU для Java.
Предупреждение об ошибке чипов Intel:
Обнаруживает, относится ли ваш CPU к моделям Intel 13-го/14-го поколения, известным критической ошибкой стабильности. Он проверяет вашу версию микрокода и предоставляет подробное предупреждение и рекомендации.
Совместимость:
Мод разработан для максимальной совместимости и стабильности. Он запускается в независимом процессе, который ожидает остановки JVM Minecraft. Он загружается очень рано как Coremod (Forge) или LanguageAdapter (Fabric/Quilt), что позволяет ему перехватывать даже сбои на раннем этапе запуска.
Загрузка всех логов и копирование ссылки в один клик:
Вы можете загрузить все доступные логи одним кликом и получить аккуратно отформатированное сообщение, готовое для вставки на GitHub или Discord. Если вы создатель модпака, вы всегда будете знать, что все логи актуальны и содержат всю доступную информацию без необходимости запрашивать дополнительные файлы.
Кнопка для присоединения к предварительно настроенной ссылке:
Игроки вашего модпака могут легко, одним кликом, найти ваш Discord и запросить помощь сразу после сбоя. Это в сочетании с исключительной простотой загрузки логов значительно увеличивает вероятность отчетности об отдельных сбоях. Для отдельных загрузок или если ссылка не настроена, пользователи будут перенаправлены в соответствующий Discord сервер загрузчика модов.
Список модов:
Сохраняет список модов модпака каждый раз при запуске игры создателем модпака. Вы также можете вручную сохранить список модов с помощью команды /crash_assistant modlist save. Это работает по-разному для модпаков и отдельных загрузок:
Модпаки:
Сгенерированное сообщение включает список модов, которые конечный пользователь добавил, удалил или обновил по сравнению с официальным списком модпака.
Отдельные загрузки / авторы модпаков:
Отслеживает изменения в списке модов с момента последнего успешного запуска, что может быть чрезвычайно полезно, если вы нажали кнопку «обновить все» или добавили проблемные моды и забыли, какие именно.
Конфигурация:
Полностью настраиваема: вы можете включить или отключить любую функцию, изменить ссылку на Discord и настроить текст меток, кнопок и многое другое.
Локализация:
Полностью локализована. В настоящее время поддерживаемые языки:
- Английский
- Немецкий
- Русский
- Китайский
- Испанский
- Итальянский
Отсутствуют жестко закодированные строки (за исключением логирования). Вы можете изменить каждую видимую строку. Для получения дополнительной информации о локализации или если вы хотите добавить новый язык, прочитайте README языков.
Команды сбоя:
/crash_assistant crash имеет 3 варианта:
game- вызывает сбой Minecraft с отчетом о сбое.jvm- вызывает сбой JVM с файлом hs_err_pid.no_crash- применяет дополнительные аргументы без сбоя.
После цели сбоя вы можете использовать дополнительные аргументы:
--withThreadDump- генерирует дамп потоков в логе.--withHeapDump- генерирует файл дампа кучи.--GCBeforeHeapDump- выполняет сборку мусора перед дампом кучи.
Конфигурация проблемных модов:
Добавляет файл конфигурации problematic_mods_config.json, который позволяет вам помечать моды как несовместимые с вашим модпаком. Он имеет два режима: может вызывать сбой игры при обнаружении несовместимого мода или просто уведомлять пользователя. Конечный пользователь, добавивший мод, будет уведомлен предварительно настроенным сообщением, объясняющим, почему он несовместим, и ему будет предложена кнопка для его удаления.
Конфиденциальность
Логи загружаются только тогда, когда пользователь явно нажимает кнопку «Загрузить», и они отправляются непосредственно на mclo.gs, сервис обмена логами, управляемый Aternos.
Перед публикацией mclo.gs автоматически редактирует конфиденциальные данные— такие как токены доступа, IP-адреса, системные имена пользователей и т.д. — чтобы вставка была безопасной для обмена.
Полная информация о сроках хранения, о том, кто имеет доступ к логам, и о ваших правах по GDPR доступна в их политике конфиденциальности.
Поскольку мобильный интерфейс mclo.gs может быть неудобным, Crash Assistant по умолчанию оборачивает возвращаемый URL через gnomebot.dev (например, https://mclo.gs/X → https://gnomebot.dev/paste/mclogs/X). Вы можете отключить это поведение в настройках. gnomebot.dev — это открытый просмотрщик логов онлайн, созданный Latvian Modder; он получает данные от mclo.gs и отображает их пользователю с удобным форматированием, кэширует вставку в оперативной памяти в течение пяти минут после последнего доступа, а затем удаляет ее.
Сам Crash Assistant является полностью клиентским — у него нет серверов, и он никогда не получает копию ваших логов.
Это краткое описание конфиденциальности. Полная политика конфиденциальности находится в меню Конфиденциальности внутри Crash Assistant. Crash Assistant предложит вам прочитать и принять нашу политику конфиденциальности при первой попытке загрузки лога.
