Частые ошибки запуска Horizon и их решения

Большинство проблем с запуском Horizon решаются тремя действиями: обновить лаунчер и игру, обновить драйвер видеокарты и, на Windows, переключить графический API на DirectX 12. Остальное — это подготовка файлов Minecraft, Java для подготовки и старый лаунчер, который не может обновиться. Ниже — симптомы и решения по документации проекта.

Быстрая диагностика

Игра не запускается или вылетает сразу

1. Обновите лаунчер и Horizon (лаунчер сам предложит), затем драйвер видеокарты.
2. На Windows откройте Настройки → Настройки графики → Продвинутая графика → Производительность → Графический API и выберите DirectX 12. Режим «Авто» по умолчанию и так берёт DirectX 12, если Vulkan не находит рабочей видеокарты или драйвера, — но при артефактах и вылетах выбрать DirectX 12 вручную всё равно стоит.
3. Если падает после включения шейдера или ресурспака — уберите его из shaderpacks или resourcepacks.

«Не подготовлено» и «Minecraft 26.3 не найден»

Horizon собирает файлы игры из вашей Minecraft 26.3. Самый простой путь — войти в аккаунт Microsoft, которому принадлежит Java Edition, и нажать «Играть»: если Minecraft не установлен, лаунчер скачает 26.3 у Mojang для вашего аккаунта и подготовит его. Если Minecraft у вас в нестандартном месте (например, в Prism или MultiMC), нажмите Выбрать… рядом с «Папка Minecraft» на вкладке «Играть», укажите папку и снова Подготовить.

«Нужна Java 25» (Java 25 is needed)

Java нужна только на время подготовки. Обновите лаунчер: он возьмёт Java, которую официальный лаунчер Minecraft скачал для 26.3, или скачает ту же Java у Mojang. Если интернета нет — поставьте JDK 25 вручную, например Eclipse Temurin 25.

Лаунчер не обновляется

Лаунчер обновляет себя только там, где ему можно писать файлы. Если его запускали из образа диска на macOS, из папки «Загрузки» без переноса в «Программы» или изнутри ZIP на Windows, он видит обновление, но не может его поставить. Лаунчеры 0.2.41 и старше пишут об этом только в «Настройках» рядом с версией. Решение — один раз скачать лаунчер заново с нашей страницы загрузки и установить правильно: на macOS перетащить в «Программы», на Windows распаковать ZIP. Профили, миры и настройки не пострадают.

macOS не открывает приложение

Приложение не подписано платным сертификатом Apple. На macOS 14 и старше: правый клик → «Открыть» → «Открыть». На macOS 15+: запустите один раз, затем «Системные настройки → Конфиденциальность и безопасность» и разрешите. Подробно — в гайде по установке.

Тормозит и дёргается

Уменьшите дальность прорисовки, выключите LOD, выберите пресет «Производительность». Оверлей производительности («Настройки графики» → «Продвинутая графика» → «Оверлей») покажет, что именно медленно. Больше — в статье «Как поднять FPS в Horizon».

Где логи и как сообщить о баге

Когда игра падает, лаунчер это замечает и показывает строку с кнопками Открыть отчёт, Скопировать отчёт, Открыть папку журналов и Сообщить в Discord. Файлы лежат в папке игры (%APPDATA%\horizon, ~/Library/Application Support/horizon, ~/.local/share/horizon):

• logs/latest.log — лог текущего или последнего запуска;
• crash-reports/crash-<дата>-client.txt — отчёт о падении: ошибка, место, железо, настройки рендера, ресурспаки и последние 50 строк лога.

Из командной строки: horizon-launcher logs --crash и horizon-launcher logs --lines 200.

Сообщать — в issues на GitHub (сначала поиск) или в Discord проекта. Укажите, что делали и что ожидали, версию Horizon и лаунчера, систему и видеокарту, приложите отчёт. Лучший баг-репорт по версии самих разработчиков — «в ванилле происходит X, а в Horizon — Y». Если всё началось после свежей Nightly, временно откатитесь — как, описано в статье «Nightly или стабильный».