diff --git a/README.md b/README.md index b23ac38b..a7be669b 100644 --- a/README.md +++ b/README.md @@ -1,76 +1,123 @@ -# Navigation in this README -- [Install instructions](#install-instructions) -- [Features](#features) -- [Getting started](#getting-started) -- [Disclaimer](#disclaimer) -- [Donate](#support-our-project-crypto-wallets) +# 📘 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 AR • Fork of Modrinth, the ultimate game launcher designed to enhance your Minecraft experience through the Modrinth platform and their API. Whether you're a graphical interface enthusiast, or a developer integrating Modrinth projects, Theseus core is your gateway to a new level of Minecraft gaming. +## **AstralRinth • Empowering Your Minecraft Adventure** -## About Software -Introducing AstralRinth, a specialized variant of Theseus dedicated to implementing offline authorization for an even more flexible and user-centric Minecraft Modrinth experience. Roam the Minecraft realms without the constraints of online authentication, thanks to AstralRinth. +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. -## AR • Unlocking Minecraft's Boundless Horizon -Dive into the extraordinary world of AstralRinth, a fork of the original project with a unique focus on providing a free trial experience for Minecraft, all without the need for a license. Currently boasting: +- *Recently, improved integration with the Git Astralium API has been added.* -# Install instructions -- To install our application, you need to download a file for your operating system from our available releases or development builds • [Download variants here](https://git.astralium.su/didirus/AstralRinth/releases) -- After you have downloaded the required executable file or archive, then open it +## **About the Software** -### Downloadable file extensions -- `.msi` format for Windows OS system _(Supported popular latest versions of Microsoft Windows)_ -- `.dmg` format for MacOS system _(Works on Macos Ventura / Sonoma / Sequoia, but it should be works on older OS builds)_ -- `.deb` format for Linux OS systems _(Since there are quite a few distributions, we do not guarantee +**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. -### Installation subjects -- Builds in releases that are signed with the following prefixes are not recommended for installation and may contain errors: - - `dev` - - `nightly` - - `dirty` - - `dirty-dev` - - `dirty-nightly` - - `dirty_dev` - - `dirty_nightly` -- Auto-updating takes place through parsing special versions from releases, so we also distribute clean types of `.msi, .dmg and .deb` +## **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 -### Featured enhancement in AR -- AstralRinth offers a range of authorization options, giving users the flexibility to log in with valid licenses or even a pirate account without auth credentials breaks (_Unlike MultiMC Cracked and similar software_). Experience Minecraft on your terms, breaking free from traditional licensing constraints (_Popular in Russian Federation_). +> _The launcher provides an opportunity to use the well-known Modrinth, but with an improved user experience._ -### Easy to use -- Using the launcher is intuitive, any user can figure it out. +## Included exclusive features -### Update notifies -- We have implemented notifications about the release of new updates on our Git. The launcher can also download them for you and try to install them. +- 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) -### Enhancements -- Custom .SVG vectors for a personalized touch. -- Improved compatibility for both pirate and licensed accounts. -- Beautiful Discord RPC with random messages while playing, along with an in-game timer and AFK counter. -- Forced disabling of statistics collection (modrinch metrics) with a hard patch from AstralRinth, ensuring it remains deactivated regardless of the configuration setting. -- Removal of advertisements from all launcher views. -- Optimization of packages (archives). -- Integrated update fetching feature +--- # Getting Started -To begin your AstralRinth adventure, follow these steps: -1. **Download Your OS Version**: Head over to our [releases page](https://git.astralium.su/didirus/AstralRinth/releases/) to find the right file for your operating system. - - **Choosing the Correct File**: Ensure you select the file that matches your OS requirements. - - [**How select file**](#downloadable-file-extensions) - - [**How select release**](#installation-subjects) -2. **Authentication**: Log in with a valid license or, for testing, try using a pirate account to see AstralRinth in action. -3. **Launch Minecraft**: Start your journey by launching Minecraft through AstralRinth and enjoy the adventures that await. - - **Choosing java installation**: The launcher will try to automatically detect the recommended JVM version for running the game, but you can configure everything in the launcher settings. + +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 a project intended for experimentation and educational purposes only. It does not endorse or support piracy, and users are encouraged to obtain valid licenses for a fully-supported Minecraft experience. -- Users are reminded to respect licensing agreements and support the developers of Minecraft. -# Support our Project (Crypto Wallets) +- **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 -- USDT TRC20 (Telegram): TMSmv1D5Fdf4fipUpwBCdh16WevrV45vGr -- TONCOIN (Telegram): UQAqUJ2_hVBI6k_gPyfp_jd-1K0OS61nIFPZuJWN9BwGAvKe \ No newline at end of file +- TONCOIN (Telegram): UQAqUJ2_hVBI6k_gPyfp_jd-1K0OS61nIFPZuJWN9BwGAvKe diff --git a/readme/ru_ru/README.md b/readme/ru_ru/README.md new file mode 100644 index 00000000..ebc252ce --- /dev/null +++ b/readme/ru_ru/README.md @@ -0,0 +1,122 @@ +# 📘 Навигация + +- [🔧 Установка](#установка) +- [✨ Возможности](#возможности) +- [🚀 Начало работы](#начало-работы) +- [⚠️ Отказ от ответственности](#отказ-от-ответственности) +- [💰 Поддержать](#поддержать-проект-крипто-кошельки) + +## Другие языки +> [English](../../README.md) + +## Канал поддержки +> [Telegram](https://me.astralium.su/ref/telegram_channel) + +--- + +# О проекте + +## **AstralRinth • Раскрой потенциал своих приключений в Minecraft** + +Добро пожаловать в **AstralRinth (AR)** — мощный форк Modrinth, переосмысленный для улучшения твоего опыта в Minecraft. Независимо от того, являешься ли ты поклонником GUI или разработчиком, использующим API Modrinth, **Theseus Core** — это твоя стартовая платформа для новой эры игрового процесса в Minecraft. + +- *С недавнего времени имеется улучшенная интеграция с Git Astralium API* + +## **О программе** + +**AstralRinth** — это специализированная ветка проекта Theseus, сосредоточенная на **офлайн-аутентификации**, предоставляя ещё большую гибкость и ориентированность на пользователя. Путешествуй по мирам Minecraft без необходимости онлайн-авторизации — благодаря AstralRinth. + +## **AR • Открой безграничные горизонты Minecraft** + +Уникальный форк с фокусом на предоставление **пробного игрового опыта Minecraft** — без необходимости лицензии. В настоящее время включает: + +--- + +# Установка + +Чтобы установить лаунчер: + +1. Перейдите на [страницу релизов](https://git.astralium.su/didirus/AstralRinth/releases), чтобы скачать нужную версию для вашей системы. +2. После загрузки нужного исполняемого файла или архива — откройте его. + +### Поддерживаемые расширения файлов + +| Расширение | ОС | Примечания | +| ---------- | ------- | --------------------------------------------------------------------- | +| `.msi` | Windows | Поддерживаются актуальные версии Microsoft Windows | +| `.dmg` | macOS | Работает на MacOS Ventura / Sonoma / Sequoia, возможно и на старых | +| `.deb` | Linux | Так как дистрибутивов много, совместимость не гарантируется полностью | + +### Особенности установки + +Сборки с префиксами ниже **не рекомендуются к установке** и могут содержать ошибки: + +- `dev` +- `nightly` +- `dirty` +- `dirty-dev` +- `dirty-nightly` +- `dirty_dev` +- `dirty_nightly` + +--- + +# Возможности + +> _Лаунчер предоставляет возможность использовать знакомый Modrinth с улучшенным пользовательским интерфейсом._ + +## Уникальные функции + +- Отсутствие рекламы во всём лаунчере. +- Кастомные `.svg` векторы для персонализированного интерфейса. +- Улучшенная совместимость с лицензионными и пиратскими аккаунтами. + - Используйте **официальные аккаунты Microsoft** или **пиратские аккаунты** — без сбоев в авторизации. + - Поддержка безлицензионного доступа для тестирования или личного использования. + - Нет зависимости от официальных сервисов авторизации. +- Интеграция Discord Rich Presence: + - Случайные статусные сообщения. + - Таймер игры и счётчик AFK. +- Жёсткое отключение сбора статистики (метрик Modrinth) через патч AstralRinth — работает независимо от конфигурации. +- Удаление рекламы из всех окон лаунчера. +- Оптимизация архивов (пакетов). +- Встроенная система получения обновлений: + - Уведомления о новых версиях на Git. + - Возможность автозагрузки и автоустановки. +- Исправления миграции базы данных при ошибках (интерактивный режим, проблема Modrinth). +- Интеграция системы скинов ElyBy (AuthLib / Java). + +--- + +# Начало работы + +Чтобы начать приключение с AstralRinth, выполните следующие шаги: + +1. **Скачайте нужную версию под вашу ОС** + + - Перейдите на [страницу релизов](https://git.astralium.su/didirus/AstralRinth/releases) + - [**Как выбрать файл**](#поддерживаемые-расширения-файлов) + - [**Как выбрать релиз**](#особенности-установки) + +2. **Авторизация** + + - Войдите с действующей лицензией или используйте пиратский аккаунт для теста AstralRinth. + +3. **Запуск Minecraft** + - Запустите Minecraft через AstralRinth и наслаждайтесь. + - Лаунчер попытается автоматически определить рекомендованную JVM для запуска игры, но вы можете всё настроить вручную в настройках. + +--- + +# Отказ от ответственности + +- **AstralRinth** предназначен только для экспериментов и образовательных целей. Мы не поддерживаем пиратство и рекомендуем приобретать официальную лицензию Minecraft для полноценного игрового опыта. +- Пользователям напоминается соблюдать лицензионные соглашения и поддерживать разработчиков Minecraft. + +--- + +# Поддержать проект (крипто-кошельки) + +Если вы хотите поддержать разработку, вы можете отправить донат на следующие кошельки: + +- BTC (Telegram): 14g6asNYzcUoaQtB8B2QGKabgEvn55wfLj +- TONCOIN (Telegram): UQAqUJ2_hVBI6k_gPyfp_jd-1K0OS61nIFPZuJWN9BwGAvKe