docs/README_uk.md

# Hello Minecraft! Launcher

<!-- #BEGIN COPY -->
<!-- #PROPERTY NAME=BADGES -->
[![CNB](https://img.shields.io/badge/cnb-mirror-ff6200?logo=cloudnativebuild)](https://cnb.cool/HMCL-dev/HMCL)
[![Downloads](https://img.shields.io/github/downloads/HMCL-dev/HMCL/total?label=Downloads&style=flat)](https://github.com/HMCL-dev/HMCL/releases)
![Stars](https://img.shields.io/github/stars/HMCL-dev/HMCL?style=flat)
[![Discord](https://img.shields.io/discord/995291757799538688.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/jVvC7HfM6U)
[![QQ Group](https://img.shields.io/badge/QQ-HMCL-bright?label=&logo=qq&logoColor=ffffff&color=1EBAFC&labelColor=1DB0EF&logoSize=auto)](https://docs.hmcl.net/groups.html)
<!-- #END COPY -->

<!-- #BEGIN LANGUAGE_SWITCHER -->
English ([Standard](README.md), [uʍoᗡ ǝpᴉsd∩](README_en_Qabs.md)) | 中文 ([简体](README_zh.md), [繁體](README_zh_Hant.md), [文言](README_lzh.md)) | [日本語](README_ja.md) | [español](README_es.md) | [русский](README_ru.md) | **українська**
<!-- #END LANGUAGE_SWITCHER -->

## Вступ

HMCL — це відкритий, кросплатформний лаунчер для Minecraft, який підтримує керування модами, налаштування гри, встановлення модлоадерів (Forge, NeoForge, Cleanroom, Fabric, Quilt, LiteLoader та OptiFine), створення модпаків, налаштування інтерфейсу та багато іншого.

HMCL має чудові кросплатформні можливості. Він працює не лише на різних операційних системах, таких як Windows, Linux, macOS і FreeBSD, а й підтримує різні архітектури процесорів, такі як x86, ARM, RISC-V, MIPS і LoongArch. Ви можете легко насолоджуватися Minecraft на різних платформах за допомогою HMCL.

Щодо підтримуваних систем і архітектур процесорів дивіться [цю таблицю](PLATFORM.md).

## Завантаження

Завантажте останню версію з [офіційного сайту](https://hmcl.huangyuhui.net/download).

Також ви можете знайти останню версію HMCL у [релізах GitHub](https://github.com/HMCL-dev/HMCL/releases).

Хоча це не обовʼязково, рекомендується завантажувати релізи лише з офіційних сайтів, зазначених вище.

## Ліцензія

Дивіться [README.md](README.md#license).

## Внесок

Якщо ви хочете надіслати pull request, ознайомтеся з наступними вимогами:

* IDE: IntelliJ IDEA
* Компілятор: Java 17+

### Компіляція

Дивіться сторінку [Посібник зі збірки](./Building.md).

## JVM Options (for debugging)

| Parameter                                    | Description                                                                                   |
|----------------------------------------------|-----------------------------------------------------------------------------------------------|
| `-Dhmcl.home=<path>`                         | Override HMCL directory                                                                       |
| `-Dhmcl.self_integrity_check.disable=true`   | Bypass the self integrity check when checking for updates                                     |
| `-Dhmcl.bmclapi.override=<url>`              | Override API Root of BMCLAPI download provider. Defaults to `https://bmclapi2.bangbang93.com` |
| `-Dhmcl.font.override=<font family>`         | Override font family                                                                          |
| `-Dhmcl.version.override=<version>`          | Override the version number                                                                   |
| `-Dhmcl.update_source.override=<url>`        | Override the update source for HMCL itself                                                    |
| `-Dhmcl.authlibinjector.location=<path>`     | Use the specified authlib-injector (instead of downloading one)                               |
| `-Dhmcl.openjfx.repo=<maven repository url>` | Add custom Maven repository for downloading OpenJFX                                           |
| `-Dhmcl.native.encoding=<encoding>`          | Override the native encoding                                                                  |
| `-Dhmcl.microsoft.auth.id=<App ID>`          | Override Microsoft OAuth App ID                                                               |
| `-Dhmcl.microsoft.auth.secret=<App Secret>`  | Override Microsoft OAuth App Secret                                                           |
| `-Dhmcl.curseforge.apikey=<Api Key>`         | Override CurseForge API Key                                                                   |
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
+								# Hello Minecraft! Launcher
-												使用宏自动从英文文档复制部分内容 (#4406)


											
										
										
											2025-09-08 20:40:23 +08:00
+								<!-- #BEGIN COPY -->
 								<!-- #PROPERTY NAME=BADGES -->
-												Add CNB badge (#4999)


											
										
										
											2025-12-18 20:11:06 +08:00
+								[![CNB](https://img.shields.io/badge/cnb-mirror-ff6200?logo=cloudnativebuild)](https://cnb.cool/HMCL-dev/HMCL)
-												Update badges (#4595)


											
										
										
											2025-10-03 21:46:09 +08:00
+								[![Downloads](https://img.shields.io/github/downloads/HMCL-dev/HMCL/total?label=Downloads&style=flat)](https://github.com/HMCL-dev/HMCL/releases)
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
+								![Stars](https://img.shields.io/github/stars/HMCL-dev/HMCL?style=flat)
 								[![Discord](https://img.shields.io/discord/995291757799538688.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/jVvC7HfM6U)
 								[![QQ Group](https://img.shields.io/badge/QQ-HMCL-bright?label=&logo=qq&logoColor=ffffff&color=1EBAFC&labelColor=1DB0EF&logoSize=auto)](https://docs.hmcl.net/groups.html)
-												使用宏自动从英文文档复制部分内容 (#4406)


											
										
										
											2025-09-08 20:40:23 +08:00
+								<!-- #END COPY -->
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
-												使用 Gradle 自动更新文档内容 (#4403)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
											
										
										
											2025-09-07 15:47:17 +08:00
+								<!-- #BEGIN LANGUAGE_SWITCHER -->
-												Add README_en_Qabs.md (#4594)


											
										
										
											2025-10-03 21:41:18 +08:00
+								English ([Standard](README.md), [uʍoᗡ ǝpᴉsd∩](README_en_Qabs.md)) | 中文 ([简体](README_zh.md), [繁體](README_zh_Hant.md), [文言](README_lzh.md)) | [日本語](README_ja.md) | [español](README_es.md) | [русский](README_ru.md) | **українська**
-												使用 Gradle 自动更新文档内容 (#4403)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
											
										
										
											2025-09-07 15:47:17 +08:00
+								<!-- #END LANGUAGE_SWITCHER -->
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
 								## Вступ
-												chore(docs&l10n): highlight support for cleanroom! (#4615)


											
										
										
											2025-10-10 15:53:21 +08:00
+								HMCL — це відкритий, кросплатформний лаунчер для Minecraft, який підтримує керування модами, налаштування гри, встановлення модлоадерів (Forge, NeoForge, Cleanroom, Fabric, Quilt, LiteLoader та OptiFine), створення модпаків, налаштування інтерфейсу та багато іншого.
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
 								HMCL має чудові кросплатформні можливості. Він працює не лише на різних операційних системах, таких як Windows, Linux, macOS і FreeBSD, а й підтримує різні архітектури процесорів, такі як x86, ARM, RISC-V, MIPS і LoongArch. Ви можете легко насолоджуватися Minecraft на різних платформах за допомогою HMCL.
-												将 README.md 移动至 docs 文件夹中 (#4398)


											
										
										
											2025-09-06 02:06:30 +08:00
+								Щодо підтримуваних систем і архітектур процесорів дивіться [цю таблицю](PLATFORM.md).
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
 								## Завантаження
 								Завантажте останню версію з [офіційного сайту](https://hmcl.huangyuhui.net/download).
 								Також ви можете знайти останню версію HMCL у [релізах GitHub](https://github.com/HMCL-dev/HMCL/releases).
 								Хоча це не обовʼязково, рекомендується завантажувати релізи лише з офіційних сайтів, зазначених вище.
 								## Ліцензія
 								Дивіться [README.md](README.md#license).
 								## Внесок
 								Якщо ви хочете надіслати pull request, ознайомтеся з наступними вимогами:
 								* IDE: IntelliJ IDEA
 								* Компілятор: Java 17+
 								### Компіляція
-												添加详细构建指南 (#4524)


											
										
										
											2025-10-26 15:53:15 +08:00
+								Дивіться сторінку [Посібник зі збірки](./Building.md).
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
 								## JVM Options (for debugging)
 								| Parameter                                    | Description                                                                                   |
 								|----------------------------------------------|-----------------------------------------------------------------------------------------------|
 								| `-Dhmcl.home=<path>`                         | Override HMCL directory                                                                       |
 								| `-Dhmcl.self_integrity_check.disable=true`   | Bypass the self integrity check when checking for updates                                     |
 								| `-Dhmcl.bmclapi.override=<url>`              | Override API Root of BMCLAPI download provider. Defaults to `https://bmclapi2.bangbang93.com` |
 								| `-Dhmcl.font.override=<font family>`         | Override font family                                                                          |
 								| `-Dhmcl.version.override=<version>`          | Override the version number                                                                   |
 								| `-Dhmcl.update_source.override=<url>`        | Override the update source for HMCL itself                                                    |
 								| `-Dhmcl.authlibinjector.location=<path>`     | Use the specified authlib-injector (instead of downloading one)                               |
 								| `-Dhmcl.openjfx.repo=<maven repository url>` | Add custom Maven repository for downloading OpenJFX                                           |
 								| `-Dhmcl.native.encoding=<encoding>`          | Override the native encoding                                                                  |
 								| `-Dhmcl.microsoft.auth.id=<App ID>`          | Override Microsoft OAuth App ID                                                               |
 								| `-Dhmcl.microsoft.auth.secret=<App Secret>`  | Override Microsoft OAuth App Secret                                                           |
 								| `-Dhmcl.curseforge.apikey=<Api Key>`         | Override CurseForge API Key                                                                   |