📘 Navigation

• 🔧 Install Instructions
• ✨ Features
• 🚀 Getting Started
• 🛠️ Разработка
• ⚠️ Disclaimer
• 💰 Donate

Other languages

Русский

Support channel

Telegram

---

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 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 offline accounts.
  • Use official microsoft accounts or offline 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
   • How to choose a file
   • How to choose a release

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.

---

Development

Before continue you need to install mise tool for easy install libraries and running application on any OS (Windows, macOS, Linux)

1. mise activate
2. mise install
3. mise exec rust -- rustup toolchain install stable
4. mise exec pnpm -- pnpm install
5. mise exec rust -- cargo install tauri-cli --version "^2.5.0"
6. mise exec pnpm -- pnpm app:dev — Development (unoptimized)
7. mise exec pnpm -- pnpm app:build — Production

---

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