Диагностический отчет (.zip) и конфиденциальность
ЦЕНТР ДИАГНОСТИКИ И СБОЕВ
Ищете решение частых сбоев или расшифровку кодов ошибок?
- Устранение неполадок при запуске и сбоях - ошибки среды Java, распределение памяти, драйверы и конфликты модов.
- Журналы сбоев и коды выхода - пути к логам (
latest.log,crash-reports), коды 0xC0000005, 1, 137 и разбор стектрейса.
При решении сложных проблем с лаунчером, ошибок прямого соединения P2P или зависаний загрузки зависимостей разработчики или участники сообщества могут попросить вас предоставить Диагностический отчет XMCL (Diagnostic Report).
В этом руководстве описано, как сгенерировать такой отчет, какие технические сведения он включает, и как архитектура XMCL гарантирует сохранность ваших персональных данных и аккаунтов.
1. Как сгенерировать диагностический отчет
Отчет можно экспортировать прямо из интерфейса XMCL:
- Откройте Настройки (значок шестеренки в нижнем левом углу).
- Перейдите во вкладку Хранилище или Диагностика.
- Нажмите Экспортировать диагностический отчет (или комбинацию
Ctrl+Shift+D/Cmd+Shift+Dв актуальных версиях). - XMCL сформирует единый архив
.zipна вашем рабочем столе или в указанной папке (например,xmcl-diagnostic-2026-10-26.zip).
Если лаунчер не открывается вовсе, логи можно скопировать вручную из системной папки:
- Windows:
%APPDATA%\xmcl\logs\ - macOS:
~/Library/Application Support/xmcl/logs/ - Linux:
~/.config/xmcl/logs/
2. Что содержится в отчете?
Архив .zip является открытым и незашифрованным — вы можете распаковать его и просмотреть каждый файл перед передачей:
| Файл / Каталог | Содержимое и назначение |
|---|---|
main.log | Журнал основного процесса Electron/DeskGap: запуск, файловый ввод-вывод, IPC-сообщения, проверка обновлений. |
renderer.log | Журнал графического интерфейса: жизненный цикл Vue 3, ошибки фронтенда, переходы между разделами. |
device.json | Сведения о системе: версия ОС, номер сборки ядра, общий объем оперативной памяти (RAM), архитектура CPU (x64, arm64), модель GPU. |
java.json | Обнаруженные в системе среды Java: версии, пути, мажорные версии, вендор (Adoptium, Oracle, Zulu). |
instance.json (очищенный) | Конфигурация активного инстанса: версия Minecraft, загрузчик (Fabric, Forge, NeoForge, Quilt), выделенная память (-Xmx), аргументы JVM. |
network.log | Запросы на скачивание файлов, зеркала CDN, STUN/TURN рукопожатия для комнат P2P. |
3. Строгая конфиденциальность: что НИКОГДА не собирается
XMCL придерживается принципов локального хранения и прозрачности открытого исходного кода. В диагностический отчет категорически не попадают:
- Токены авторизации Microsoft / Xbox: токены сессий (
Access Token,Refresh Token) сохраняются исключительно в системных хранилищах учетных данных ОС (Windows DPAPI, macOS Keychain, Linux Secret Service) и никогда не пишутся в логи. - Пароли сторонних / оффлайн учетных записей: пароли и секретные ключи серверов не сохраняются в текстовом виде.
- Системные пути и имена пользователей: пути к файлам, содержащие имя вашей учетной записи (например,
C:\Users\Имя\), автоматически заменяются на<USER_HOME>или анонимные заглушки. - Миры, сохранения и переписка: игровые сохранения, инвентарь, IP-адреса из
servers.datи переписка из чата полностью исключены из отчета.
4. Проверка перед передачей
Перед отправкой архива в открытые источники:
- Распакуйте и просмотрите: откройте
.zipлюбым архиватором (7-Zip, WinRAR и др.). - Проверьте текстовые файлы: при желании откройте
main.logилиrenderer.logв текстовом редакторе и убедитесь в отсутствии специфических локальных сетевых имен. - Удалите лишнее: если вопрос касается только лаунчера, логи самой игры из архива можно удалить.
5. Куда безопасно отправить диагностический отчет
После проверки вы можете прикрепить отчет к обращению в официальных сообществах:
- GitHub Issues: прикрепите
.zipк вашему тикету в репозитории voxelum/x-minecraft-launcher/issues. - Официальный Discord: передайте файл в каналах
#supportили#troubleshootingна сервере XMCL Discord. - Reddit: загружайте выдержки через mclo.gs и оставляйте вопросы в сабреддите r/xmcl.
СОВЕТ
Никогда не выкладывайте полные логи на публичные сервисы хранения текста. Для Discord и GitHub всегда используйте mclo.gs, который надежно маскирует приватные пути и случайные сетевые адреса.