# Qomicex Minecraft Launcher
[](https://github.com/Qomicex-Public/Qomicex.Tauri/)
[](https://github.com/Qomicex-Public/Qomicex.Tauri/issues)
[](https://github.com/Qomicex-Public/Qomicex.Tauri/pulls)
[](https://www.rust-lang.org)
[](https://react.dev)
[](https://tauri.app)
[](LICENSE)
[](https://github.com/Qomicex-Public/Qomicex.Tauri/actions/workflows/release.yml)
[Official Website](https://www.qomicex.top)
[Download Latest](https://github.com/Qomicex-Public/Qomicex.Tauri/releases/latest)
[Qomicex Minecraft Launcher](https://github.com/Qomicex-Public/Qomicex.Tauri) (QML) is currently in beta — feel free to give it a try.
> The backend has been fully rewritten in Rust (axum). Core libraries and downloader have been migrated to Rust submodules (`qomicex-core-rust` / `qomicex-connector-rust` / `qomicex-downloader-rust`), no longer depending on .NET SDK.
## ✨ Features
> Desktop edition (Tauri v2), with all core logic implemented in Rust.
Qomicex Launcher (QML) aims to make launching, installing, and managing instances as straightforward as possible — whether you're playing daily, installing modpacks, or playing online with friends.
### 🚀 Game Launch
Supports launching vanilla Minecraft and most Mod Loaders with **one-click auto-install**:
- Vanilla
- Forge
- Fabric
- NeoForge
- Quilt
- Babric
- LegacyFabric
- Cleanroom
The launcher reads instance configuration and automatically assembles libraries, assets, natives, JVM arguments, and game parameters. Launch logs are recorded in full for troubleshooting crashes and mod conflicts.
### 🔐 Account Login
Multiple login methods are supported:
- **Microsoft (Premium)** — OAuth device code flow: one-time device code authorization, credentials saved locally for next login
- **Offline player name** — for local testing, single-player, or environments without premium verification
- **Yggdrasil skin servers** — built-in presets for LittleSkin, Blessing Skin, etc.; supports importing other servers
Skin servers support **drag-and-drop link import**: Yggdrasil server addresses are automatically parsed (authlib-injector spec), no manual entry needed.
### 🌐 Built-in Online Play
QML features **Scaffolding Protocol online play** — no public IP needed to play with friends:
- Host / join rooms, NAT type detection (STUN multi-port fallback), relay networking
- **Persistent physical ban on kick**: kicked players cannot rejoin even after reconnecting or restarting
- Accidental kick recovery: reconnection review popup (allow / reject / reject and don't remind again), room owner blacklist with one-click unban
- Host mod verification: missing mods flagged, forced sync when inconsistent
- Compatible with HMCL, PCL-CE, PCL.Mac, and other Scaffolding-compatible launchers
### 📦 Instance Management
Each game version or modpack is stored as an **independent instance** with isolated directories:
- One-click install for versions and loaders (Forge / Fabric / NeoForge / Quilt / etc.)
- Per-instance management: mods, saves, resource packs, shader packs, config files, Java & memory, JVM arguments
- Custom instance groups for organizing large numbers of versions
### 📐 Schematic Management · Deepslate 3D Preview
The instance detail page includes built-in **Litematica schematic** management and preview:
- List / search / open folder / import (multipart, extension whitelist) / rename / single delete + batch delete
- **Deepslate WebGL 3D preview**: view full schematic content + material palette + Y-layer slider + multi-region + block/material statistics
- Materials extracted on-demand from the user's game jar at runtime and cached locally — **no bundled Mojang assets** (copyright compliant)
- Schematics directory included in version isolation, stored per instance
### 🗂️ Resource Center
Aggregates **Modrinth / CurseForge / FTB** data sources for one-stop resource browsing:
- Search mods, modpacks, shaders, resource packs, datapacks, saves
- MC Wiki Chinese name completion for friendlier browsing
- Online search and install for mods, resource packs, shader packs
- One-stop resource detail view
### ⬇️ Download Center
A unified downloader handles game files, libraries, resource files, loader installers, modpacks, and online mod downloads:
- Custom high-speed download engine, multi-file async download, real-time progress per task
- Resume on failure, pause / resume / cancel
- Auto-fallback on slow/failure, source cooldown to avoid hitting rate-limited sources
All download tasks — instance installs, mod downloads, Java runtimes — are managed in one place with full progress and error visibility.
### 📥 Modpack Import / Export
- **Import**: local `zip` / Modrinth `.mrpack` upload, auto-parsed and one-click installed; auto-detects version, loader, mods, config, and resource directories; cleanup on cancel/failure
- **Export**: CurseForge `zip`, Modrinth `mrpack`, or Qomicex-exclusive `.qmodpack`; hash reverse-lookup auto-generates file manifests
- HMCL-style **per-file checkbox export**: custom package name / version / author, async tasks with progress, cancellable, custom save path
### 🧩 Mod Management
Each instance has its own management page:
- View installed mods, enable / disable / delete
- Open instance directory and common folders (mods, saves, resource packs, shader packs, config)
- Online search and install for mods, resource packs, shader packs
- **Mod update check**: Modrinth / CurseForge batch hash matching, change list fed to download center for update orchestration
Disabling a mod preserves the file — only the enabled state changes, making conflict diagnosis easy.
### 📎 Mod Dependency Auto-Install
When installing a mod, QML automatically resolves its **dependency graph** from Modrinth / CurseForge:
- Identifies and displays **required dependencies**, with recursive deep-dependency resolution
- One-click install of prerequisites along with the target mod — no more "missing dependency" errors
- Optional skip for non-required dependencies, choose your install scope
### ☕ Java Runtime Management
Different versions require different Java versions. QML auto-selects the right Java per instance:
- Auto-scan locally installed Java
- Auto-download missing Java 8 / 17 / 21
- Manual Java path selection, per-instance override
- Launch-time Java version validation
### 💾 Save & Game Settings Editor
- **Save settings editor (level.dat NBT)**: visual editing of game mode, difficulty, weather, spawn point, world border, game rules; supports restore from `level.dat_old`
- **Game settings**: visual editing of `options.txt` with multi-language descriptions; array values (resourcePacks / datapacks) managed as chips
### 🩺 Log Analysis & Crash Troubleshooting
After a game crash, the launcher can analyze launch logs:
- **Local rule-based analysis**: 44 built-in error patterns, sorted by Critical > Error > Warning > Info; no extra config needed
- **AI analysis** (plugin-provided): fill in OpenAI-compatible API endpoint, key, and model name
### 🧩 Plugin System
QML offers an extensible plugin ecosystem:
- Manifest contribution points, inline rendering / iframe overlays, inter-plugin method calls
- **L3 WASM plugin gateway** (wasmtime sandbox, written in Rust): plugins run as WebAssembly in a restricted sandbox
- Plugin packages (`.qplugin`) uploaded and installed, state persisted locally
### 🎨 Personalization & Multi-language
- **I18N**: 7 languages — Chinese (Simplified / Traditional) / English (US / GB) / Japanese / Russian, with "follow system" option and real-time switching
- Custom UI font (enumerates system fonts with live preview)
- Built-in / custom background, theme color, and UI personalization options
## 🔗 Dependencies & Related Projects
QML's core capabilities are provided by the following **Rust submodules** (git submodules at repo root, pulled via `git submodule update --recursive`):
- [qomicex-core-rust](https://github.com/Qomicex-Public/qomicex-core-rust) — core library (GameCore, instance / account / Java / download business logic)
- [qomicex-downloader-rust](https://github.com/Qomicex-Public/qomicex-downloader-rust) — unified high-speed downloader
- [qomicex-connector-rust](https://github.com/Qomicex-Public/qomicex-connector-rust) — online play / Scaffolding protocol library (depends on EasyTier4QML fork)
- [Qomicex.Tauri.i18n](https://github.com/Qomicex-Public/Qomicex.Tauri.i18n) — frontend multi-language resource repository
**Partner / Related community project**:
- [EuoraCraft-Launcher (ECLteam)](https://github.com/ECLteam/EuoraCraft-Launcher) — ECLteam's Python + Tauri third-party Minecraft launcher, which **shares online nodes** with QML and is **compatible with the SCF protocol extension** for cross-launcher multiplayer
## 🔗 Links
| Link | URL |
|:--|:--|
| Official Website |