Руководство пользователя

Установка Kepler Client, управление профилями, моды Modrinth, резервные копии и шаги по устранению неполадок. Kepler в настоящее время находится на стадии закрытого тестирования и разработки.

Установка и предупреждение SmartScreen

В разработке

Kepler в настоящее время находится на стадии закрытого тестирования, и загрузка пока недоступна. После релиза он работает на Windows, macOS и Linux; требуемая среда выполнения Java выбирается автоматически из манифеста версий Mojang и загружается из официальных источников, поэтому ручная установка Java не требуется.

  • Почему появляется предупреждение SmartScreen: Kepler — это новое приложение, которое еще не подписано цифровым сертификатом подписи кода. Windows Defender SmartScreen может показывать синий экран Система Windows защитила ваш компьютер для новых исполняемых файлов; это не обнаружение вредоносных программ, а лишь уведомление о неизвестном издателе.
  • Пошаговая установка: Нажми на ссылку Подробнее под сообщением в диалоговом окне SmartScreen, затем нажми кнопку Выполнить в любом случае в правом нижнем углу, чтобы продолжить.
  • Проверка SHA-256: Чтобы проверить целостность файла, выполни Get-FileHash .\KeplerClient-Kurulum.exe -Algorithm SHA256 в Windows PowerShell и сравни полученный хеш с официальной контрольной суммой SHA-256, указанной на странице загрузки.

Первый профиль и мастер настройки

В разработке

При первом запуске мастер настройки поможет тебе задать первоначальные параметры. Ты можешь перезапустить мастер в любое время через Настройки > Расширенные > Повторить настройку или быстро перемещаться с помощью палитры команд Ctrl+K.

  • Добавление аккаунта: Открой меню аккаунта в правом верхнем углу, чтобы войти в официальный аккаунт Microsoft/Xbox через PKCE OAuth2 в системном браузере (токены обновления сохраняются в связке ключей твоей ОС), или создай локальный Офлайн-аккаунт длиной 3–16 символов для одиночной игры.
  • Готовый или собственный профиль: Начни с оптимизированного профиля «из коробки» или создай чистый или модифицированный (Fabric, Quilt) экземпляр через Библиотека > + Новый профиль. Сначала поддерживается Minecraft 1.21.x с Fabric; 6 версий от 1.20 до 26.3 находятся на стадии тестирования.
  • Импорт из других лаунчеров: Автоматически сканируй установленные лаунчеры (такие как Prism Launcher или приложение Modrinth) и импортируй существующие профили вместе с их мирами.

Добавление модов (Modrinth)

В разработке

Каталог модов Kepler начинается с Modrinth. Kepler не распространяет готовые модифицированные архивы игры; все моды загружаются напрямую из официальных источников с проверкой SHA-1.

  • Поиск и установка модов: Выбери целевой профиль на экране Обзор и выполни поиск в каталоге Modrinth. Совместимость модов и необходимые зависимости разрешаются автоматически для версии игры твоего профиля.
  • Управление и обновление модов: Во вкладке Моды профиля в разделе Библиотека фильтруй установленные моды по Все, Включенные или Отключенные и нажми Проверить обновления, чтобы узнать о новых релизах.
  • Модпаки .mrpack: Импортируй архивы Modrinth .mrpack и совместимые архивы .zip с защитой от обхода каталогов и фильтрацией разрешенных доменов или экспортируй свой профиль в виде пакета.

Обмен профилями (код KEPLER1)

В разработке

Делись настройками своего профиля без отправки больших файлов архивов с помощью компактного кода обмена KEPLER1:.

  • Структура полезной нагрузки: Префикс KEPLER1:, за которым следует URL-безопасный Base64 JSON; код содержит версию схемы, имя профиля, версию Minecraft, информацию о загрузчике модов (при наличии) и идентификаторы модов Modrinth (project_id, version_id, filename).
  • Конфиденциальность и ограничения валидации: Код обмена никогда не содержит содержимого файлов, локальных путей файловой системы, учетных данных аккаунта или приватных настроек. При импорте проверяется максимальный размер до 64 КБ и до 500 модов.
  • Экспорт настроек: Ты также можешь экспортировать и импортировать конфигурацию лаунчера, темы оформления и списки серверов в виде отдельного JSON-файла.

