# 📘 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 Adventure**

Welcome to **AstralRinth (AR)** — 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.

- *Recently, improved integration with the Git Astralium API has been added.*

## **About the Software**

**AstralRinth** is a dedicated branch of the 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.

## **AR • Unlocking Minecraft's Boundless Horizon**

This unique fork introduces a **free trial Minecraft experience**, bypassing license checks while maintaining rich functionality. Currently includes:

---

# 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                              |
| `.dmg`    | macOS   | Works on Ventura, Sonoma, Sequoia _(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** — login won't break.
  - 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)
- ElyBy skin system integration (AuthLib / Java)

---

# Getting Started

To begin using AstralRinth:

1. **Download Your OS Version**

   - 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**

   - Use your official Mojang/Microsoft account, or test using a non-licensed account.

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:

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