Лаунчер Minecraft для Linux и Windows на Rust
Русский · English
Установка · Возможности · Скриншоты · Быстрый старт · Сборка из исходников · Безопасность и приватность · FAQ
MQ — модульный лаунчер для Minecraft: Java Edition, написанный на Rust. Проект ориентирован на надежность, изоляцию инстансов, высокую скорость проверки целостности файлов за счет параллельных потоков Rayon и строгий паритет функций между операционными системами Linux (Wayland / X11) и Windows 10/11 x64.
В лаунчере полностью отсутствует встроенная телеметрия, трекинг и сбор пользовательских данных.
| Категория | Поддерживаемая функциональность |
|---|---|
| Платформы | Linux (Wayland и X11, x86_64), Windows 10/11 x64, портативный режим работы через маркер portable.flag. |
| Загрузчики модов | Vanilla, Fabric, Quilt, Forge, NeoForge. Переключение версий загрузчика на существующем инстансе. |
| Каталоги и модпаки | Встроенный поиск и установка из Modrinth API v2 и CurseForge API v1. Импорт и экспорт пакетов .mrpack и CurseForge .zip. Защита от Zip-Slip при распаковке. |
| Авторизация | Офлайн-режим (детерминированный UUID v3 OfflinePlayer:<никнейм> по RFC 4122), Ely.by (вход через браузер по протоколу OAuth2 + PKCE S256 с автоматической инъекцией authlib-injector), Microsoft (Device Code Flow в браузере). |
| Среда Java | Автоматическое определение установленных сред OpenJDK, автозагрузка Adoptium Temurin (Java 8, 17, 21), ручной выбор пути к java. |
| Хранилище CAS | Контентно-адресуемое хранилище библиотек и ассетов с дедупликацией через жесткие ссылки (hard links) для экономии дискового пространства. |
| Графика и шейдеры | Управление ресурспаками и шейдерами, определение графического адаптера, автоматическая запись параметров iris.properties и oculus.properties. |
| Интерфейс | Графический интерфейс на egui / eframe в монолитном темном стиле без полупрозрачности (Opaque Window), чисто векторные иконки Painter, отсутствие эмодзи. |
| Инструменты CLI | Полнофункциональный консольный интерфейс для автоматизации: mq launch, mq install, mq doctor, mq accounts, mq mods, mq self-update. |
Установка актуального релиза скриптом в одну команду:
curl -fsSL https://github.com/MrQuster/mq/releases/download/v2.2.0/install.sh | shПортативный запуск без установки в систему:
curl -LO https://github.com/MrQuster/mq/releases/download/v2.2.0/mq-linux-x86_64.tar.gz
tar -xzf mq-linux-x86_64.tar.gz
./mqУстановка через PowerShell в одну команду (права администратора UAC не требуются):
irm https://github.com/MrQuster/mq/releases/download/v2.2.0/install.ps1 | iexДругие способы установки на Windows:
- Классический инсталлятор: скачайте
MQ-Setup-2.2.0.exe. - Портативный архив: скачайте
mq-windows-x86_64-portable.zip(хранит данные в папкеdata/рядом с программой). - Пакетный менеджер Windows (winget):
winget install MrQuster.MQ
Подробная информация для Arch Linux, Ubuntu/Debian и Fedora доступна в Руководстве по установке.
- Запустите лаунчер:
mq
- Добавьте профиль: Во вкладке «Аккаунты» выберите удобный способ входа: локальный офлайн-режим, аккаунт Ely.by либо Microsoft.
- Создайте инстанс: Нажмите кнопку «Создать», укажите имя инстанса, версию Minecraft и необходимый загрузчик (например, 1.21.1 + Fabric).
- Установите моды (опционально):
Откройте вкладку «Каталог» или перетащите
.mrpack/.jarфайлы в окно лаунчера. - Нажмите «Играть»: Лаунчер проверит наличие ассетов, библиотек и исполняемой среды Java, после чего запустит игру.
Для сборки требуется компилятор Rust (стабильная версия 1.80+):
# 1. Клонирование репозитория
git clone https://github.com/MrQuster/mq.git
cd mq
# 2. Сборка оптимизированного релизного бинарного файла
cargo build --release
# 3. Запуск тестов
cargo test --workspaceИсполняемый файл будет расположен по пути target/release/mq (или target/release/mq.exe на Windows).
Подробная информация о системных библиотеках и разработке приведена в документе CONTRIBUTING.md.
| Параметр | Реализация в MQ Launcher |
|---|---|
| Телеметрия | Полное отсутствие (0 аналитических запросов, 0 трекинга, 0 логов на удаленные серверы). |
| Хранение токенов | Системный интерфейс Secret Service / Keyring в Linux, DPAPI / Credential Manager в Windows. Локальный файл учетных данных защищен маской прав 0600. |
| Авторизация Microsoft | Официальный протокол OAuth2 Device Code Flow через внешний браузер без ввода пароля в приложении. |
| Авторизация Ely.by | Протокол OAuth2 + PKCE S256 через системный браузер и локальный loopback-сервер 127.0.0.1:<port>/callback. |
| Защита архивов | Встроенный фильтр Zip-Slip и блокировка относительных путей при распаковке модов и модпаков. Деактивация небезопасных сторонних скриптов запуска. |
| Цепочка поставок | Цифровая подпись релизов Minisign Ed25519, аттестация происхождения GitHub OIDC Sigstore и хэши SHA-256. |
Подробнее о политиках безопасности:
- Политика безопасности (SECURITY.md)
- Политика приватности (PRIVACY.md)
- Модель угроз (THREAT_MODEL.md)
Ответы на вопросы о путях расположения данных, смене версий Java, шейдерах, фильтре SmartScreen и обновлении собраны в docs/FAQ.md.
Проект использует технологии и опирается на открытые разработки сообщества:
- Modrinth — современная открытая платформа модов и спецификация формата
.mrpack. - Ely.by — независимая система скинов и открытый сервис авторизации.
- authlib-injector — агент для безопасного перенаправления авторизации в среде JVM.
- Mojang Studios — создатели Minecraft.
- Fabric и Quilt — модульные и быстрые загрузчики модификаций.
Сведения о лицензиях всех используемых сторонних библиотек и компонентов приведены в документе THIRD_PARTY_LICENSES.md.
- MrQuster — MrQuster
MQ является независимым проектом с открытым исходным кодом и не связан с Mojang Studios, Microsoft Corporation или их дочерними структурами. Minecraft является зарегистрированным товарным знаком Mojang Studios.
Для игры на серверах с включенной проверкой подлинности (online-mode=true) требуется официальный лицензионный аккаунт. Ely.by является независимым сообществом и не связано с Mojang Studios. Проект MQ не использует и не распространяет проприетарные ресурсы, текстуры или зарегистрированные торговые марки Minecraft.