Режим для слабых ПК

В разработке

Для компьютеров с ограниченным объемом памяти или скромными процессорами Kepler предлагает анализ оборудования и оптимизированные пресеты запуска.

  • Пресет для слабого железа: В настройках профиля в разделе Пресет производительности выбери один из шаблонов флагов JVM: Low hardware (режим для слабых ПК), Balanced или High performance.
  • Автоматическое ОЗУ и калибровка: Рекомендуемый объем выделения heap рассчитывается на основе общего/доступного объема оперативной памяти твоей системы, количества ядер процессора, числа модов и версии Minecraft. Встроенная в лаунчер калибровка за 2‑3 минуты тестирует 3–4 профиля-кандидата и выбирает лучший профиль для твоего оборудования.
  • Облегченный интерфейс: Отключи анимации лаунчера и включи Компактный вид в меню Настройки > Игра.

Скриншоты

В разработке

Внутриигровые скриншоты для каждого профиля хранятся отдельно внутри директории <profile>/screenshots этого экземпляра.

  • Просмотр и предпросмотр: Лаунчер отображает список скриншотов .png для выбранного профиля, отсортированных от новых к старым (до 500 скриншотов на запрос и до 12 МБ на изображение).
  • Удаление и открытие папки: Удаляй ненужные скриншоты прямо из лаунчера или открывай директорию screenshots профиля в стандартном файловом менеджере твоей операционной системы.

Резервные копии

В разработке

Перед добавлением модов или сменой версий защити свои данные во вкладке Резервные копии любого профиля в Библиотеке.

  • Атомарные .zip-бэкапы: Нажми Создать резервную копию, выбери область Только миры или Полный профиль, при желании добавь метку и создай архив .zip в один клик.
  • Безопасное восстановление: Просматривай существующие резервные копии с метаданными о дате и размере, удаляй старые архивы или запускай Восстановить резервную копию — перед восстановлением автоматически создается страховочная копия.

Прямое подключение к серверу (--server)

В разработке

Подключайся к серверам сетевой игры напрямую: либо с экрана Серверы в лаунчере, либо с помощью параметров запуска в командной строке.

  • Список серверов и SLP-пинг: Сохраняй серверы сетевой игры, отслеживай статус сети, количество игроков и пинг (мс) по отдельности или массово с помощью протокола Server List Ping (SLP) и нажимай Подключиться, чтобы войти прямо на сервер.
  • Параметры запуска CLI: Запускай Kepler с параметрами --server <host[:port]>, --port <n> и --profile <id> (или --server=host:port), чтобы подключить выбранный профиль напрямую к нужному серверу.
  • Проверка адреса: Некорректные адреса, содержащие пробелы, а также link-local и metadata (169.254.x.x) адреса отклоняются в целях безопасности.

Отчет о сбое

В разработке

При неожиданном завершении игры диспетчер процессов проверяет код завершения и кольцевой буфер последних строк консоли (stdout/stderr).

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

Устранение неполадок

Распространенные предупреждения и способы их устранения:

  • «Игра уже запущена» (already_running): Активный процесс Minecraft уже выполняется в фоновом режиме. Нажми Остановить на главном экране или подожди завершения процесса перед повторным запуском.
  • Игра вылетает при запуске: Возможно, между двумя модами возник конфликт рендеринга или API. Открой Производительность > Устранение неполадок и отключи подозреваемый мод.
  • Нехватка памяти или подтормаживания: Для профиля может быть выделено слишком мало ОЗУ или более 75% системной памяти. Включи Автоматическое ОЗУ в настройках профиля или запусти калибровочный тест повторно.
  • Неподдерживаемая Java (unsupported_java): Открой Производительность > Java и используй Автоопределение/загрузка Java для выбранной версии Minecraft.
  • Вход через Microsoft не завершается: Если истекло время ожидания аутентификации в браузере, нажми Отмена и начни процесс входа снова.

Ищешь технические определения?

Изучи глоссарий с краткими пояснениями о Fabric, Modrinth, JVM, heap, HUD и SmartScreen или посети нашу страницу FAQ.