docs/README_ru.md

# Hello Minecraft! Launcher

<!-- #BEGIN COPY -->
<!-- #PROPERTY NAME=BADGES -->
[![Build Status](https://ci.huangyuhui.net/job/HMCL/badge/icon?.svg)](https://ci.huangyuhui.net/job/HMCL)
![Downloads](https://img.shields.io/github/downloads/HMCL-dev/HMCL/total?style=flat)
![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_uk.md)
<!-- #END LANGUAGE_SWITCHER -->

## Введение

HMCL — это открытый, кроссплатформенный лаунчер для Minecraft с поддержкой управления модами, настройки игры, установки загрузчиков модов (Forge, NeoForge, Fabric, Quilt, LiteLoader и OptiFine), создания модпаков, настройки интерфейса и многого другого.

HMCL обладает отличной кроссплатформенностью. Он работает не только на различных операционных системах, таких как Windows, Linux, macOS и FreeBSD, но и поддерживает различные архитектуры процессоров: x86, ARM, RISC-V, MIPS и LoongArch. Благодаря HMCL вы можете легко наслаждаться 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+

### Сборка

Выполните следующую команду в корневой директории проекта:

```bash
./gradlew clean build
```

Убедитесь, что у вас установлена Java 17 или новее.

## Параметры JVM (для отладки)

| Параметр                                      | Описание                                                                                                      |
|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------|
| `-Dhmcl.home=<путь>`                          | Переопределить директорию HMCL                                                                                |
| `-Dhmcl.self_integrity_check.disable=true`    | Отключить проверку целостности при проверке обновлений                                                        |
| `-Dhmcl.bmclapi.override=<url>`               | Переопределить корневой API-адрес провайдера загрузки BMCLAPI. По умолчанию `https://bmclapi2.bangbang93.com` |
| `-Dhmcl.font.override=<название шрифта>`      | Переопределить семейство шрифтов                                                                              |
| `-Dhmcl.version.override=<версия>`            | Переопределить номер версии                                                                                   |
| `-Dhmcl.update_source.override=<url>`         | Переопределить источник обновлений для самого HMCL                                                            |
| `-Dhmcl.authlibinjector.location=<путь>`      | Использовать указанный authlib-injector (вместо загрузки)                                                     |
| `-Dhmcl.openjfx.repo=<url репозитория maven>` | Добавить пользовательский Maven-репозиторий для загрузки OpenJFX                                              |
| `-Dhmcl.native.encoding=<кодировка>`          | Переопределить нативную кодировку                                                                             |
| `-Dhmcl.microsoft.auth.id=<App ID>`           | Переопределить Microsoft OAuth App ID                                                                         |
| `-Dhmcl.microsoft.auth.secret=<App Secret>`   | Переопределить Microsoft OAuth App Secret                                                                     |
| `-Dhmcl.curseforge.apikey=<Api Key>`          | Переопределить 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 -->
-												将 README.md 翻译至更多语言 (#4397)


											
										
										
											2025-09-06 01:41:36 +08:00
+								[![Build Status](https://ci.huangyuhui.net/job/HMCL/badge/icon?.svg)](https://ci.huangyuhui.net/job/HMCL)
 								![Downloads](https://img.shields.io/github/downloads/HMCL-dev/HMCL/total?style=flat)
 								![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_uk.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
 								## Введение
 								HMCL — это открытый, кроссплатформенный лаунчер для Minecraft с поддержкой управления модами, настройки игры, установки загрузчиков модов (Forge, NeoForge, Fabric, Quilt, LiteLoader и OptiFine), создания модпаков, настройки интерфейса и многого другого.
 								HMCL обладает отличной кроссплатформенностью. Он работает не только на различных операционных системах, таких как Windows, Linux, macOS и FreeBSD, но и поддерживает различные архитектуры процессоров: x86, ARM, RISC-V, MIPS и LoongArch. Благодаря HMCL вы можете легко наслаждаться Minecraft на разных платформах.
-												将 README.md 移动至 docs 文件夹中 (#4398)


											
										
										
											2025-09-06 02:06:30 +08:00
+								Список поддерживаемых систем и архитектур процессоров HMCL смотрите в [этой таблице](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+
 								### Сборка
 								Выполните следующую команду в корневой директории проекта:
 								```bash
 								./gradlew clean build
 								```
 								Убедитесь, что у вас установлена Java 17 или новее.
 								## Параметры JVM (для отладки)
 								| Параметр                                      | Описание                                                                                                      |
 								|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------|
 								| `-Dhmcl.home=<путь>`                          | Переопределить директорию HMCL                                                                                |
 								| `-Dhmcl.self_integrity_check.disable=true`    | Отключить проверку целостности при проверке обновлений                                                        |
 								| `-Dhmcl.bmclapi.override=<url>`               | Переопределить корневой API-адрес провайдера загрузки BMCLAPI. По умолчанию `https://bmclapi2.bangbang93.com` |
 								| `-Dhmcl.font.override=<название шрифта>`      | Переопределить семейство шрифтов                                                                              |
 								| `-Dhmcl.version.override=<версия>`            | Переопределить номер версии                                                                                   |
 								| `-Dhmcl.update_source.override=<url>`         | Переопределить источник обновлений для самого HMCL                                                            |
 								| `-Dhmcl.authlibinjector.location=<путь>`      | Использовать указанный authlib-injector (вместо загрузки)                                                     |
 								| `-Dhmcl.openjfx.repo=<url репозитория maven>` | Добавить пользовательский Maven-репозиторий для загрузки OpenJFX                                              |
 								| `-Dhmcl.native.encoding=<кодировка>`          | Переопределить нативную кодировку                                                                             |
 								| `-Dhmcl.microsoft.auth.id=<App ID>`           | Переопределить Microsoft OAuth App ID                                                                         |
 								| `-Dhmcl.microsoft.auth.secret=<App Secret>`   | Переопределить Microsoft OAuth App Secret                                                                     |
 								| `-Dhmcl.curseforge.apikey=<Api Key>`          | Переопределить CurseForge API Key                                                                             |