> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xneon.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Решение проблем с Xneon Launcher: диагностика и быстрые правки

> Если Minecraft не запускается, сервер не стартует или друг не может подключиться, найдите решение в этом справочнике. Включает AI-диагностику, настройку Java и инструкции по сбросу.

Если что-то пошло не так, начните с AI-анализа лога или проверьте распространённые причины ниже. Если ответа нет, обратитесь в сообщество.

<CardGroup>
  <Card title="Discord" icon="brand-discord" href="https://discord.gg/a9mDjtqcbQ">
    Задавайте вопросы и получайте помощь от команды и сообщества.
  </Card>

  <Card title="Telegram" icon="brand-telegram" href="https://t.me/xneon_launcher">
    Новости, обсуждения и оперативная поддержка.
  </Card>

  <Card title="GitHub Issues" icon="brand-github" href="https://github.com/XneonTeam/Xneon-Launcher/issues">
    Сообщайте о багах и предлагайте улучшения.
  </Card>
</CardGroup>

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

<Accordion title="Проверьте лог и запустите AI-анализ">
  Перейдите на вкладку **Логи** и найдите последнюю сессию. Нажмите **AI-анализ**. Xneon отправит лог в выбранную LLM (OpenAI, Claude, DeepSeek или локальную модель) и вернёт причину краша с рекомендациями на языке интерфейса. Ответ приходит в потоковом режиме с форматированием Markdown.
</Accordion>

<Accordion title="Проверьте Java">
  Убедитесь, что для версии Minecraft выбрана правильная Java:

  | Версия Minecraft | Рекомендуемая Java |
  | - | - |
  | 1.16.5 и ниже | Java 8 |
  | 1.17 - 1.20.4 | Java 17 |
  | 1.20.5 и выше | Java 21 |

  В разделе **Параметры запуска** включите **Автоподбор Java**. Лаунчер скачает нужную версию автоматически. Если Java установлена вручную, проверьте путь к исполняемому файлу.
</Accordion>

<Accordion title="Отключите моды и ресурспаки">
  Войдите в настройки сборки и отключите все моды, затем попробуйте запустить игру. Если запускается, включайте моды группами, чтобы найти конфликтный. Аналогично проверьте ресурспаки и шейдеры.
</Accordion>

<Accordion title="Проверьте аргументы JVM">
  Слишком агрессивные аргументы JVM или неподдержимый GC могут вызывать сбой. Временно сбросьте аргументы до стандартных, убрав кастомные флаги.
</Accordion>

## Не хватает памяти

<Accordion title="Увеличьте лимит памяти">
  В **Параметрах запуска** передвиньте слайдер памяти. Оптимальные значения:

  * Vanilla / лёгкие модпаки: 2-4 ГБ
  * Средние сборки (50-100 модов): 4-6 ГБ
  * Тяжёлые модпаки: 8 ГБ и более

  Слайдер автоматически привязывает `-Xms` и `-Xmx`. Не выставляйте больше, чем половина физической RAM.
</Accordion>

<Accordion title="Закройте лишние программы">
  Браузеры с множеством вкладок, стримы и другие тяжёлые приложения могут занимать гигабайты RAM. Освободите память перед запуском Minecraft.
</Accordion>

## Конфликт модов

<Accordion title="Проверьте совместимость загрузчика">
  Убедитесь, что все моды предназначены для одного загрузчика (Fabric, Forge, NeoForge и т.д.) и версии Minecraft. Xneon автоматически проверяет требования модов к версии загрузчика при установке.
</Accordion>

<Accordion title="Обновите или откатите конфликтующий мод">
  Если краш указывает на конкретный мод, попробуйте обновить его до последней версии или временно удалить. Используйте вкладку **Моды и контент** для быстрого обновления.
</Accordion>

<Accordion title="Проверьте зависимости">
  Некоторые моды требуют библиотеки (например, Fabric API). Xneon подсвечивает отсутствующие зависимости и предлагает установить их одним кликом.
</Accordion>

## Сервер не стартует

<Accordion title="Примите EULA">
  При первом запуске сервера требуется согласие с Minecraft EULA. В настройках сервера найдите переключатель **EULA** и включите его. Без этого сервер завершится сразу после старта.
</Accordion>

<Accordion title="Дождитесь завершения компиляции Spigot/CraftBukkit">
  Для ядер Spigot и CraftBukkit при первом запуске выполняется компиляция через BuildTools. Процесс виден в консоли сервера и может занять несколько минут.
</Accordion>

