> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.cl-launcher.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Вирішення проблем (FAQ)

> Лаунчер не запускається через SmartScreen чи антивірус, чорний екран, вильоти гри, де знайти логи вручну та як скинути налаштування CL-Launcher.

Тут зібрані найчастіші проблеми та способи їх вирішення. Якщо вашої проблеми немає в списку, напишіть у [Discord](https://discord.gg/RhyZjACs2U) або створіть [issue на GitHub](https://github.com/WER-CORE/CL-OpenSource/issues).

## Лаунчер не запускається

> **Windows SmartScreen: «Windows захистила ваш ПК»**
>
> SmartScreen часто показує це вікно для нових програм, які ще мало хто завантажував. Це не означає, що файл шкідливий.
>
> 1. Натисніть **Докладніше** (More info).
>
> 2. Перевірте, що видавець і назва файлу відповідають CL-Launcher.
>
> 3. Натисніть **Усе одно запустити** (Run anyway).
>
> > [!WARNING]
> >
> > Завантажуйте лаунчер **лише** з [GitHub Releases](https://github.com/WER-CORE/CL-Win-Edition--Update/releases) або [cl-launcher.app](https://cl-launcher.app/). Файлам з інших сайтів довіряти не варто.

> **Антивірус блокує або видаляє лаунчер**
>
> Деякі антивіруси помилково реагують на лаунчери Minecraft, бо вони завантажують і запускають багато файлів. Код CL-Launcher відкритий і доступний на [GitHub](https://github.com/WER-CORE/CL-OpenSource).
>
> 1. Відновіть файл із карантину антивірусу.
> 2. Додайте папку з лаунчером і папку гри (`%APPDATA%\.ClMinecraft`) у винятки антивірусу.
> 3. Запустіть лаунчер знову.

> **Лаунчер відкривається і одразу закривається**
>
> 1. Переконайтеся, що у вас найновіша версія з [GitHub Releases](https://github.com/WER-CORE/CL-Win-Edition--Update/releases/latest).
> 2. Перевірте, що антивірус нічого не заблокував (дивіться вище).
> 3. Спробуйте [скинути налаштування](#як-скинути-налаштування): пошкоджений файл налаштувань може заважати запуску.

## Проблеми з грою

> **Гра вилітає («Краш гри!»)**
>
> Якщо Minecraft завершився з помилкою, лаунчер покаже вікно **«Краш гри!»** з кодом помилки і сам відкриє логи.
>
> Найчастіші причини:
>
> * **Не та версія Java.** Дивіться [Вимоги та Java](https://wiki.cl-launcher.app/java.md).
> * **Конфлікт модів** або мод для іншої версії Minecraft чи іншого модлоадера.
> * **Замало оперативної пам'яті** для великої збірки.
>
> Що робити:
>
> 1. Подивіться [логи](#де-знайти-логи) і знайдіть рядки з `ERROR` або `Exception`: там зазвичай є назва проблемного мода.
> 2. Приберіть останні додані моди і запустіть гру знову.
> 3. Скористайтеся [аналізом логів за допомогою ШІ](https://wiki.cl-launcher.app/ai.md).

> **Чорний екран після запуску**
>
> 1. Зачекайте 1–2 хвилини: перший запуск великої збірки може довго завантажуватися.
> 2. Оновіть драйвери відеокарти з сайту виробника (NVIDIA, AMD або Intel).
> 3. Вимкніть повноекранний режим у налаштуваннях лаунчера і запустіть гру у вікні.
> 4. Якщо використовуєте шейдери або OptiFine, спробуйте запустити без них.
> 5. Подивіться [логи](#де-знайти-логи): там може бути помилка OpenGL або відеодрайвера.

> **«Помилка встановлення» версії**
>
> Лаунчер не зміг завантажити або встановити версію. Перевірте інтернет-з'єднання, вимкніть VPN або проксі, якщо вони є, і спробуйте ще раз пізніше.

> **«Потрібен інтернет»**
>
> Без інтернету можна запускати лише ті версії, які вже хоча б раз запускалися онлайн. Підключіться до мережі і запустіть версію один раз, щоб лаунчер завантажив усі файли.

## Де знайти логи

Логи можна переглянути прямо в лаунчері (**Налаштування** → **Логи**) або знайти вручну у папці гри.

| ОС | Папка гри |
| - | - |
| Windows | `%APPDATA%\.ClMinecraft` |
| Linux | `~/.clminecraft` |
| macOS | `~/Library/Application Support/CLMinecraft` |

Усередині папки гри:

* `logs/latest.log`: лог останнього запуску гри.
* `crash-reports/`: звіти про краші Minecraft (з'являються, якщо гра впала з критичною помилкою).

> [!TIP]
>
> На Windows швидко відкрити папку можна так: натисніть `Win + R`, вставте `%APPDATA%\.ClMinecraft` і натисніть **Enter**.

Якщо звертаєтеся по допомогу в [Discord](https://discord.gg/RhyZjACs2U), прикріпіть файл `latest.log` повністю, а не скріншот.

## Як скинути налаштування

Налаштування лаунчера зберігаються у файлі `Data/UserSaves.json` у **папці, куди встановлено лаунчер** (поруч із файлом запуску CL-Launcher).

**1. Закрийте лаунчер**

Переконайтеся, що CL-Launcher повністю закритий.

**2. Видаліть файл налаштувань**

Відкрийте папку з лаунчером, перейдіть у `Data` і видаліть (або перейменуйте) файл `UserSaves.json`.

**3. Запустіть лаунчер знову**

Лаунчер створить налаштування за замовчуванням.

> [!NOTE]
>
> Скидання налаштувань не видаляє світи, моди та збірки: вони лежать у папці гри. Проте тема, кольори, шлях до гри, обсяг RAM та інші параметри повернуться до стандартних. Перед будь-якими експериментами варто зробити [резервну копію світів](https://wiki.cl-launcher.app/backups.md).

## Дивіться також

> **[Вимоги та Java](https://wiki.cl-launcher.app/java.md)**
>
> Яка Java потрібна і скільки RAM виділяти

> **[Аналіз логів (AI)](https://wiki.cl-launcher.app/ai.md)**
>
> Автоматичний розбір помилок


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