> ## 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.

# Вимоги та Java

> Яка Java потрібна для різних версій Minecraft, скільки виділяти оперативної пам'яті, де CL-Launcher бере Java і що робити, якщо Java не знайдено.

Minecraft: Java Edition написаний на Java, тому для запуску гри потрібне середовище виконання Java (JRE). Різні версії Minecraft потребують різних версій Java.

## Системні вимоги

| | Вимога |
| - | - |
| **ОС** | Windows 10/11 (x64), частково Windows 7/8. Linux і macOS: через [CL:Cross](https://wiki.cl-launcher.app/cl-cross.md) (preview) |
| **Інтернет** | Потрібен для першого запуску кожної версії (завантаження файлів гри) |
| **Оперативна пам'ять для гри** | За замовчуванням лаунчер виділяє **2048 МБ** (2 ГБ) |

> [!NOTE]
>
> Без інтернету можна запускати лише ті версії, які вже хоча б раз запускалися онлайн. Інакше лаунчер покаже повідомлення «Потрібен інтернет».

## Яка Java потрібна для якої версії

| Версія Minecraft | Потрібна Java |
| - | - |
| До 1.16.5 включно | **Java 8** |
| 1.17 – 1.17.1 | **Java 16** |
| 1.18 – 1.20.4 | **Java 17** |
| 1.20.5 і новіші | **Java 21** |

> [!TIP]
>
> Модлоадери (Forge, Fabric, Quilt, NeoForge, OptiFine) потребують ту саму Java, що й відповідна версія Minecraft.

## Де лаунчер бере Java

**Windows (основна версія)**

Встановлювати Java вручну **не потрібно**. Під час запуску версії лаунчер сам завантажує потрібний рантайм Java від Mojang разом з іншими файлами гри і зберігає його в папці `runtime` у каталозі лаунчера (`%APPDATA%\.ClMinecraft`).

Тому перший запуск нової версії може тривати довше: лаунчер завантажує не лише гру, а й Java.

**Linux і macOS (CL:Cross)**

У [CL:Cross](https://wiki.cl-launcher.app/cl-cross.md) Java обирається вручну зі списку перед натисканням «Грати». Лаунчер автоматично шукає встановлені Java і показує лише робочі рантайми з відомою версією.

Де лаунчер шукає Java:

* змінні `PATH`, `JAVA_HOME`, `JDK_HOME`;
* папка `runtime/` у каталозі лаунчера (рантайми від Mojang);
* **Linux:** `/usr/lib/jvm`, `/usr/lib64/jvm`, `/usr/java`, `/opt/java`, `~/.sdkman/candidates/java`, `~/.jdks`;
* **macOS:** `/Library/Java/JavaVirtualMachines`.

Каталог лаунчера: `~/.clminecraft` на Linux і `~/Library/Application Support/CLMinecraft` на macOS.

## Що робити, якщо «Java not found»

> **Windows: гра не запускається через Java**
>
> 1. Перевірте інтернет-з'єднання: лаунчер завантажує Java під час першого запуску версії.
> 2. Переконайтеся, що антивірус або файрвол не блокує завантаження файлів.
> 3. Запустіть версію ще раз, щоб лаунчер докачав відсутні файли.
> 4. Якщо не допомогло, видаліть папку `runtime` у `%APPDATA%\.ClMinecraft` і запустіть гру знову: лаунчер завантажить Java заново.

> **Linux: список Java порожній**
>
> Встановіть Java через пакетний менеджер і перезапустіть лаунчер:
>
> ```bash theme={null}
> # Debian / Ubuntu
> sudo apt install openjdk-21-jre
>
> # Fedora
> sudo dnf install java-21-openjdk
>
> # Arch
> sudo pacman -S jre-openjdk
> ```
>
> Для старих версій Minecraft (до 1.16.5) додатково встановіть Java 8, для 1.18–1.20.4 встановіть Java 17.

> **macOS: список Java порожній**
>
> Встановіть JDK потрібної версії (наприклад, [Eclipse Temurin](https://adoptium.net/)). Лаунчер знайде його в `/Library/Java/JavaVirtualMachines` після перезапуску.

> **Java є, але гра вилітає одразу після запуску**
>
> Найчастіше це означає, що обрана **не та версія Java**. Звірте її з таблицею вище. Наприклад, Minecraft 1.21 не запуститься на Java 17, а старі версії з модами можуть не працювати на Java 21.
>
> Щоб знайти точну причину, скористайтеся [аналізом логів за допомогою ШІ](https://wiki.cl-launcher.app/ai.md).

## Скільки оперативної пам'яті виділяти

За замовчуванням лаунчер виділяє грі **2 ГБ**. Цього вистачає для ванільної гри, але для модпаків зазвичай потрібно більше.

| Сценарій | Рекомендовано |
| - | - |
| Ваніль, OptiFine | 2–4 ГБ |
| Невеликі збірки (до \~50 модів) | 4–6 ГБ |
| Великі збірки (100+ модів) | 6–8 ГБ |

> [!WARNING]
>
> Не виділяйте грі більше половини оперативної пам'яті комп'ютера. Системі та іншим програмам теж потрібна пам'ять, інакше гра може працювати повільніше, а не швидше.

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

> **[Завантажити лаунчер](https://wiki.cl-launcher.app/download.md)**
>
> Версії для Windows, Linux і macOS

> **[CL:Cross](https://wiki.cl-launcher.app/cl-cross.md)**
>
> Кросплатформна версія на Avalonia


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