# 📘 Navigation

- [🔧 Install Instructions](#install-instructions)
- [✨ Features](#features)
- [🚀 Getting Started](#getting-started)
- [⚠️ Disclaimer](#disclaimer)
- [💰 Donate](#support-our-project-crypto-wallets)

## Other languages
> [Русский](readme/ru_ru/README.md)

## Support channel
> [Telegram](https://me.astralium.su/ref/telegram_channel)

---

# About Project

## **AstralRinth • Empowering Your Minecraft Experience**

**AstralRinth** — a powerful fork of Modrinth, reimagined to enhance your Minecraft journey. Whether you're a GUI enthusiast or a developer building with Modrinth’s API, **Theseus Core** is your launchpad into a new era of Minecraft gameplay.

## **About the Software**

**AstralRinth** is a dedicated branch of the Modrinth (a.k.a Theseus) project, focused on **offline authentication**, offering you more flexibility and control. Play Minecraft without the need for constant online verification — a user-first approach to modern modded gaming.

---

# Install Instructions

To install the launcher:

1. Visit the [releases page](https://git.astralium.su/didirus/AstralRinth/releases) to download the correct version for your system.
2. Run the downloaded file or extract and launch it, depending on the format.

### Downloadable File Extensions

| Extension | OS      | Notes                                                                 |
| --------- | ------- | --------------------------------------------------------------------- |
| `.msi`    | Windows | Supported on all recent Windows versions (10/11)                              |
| `.dmg`    | macOS   | Works on Ventura, Sonoma, Sequoia, Tahoe _(may also support older versions)_ |
| `.deb`    | Linux   | Basic support; compatibility may vary by distribution                 |

### Installation Warnings

Avoid using builds with these prefixes — they may be unstable or experimental:

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

---

# Features

> _The launcher provides an opportunity to use the well-known Modrinth, but with an improved user experience._

## Included exclusive features

- No ads in the entire launcher.
- Custom `.svg` vector icons for a distinct UI.
- Improved compatibility with both licensed and pirate accounts.
  - Use **official microsoft accounts** or **offline/pirate accounts**.
  - Supports license-free access for testing or personal use.
  - No dependence on official authentication services.
- Discord Rich Presence integration:
  - Dynamic status messages.
  - In-game timer and AFK counter.
- Strict disabling of statistics and other Modrinth metrics.
- Optimized archive/package size.
- Integrated update fetcher for seamless version management.
  - Built-in update alerts for new versions posted on Git Astralium.
  - Automatic download and installation capabilities.
- Database migration fixes, when error occurred (Interactive Mode) (Modrinth issue)
- Ely.by full integration
  - The official account skin system is managed by ely.by
  - Offline accounts must install AuthLib through the instance settings

---

# Getting Started

To begin using AstralRinth:

1. **Download Latest Release**

   - Go to the [releases page](https://git.astralium.su/didirus/AstralRinth/releases)
   - [How to choose a file](#downloadable-file-extensions)
   - [How to choose a release](#installation-warnings)

2. **Log in or create new offline account**

   - Use your official Microsoft account (MSA), or test using a non-licensed account (Offline).

3. **Launch Minecraft**
   - Start Minecraft from the launcher.
   - The launcher will auto-detect the recommended JVM version.
   - You can also configure Java manually in the settings.

---

# Disclaimer

- **AstralRinth** is intended **solely for educational and experimental use**.
- We **do not condone piracy** — users are encouraged to purchase a legitimate Minecraft license.
- Respect all relevant licensing agreements and support Minecraft developers.

---

# Support Our Project (Crypto Wallets)

If you'd like to support development, you can donate via the following crypto wallets:

- Toncoin (TON): UQA5pGOJhIz9UAVEOh5t2ur1QVbNr_FC1eq9bOb3GwTgaiqk
- USDT (TON): UQA5pGOJhIz9UAVEOh5t2ur1QVbNr_FC1eq9bOb3GwTgaiqk
