https://github.com/mrmayman/quantum-launcher
A fast Minecraft launcher written in Rust
https://github.com/mrmayman/quantum-launcher
iced launcher minecraft rust
Last synced: 9 months ago
JSON representation
A fast Minecraft launcher written in Rust
- Host: GitHub
- URL: https://github.com/mrmayman/quantum-launcher
- Owner: Mrmayman
- License: gpl-3.0
- Created: 2024-03-09T15:23:46.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-10T03:36:42.000Z (9 months ago)
- Last Synced: 2025-04-10T04:25:51.872Z (9 months ago)
- Topics: iced, launcher, minecraft, rust
- Language: Rust
- Homepage: https://mrmayman.github.io/quantumlauncher
- Size: 6.47 MB
- Stars: 57
- Watchers: 4
- Forks: 8
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
QuantumLauncher
## [Website](https://mrmayman.github.io/quantumlauncher) | [Discord](https://discord.gg/bWqRaSXar5)
A minimalistic Minecraft launcher for Windows, macOS and Linux.
QuantumLauncher is written in *Rust* with the *iced* framework,
offering a lightweight and responsive experience.
It is designed to be simple and easy to use, with a focus on performance and features.
# Features
## Lightweight and responsive
## Install fabric, forge or optifine with ease
## Build in mod store to download your favorite mods
## Isolate your different game versions with instances!
## Full support for old minecraft versions, integrated with Omniarchive. Includes skin and sound fixes!
## Neatly package your mods into presets, and share it with your friends!
## Built in themes!
# Downloads and Building
You can download the stable version from the website linked above, or from the *Releases* button
Or, you can compile the launcher to get the latest experimental version (with potentially broken and untested features).
To compile the launcher:
```
git clone https://github.com/Mrmayman/quantum-launcher.git
cd quantum-launcher
cargo run --release
```
You can omit the `--release` flag for faster compile times, but *slightly* worse performance and MUCH larger build file size.
# Why QuantumLauncher?
- QuantumLauncher provides a feature rich, flexible, simple
and lightweight experience with plenty of modding features.
What about the others? Well...
- The official Minecraft launcher is slow, unstable, buggy and frustrating to use,
with barely any modding features.
- PrismLauncher is a great launcher overall, but it does not support
offline accounts. Same for MultiMC.
- Legacy Launcher isn't as feature rich as this
- TLauncher is *suspected* to be malware
# File Locations
- On *Windows*, the launcher files are at `C:/Users/YOUR_USERNAME/AppData/Roaming/QuantumLauncher/`.
- You probably won't see the `AppData` folder. Press Windows + R and paste this path, and hit enter.
- On *Linux*, the launcher files are at `~/.config/QuantumLauncher/`. (`~` refers to your home directory).
- Instances located at `QuantumLauncher/instances/YOUR_INSTANCE/`
- `.minecraft` located at `YOUR_INSTANCE/.minecraft/`.
- Launcher logs are located at `QuantumLauncher/logs/`.
# To-do (in the future)
(note: WIP means work-in-progress)
## Core
- [x] Instance creation
- [x] Instance launching
- [x] Instance deletion
- [x] Instance renaming
- [x] Java/Game args editing
- [x] Memory allocation editing
- [x] Optional Microsoft login
## Mods
### Loaders
- [x] Fabric
- [x] Forge
- [x] Optifine
- [x] Quilt
- [ ] Neoforge
- [ ] OptiForge
- [ ] OptiFabric
- [ ] Jar Mods
### Sources
- [x] Modrinth mods
- [x] Curseforge mods (WIP)
- [ ] Modrinth modpacks
- [ ] Curseforge modpacks
### Features
- [x] Mod store
- [x] Mod presets
- [x] Mod updater
- [ ] Optimization for mod updater (it's super slow right now)
- [ ] UI/UX overhaul of preset system
## Instances
- [ ] Import MultiMC instance
- [ ] Migrate from other launchers (file locations)
- [ ] Package QuantumLauncher instance
## Platforms
- [x] Windows x86_64
- [x] Linux x86_64
- [x] Linux Aarch64 (WIP)
- [x] macOS (WIP)
- [ ] Windows i686 (WIP)
- [ ] Linux i686 (WIP)
- [ ] Windows Aarch64 (WIP)
- [ ] Android (distant future)
## Misc
- [x] Integration with Omniarchive, old version support
- [ ] A local server hosting system (without port forwarding, using proxy tunneling) (WIP)
# Contributing
There are many ways you can help me out! I'm open to any contribution:
## If you don't know how to code, you can:
- Find and report bugs or issues
- Give feedback about how this launcher could be improved
- Fix any typos or mistakes in anything (english isn't my first language)
- Most importantly, share this launcher with your friends!
## If you know how to code, you can:
- Well... write code. Add stuff. Don't worry about "quality"
or fancy terms like that. This ain't the linux kernel, I'm here with you!
- Write documentation. See a public function, module, struct, enum, whatever
that could help with some `///` doc comment? Go ahead!
- Contribute to the website (repo: )
- Work on CI (github actions)
There's a more in-depth guide on the codebase in [main.rs](quantum_launcher/src/main.rs) at the top.
## Contributors
- [Mrmayman](https://github.com/Mrmayman) (lead developer)
- [apicalshark](https://github.com/apicalshark) (github CI, packaging, distribution)
- Aurlt (@exsclt_35289 on Discord) (icon design)
# Licensing and Credits
A lot of this launcher's design, including the code for creating and launching the game,
and installing forge, is inspired by https://github.com/alexivkin/minecraft-launcher/.
Nearly all of this launcher is licensed under the **GNU General Public License v3**,
however there are a few exceptions (such as github actions and assets).
Visit [the assets README](assets/README.md) for more information.
# Note on Piracy
If you pirate the game, it's at your own risk. I am not responsible for any issues caused.
I recommend that you buy the game, but if you don't have the means, feel free to use this launcher.
If anyone has any issues/complaints, just open an issue in the repo.