<Accordion title="Проверьте порт">
  Убедитесь, что порт сервера (по умолчанию 25565) не занят другим процессом. Измените `server.properties` → `server-port`, если нужно.
</Accordion>

<Accordion title="Проверьте Java для сервера">
  Как и для клиента, сервер требует определённую версию Java. Xneon автоматически подбирает Java при создании сервера, но если вы указали путь вручную, убедитесь в его корректности.
</Accordion>

## Друг не подключается через XN Connect

<Accordion title="Проверьте статус XN Connect">
  На странице сервера убедитесь, что **XN Connect** включён и туннель активен. Лимит использования трафика отображается в интерфейсе. Проверьте, не исчерпан ли он.
</Accordion>

<Accordion title="Проверьте firewall и антивирус">
  Брандмауэр или антивирус может блокировать подключение XN Connect. Временно отключите их для проверки или добавьте Xneon Launcher в исключения.
</Accordion>

<Accordion title="Убедитесь, что сервер запущен">
  XN Connect предоставляет внешний адрес, но сам сервер должен быть в состоянии **Running**. Проверьте консоль сервера на наличие ошибок.
</Accordion>

## Ошибка при установке на macOS или Linux

<Accordion title="macOS: приложение повреждено или не открывается">
  Если macOS блокирует запуск из-за неподписанного приложения, откройте **Системные настройки → Конфиденциальность и безопасность** и нажмите **Всё равно открыть**. Альтернативно выполните в терминале:

  ```bash theme={null}
  xattr -cr /Applications/Xneon\ Launcher.app
  ```
</Accordion>

<Accordion title="Linux: зависимости пакета">
  При установке `.deb` или `.rpm` убедитесь, что установлены зависимости:

  ```bash theme={null}
  # Debian / Ubuntu
  sudo apt install libnotify4 libsecret-1-0 libappindicator3-1 libxss1

  # Fedora / openSUSE
  sudo dnf install libnotify libsecret libappindicator-gtk3 libXScrnSaver
  ```

  Для AppImage никаких зависимостей не требуется.
</Accordion>

<Accordion title="Linux: отсутствующие библиотеки Electron">
  Если лаунчер не стартует с ошибкой `libuuid.so` или подобной, установите пакет `libuuid` через менеджер пакетов вашего дистрибутива.
</Accordion>

## Сброс лаунчера через папку данных

Если лаунчер ведёт себя непредсказуемо и другие способы не помогли, выполните полный сброс. Это удалит все настройки, аккаунты, сборки и серверы. Заранее сделайте резервную копию.

<Steps>
  <Step title="Закройте Xneon Launcher">
    Убедитесь, что лаунчер полностью закрыт (включая из трея на Windows).
  </Step>

  <Step title="Откройте папку данных">
    Найдите папку по пути для вашей системы:

    * Windows: `%APPDATA%\xneonlauncher`
    * macOS: `~/Library/Application Support/xneonlauncher`
    * Linux: `~/.xneonlauncher`
  </Step>

  <Step title="Переименуйте или удалите папку">
    Переименуйте `xneonlauncher` в `xneonlauncher.backup` или полностью удалите её.
  </Step>

  <Step title="Запустите лаунчер">
    При следующем запуске Xneon создаст папку данных заново. Вам потребуется заново войти в аккаунт и создать сборки.
  </Step>
</Steps>

<Tip>
  Если вы хотите сохранить сборки, скопируйте папку `intents/` перед сбросом, а затем импортируйте сборки обратно через **Импорт → Сборка Xneon (.zip)**.
</Tip>

## Частые ошибки в двух словах

| Симптом | Вероятная причина | Быстрое решение |
| - | - | - |
| Чёрный экран после запуска | Нехватка памяти или конфликт шейдеров | Увеличьте RAM, отключите шейдеры |
| «Java not found» | Неверный путь к Java | Включите автоподбор Java |
| Сервер зависает на «Starting ...» | Длительная генерация мира или BuildTools | Подождите 3-5 минут |
| «Out of memory» при запуске | -Xmx слишком высокий или другие программы жрут RAM | Снизьте лимит, закройте браузер |
| Не видно сервер в списке друзей | XN Connect выключен или туннель неактивен | Проверьте статус XN Connect в настройках сервера |

<Note>
  Если ни одно из решений не помогло, приложите лог запуска и скриншот ошибки при обращении в [Discord](https://discord.gg/a9mDjtqcbQ) или [GitHub Issues](https://github.com/XneonTeam/Xneon-Launcher/issues).
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.