Руководство по устранению неполадок

Решения распространенных проблем с запуском, исключения Windows Defender, настройка среды выполнения Java, сбои GPU и отправка отчетов о сбоях в Kepler Client.

1. Игра не запускается

Если нажатие кнопки «Играть» не приводит к ответу или окно игры сразу закрывается, проверь следующие шаги:

  • Проверка фоновых процессов: Если в фоновом режиме уже выполняется активный процесс Minecraft (already_running), новый экземпляр не запустится. Нажми Stop на главном экране лаунчера или заверши зависший процесс через Диспетчер задач Windows.
  • Выделение памяти (ОЗУ): Выделение слишком малого объема ОЗУ (менее 2 ГБ) или более 75% от общего объема оперативной памяти твоей системы может помешать запуску виртуальной машины Java. Включи Автоматическое ОЗУ в настройках профиля или настрой ползунок на рекомендуемый объем.
  • Конфликты модов: Если недавно добавленные моды имеют конфликтующие API или версии, процесс запуска может зависнуть. Открой Производительность > Устранение неполадок, чтобы отключить подозреваемые моды, и попробуй снова.
2. Предупреждение Windows SmartScreen и Defender

Если Windows SmartScreen или Windows Defender отображает предупреждение при запуске Kepler, следуй этим инструкциям:

  • Почему появляется предупреждение: Kepler Client — это проект в активной разработке, и ранние релизы еще не подписаны коммерческим цифровым сертификатом подписи кода (не подписаны). Синий экран Система Windows защитила ваш компьютер, отображаемый Windows Defender SmartScreen, не означает, что приложение вредоносно; он лишь указывает на то, что исполняемый файл еще не завоевал широкую репутацию.
  • Шаги для обхода SmartScreen: Нажми на ссылку Подробнее прямо под текстом предупреждения. Затем нажми кнопку Выполнить в любом случае, которая появится в правом нижнем углу, чтобы запустить лаунчер.
  • Добавление исключения Windows Defender для папки Kepler: Чтобы защита в режиме реального времени ошибочно не блокировала файлы лаунчера, ты можешь добавить исключение:
    1. Открой Безопасность Windows в меню «Пуск».
    2. Выбери Защита от вирусов & угроз.
    3. В разделе Параметры защиты от вирусов & угроз нажми Управление настройками.
    4. Прокрути вниз до раздела Исключения и нажми Добавление или удаление исключений.
    5. Нажми Добавить исключение, выбери Папка и укажи каталог установки Kepler.
3. Проблемы с Java

Kepler Client автоматически управляет средами выполнения Java и при обычных условиях не требует ручной настройки.

  • Автоматическое управление Java: Kepler автоматически определяет точную версию Java, необходимую для версии Minecraft твоего профиля, используя официальный манифест версий Mojang, и загружает ее напрямую из официальных источников. Тебе не нужно устанавливать Java вручную.
  • Что делать, если загрузка не удалась: Временные сбои сети или правила брандмауэра могут прервать загрузку.
    1. Проверь интернет-соединение и убедись, что твое защитное ПО не блокирует официальные эндпоинты Mojang.
    2. Открой Производительность > Java в лаунчере и нажми Автоопределение/загрузка Java, чтобы перезапустить процесс.
    3. Если у тебя уже установлена подходящая среда выполнения Java локально (Java 21 для Minecraft 1.20.5+ и 1.21.x или Java 17 для 1.18–1.20.4), ты можешь вручную выбрать исполняемый файл Java (javaw.exe) в настройках профиля.
4. Сбои графики и драйверов

Ошибки OpenGL, тайм-ауты драйвера или пустые окна при запуске обычно можно устранить с помощью следующих шагов:

  • Обновление графических драйверов: Подавляющее большинство сбоев на этапе рендеринга вызвано устаревшими драйверами видеокарты. Загрузи и установи последнюю стабильную версию драйвера напрямую с официальных сайтов поддержки NVIDIA, AMD или Intel.
  • Тестирование без шейдеров: Шейдерпаки потребляют много ресурсов видеокарты и могут иметь проблемы совместимости с определенными версиями драйверов. Если игра вылетает при входе в мир, отключи шейдеры в настройках графики и протестируй со стандартным рендерингом.
  • Ноутбуки с двумя видеокартами: Windows может по умолчанию использовать встроенную графику процессора (iGPU). Открой параметры графики Windows и убедись, что Kepler и javaw.exe явно назначены на твою высокопроизводительную дискретную видеокарту.
5. Мод не отображается в игре

Если добавленный тобой файл мода не отображается в Minecraft или в меню модов, проверь следующие критерии совместимости:

  • Требование к загрузчику Fabric: Kepler Client работает на загрузчике модов Fabric. Убедись, что загруженный тобой мод скомпилирован для Fabric; моды только для Forge или NeoForge не загрузятся в среде Fabric.
  • Соответствие версии Minecraft: Файл мода должен строго соответствовать версии Minecraft твоего профиля (например, мод, разработанный для 1.21.x, не загрузится в профиле 1.20.x). Поиск через встроенный в лаунчер браузер Modrinth автоматически обеспечивает совместимость версий.
  • Сопутствующие зависимости: Многим модам Fabric для загрузки требуются вспомогательные библиотеки, такие как Fabric API. Ознакомься с документацией мода, чтобы убедиться, что все необходимые сопутствующие библиотеки включены в твоем профиле.
6. Как отправить отчет о сбое

Если ты столкнулся с неустранимым сбоем, ты можешь просмотреть диагностические логи и отправить отчет:

  • Просмотр отчета о сбое в лаунчере: При неожиданном завершении игры диспетчер процессов фиксирует код выхода и логи stdout/stderr. Перейди в раздел Производительность > Устранение неполадок, чтобы увидеть первопричину и обнаруженные конфликты модов.
  • Маскирование личных данных: Нажатие Скопировать отчет или Поделиться логом автоматически удаляет из текста твое системное имя пользователя и личные пути к файлам.
  • Обращение в поддержку: Скопируй очищенный отчет и посети нашу страницу поддержки, чтобы связаться с нами или отправить отзыв.

Ищешь другие темы?

Ознакомься с подробным Руководством пользователя, чтобы узнать о шагах настройки, или прочитай наши Принципы честной игры касательно правил многопользовательских серверов.