# 📘 Навигация

- [🔧 Инструкция по установке](#инструкция-по-установке)
- [✨ Возможности](#возможности)
- [🚀 Начало работы](#начало-работы)
- [⚠️ Отказ от ответственности](#отказ-от-ответственности)
- [💰 Поддержать](#поддержать-проект-крипто-кошельки)

## Другие языки
> [English](../../README.md)

## Канал поддержки
> [Telegram](https://me.astralium.su/ref/telegram_channel)

---

# О проекте

## **AstralRinth • Раскрой весь потенциал Minecraft**

**AstralRinth** — мощный форк Modrinth, переосмысленный для улучшения вашего опыта в Minecraft. Будь вы поклонником удобных GUI-интерфейсов или разработчиком, работающим с API Modrinth, **Theseus Core** станет вашим трамплином в новую эру модифицированного Minecraft.

## **О программе**

**AstralRinth** — это ответвление проекта Modrinth (известного также как Theseus), сосредоточенное на **офлайн-аутентификации**, обеспечивающее больше гибкости и контроля. Играйте в Minecraft без постоянной онлайн-проверки — подход, ориентированный на всех пользователей.

---

# Инструкция по установке

Чтобы установить лаунчер:

1. Перейдите на [страницу релизов](https://git.astralium.su/didirus/AstralRinth/releases) и скачайте подходящую версию для вашей системы.
2. Запустите загруженный файл или распакуйте архив и откройте приложение, в зависимости от формата.

### Поддерживаемые форматы файлов

| Расширение | ОС       | Примечания                                                                 |
| ----------- | -------- | -------------------------------------------------------------------------- |
| `.msi`      | Windows  | Поддерживается всеми актуальными версиями Windows (10/11)                 |
| `.dmg`      | macOS    | Работает на Ventura, Sonoma, Sequoia, Tahoe _(возможно, поддерживает и более старые)_ |
| `.deb`      | Linux    | Базовая поддержка; совместимость зависит от дистрибутива                 |

### Предупреждения об установке

Избегайте использования сборок с этими префиксами — они могут быть нестабильными или экспериментальными:

- `dev`
- `nightly`
- `dirty`
- `dirty-dev`
- `dirty-nightly`
- `dirty_dev`
- `dirty_nightly`

---

# Возможности

> _Лаунчер позволяет использовать знакомый Modrinth, но с улучшенным пользовательским опытом._

## Эксклюзивные функции

- Полное отсутствие рекламы в лаунчере.
- Собственные векторные иконки `.svg` для уникального интерфейса.
- Улучшенная совместимость с лицензионными и пиратскими аккаунтами.
  - Поддержка **официальных Microsoft-аккаунтов** и **офлайн-аккаунтов**.
  - Возможность использовать без лицензии для тестов или личных нужд.
  - Отсутствие зависимости от официальных сервисов аутентификации.
- Интеграция с Discord Rich Presence:
  - Динамические статусы.
  - Таймер в игре и счётчик AFK.
- Полное отключение сбора статистики и метрик Modrinth.
- Оптимизированный размер пакета.
- Встроенная система обновлений:
  - Автоматическое уведомление о новых версиях на Git Astralium.
  - Возможность автообновления и установки.
- Исправления ошибок миграции базы данных (интерактивный режим) — проблема Modrinth.
- Полная интеграция с Ely.by:
  - Система скинов управляется через Ely.by.
  - Для офлайн-аккаунтов требуется установка AuthLib через настройки инстанса.

---

# Начало работы

Чтобы начать пользоваться AstralRinth:

1. **Скачайте последнюю версию**
   - Перейдите на [страницу релизов](https://git.astralium.su/didirus/AstralRinth/releases)
   - [Как выбрать файл](#поддерживаемые-форматы-файлов)
   - [Как выбрать релиз](#предупреждения-об-установке)

2. **Войдите или создайте офлайн-аккаунт**
   - Используйте свой официальный Microsoft-аккаунт (MSA) или протестируйте вход с нелицензионным аккаунтом (офлайн).

3. **Запустите Minecraft**
   - Запустите Minecraft через лаунчер.
   - Лаунчер автоматически определит рекомендованную версию JVM.
   - При необходимости вы можете вручную указать Java в настройках.
---

# Отказ от ответственности

- **AstralRinth** предназначен только для экспериментов и образовательных целей. Мы не поддерживаем пиратство и рекомендуем приобретать официальную лицензию Minecraft для полноценного игрового опыта.
- Пользователям напоминается соблюдать лицензионные соглашения и поддерживать разработчиков Minecraft.

---

# Поддержать проект (крипто-кошельки)

Если вы хотите поддержать разработку, вы можете отправить донат на следующие кошельки:

- BTC (Telegram): 14g6asNYzcUoaQtB8B2QGKabgEvn55wfLj
- TONCOIN (Telegram): UQAqUJ2_hVBI6k_gPyfp_jd-1K0OS61nIFPZuJWN9BwGAvKe
