Інструкція з встановлення

Лаунчер XMCL надає кілька зручних форматів встановлення для різних операційних систем.

Корисні посібники

• 💾 Потрібно перемістити лаунчер або ігрові дані на диск D: або E:? Перегляньте Гайд з переміщення на інший диск.
• 🧱 Бажаєте грати в Minecraft Bedrock Edition (Windows 10/11)? Перегляньте Гайд по Bedrock Edition.

---

Windows

Для користувачів Windows доступно кілька варіантів встановлення:

1. APPX та Онлайн-встановлення (appinstaller) — Рекомендовано

• APPX — це сучасний формат пакетів Windows 10/11. Програма працює в безпечному віртуалізованому середовищі. При видаленні лаунчера всі тимчасові файли та записи реєстру видаляються автоматично.
• AppInstaller — автоматично завантажує та оновлює AppX пакет через захищені канали Microsoft. Підтримує інкрементні оновлення (завантажуються лише змінені файли).

2. Портативний архів (Portable ZIP)

• Не вимагає встановлення чи прав адміністратора.
• Ви можете розпакувати файл у будь-яку папку (наприклад, D:\Games\XMCL) та відразу запускати xmcl.exe.
• Ідеально підходить для запуску з флешки або другого диска.

3. Запуск на Windows 7 / 8 / 8.1 (VxKex Kernel)

Важливе зауваження про сумісність

Сучасний XMCL побудований на базі Electron 43 / Chromium 130+. Офіційно Chromium та Microsoft повністю припинили підтримку Windows 7, 8 та 8.1. Нативно лаунчер на застарілих системах Windows не запуститься.

Технічна можливість запуску через ядро VxKex

Ви можете запустити XMCL на Windows 7 / 8 за допомогою неофіційного розширеного ядра VxKex:

1. Завантажте та встановіть розширене ядро VxKex-NEXT.
2. Клацніть правою кнопкою миші на xmcl.exe -> Властивості -> вкладка VxKex.
3. Позначте пункти "Enable VxKex NEXT for this program" та "Report other versions of Windows", після чого натисніть Застосувати.

Що працює, а що ні на Windows 7/8:

• ✅ Одиночна гра (Java Edition) — працює нормально при встановленні відповідної версії Java (Java 8 / 17 / 21).
• ❌ P2P Мережева гра (WebRTC) — не працює (потрібен мережевий стек Windows 10+).
• ❌ Bedrock Edition (UWP) — не працює (вимагає системний UWP фреймворк Windows 10/11).

---

macOS

DMG Пакет

1. Завантажте файл .dmg та відкрийте його.
2. Перетягніть XMCL.app у папку Applications (Програми).

Дозвіл на запуск незавірених програм

Оскільки XMCL поширюється з відкритим вихідним кодом і не має платний цифровий підпис Apple, macOS може заблокувати перший запуск. Виконайте команду в Терміналі:

# Зняти атрибут карантину macOS
sudo xattr -c /Applications/X\ Minecraft\ Launcher.app

---

Linux

AppImage

• Універсальний формат для всіх дистрибутивів Linux (Ubuntu, Fedora, Arch тощо).
• Зробіть файл виконуваним: chmod +x XMCL.AppImage та запустіть.

---

Вибір каталогу ігрових даних

Під час першого запуску XMCL попросить вибрати Каталог ігрових даних (Game Data Directory).

• Рекомендується вибрати окрему порожню папку (наприклад, D:\XMCL-Data або E:\Minecraft).
• Для детальної інформації про перенесення даних дивіться Посібник з управління даними та Гайд з переміщення на інший диск.