Skip to content

Mrmayman/quantumlauncher

Repository files navigation

QuantumLauncher

GPL3 License Downloads Discord Online Made with iced

A minimalistic Minecraft launcher for Windows, macOS and Linux.

Quantum Launcher running a Minecraft Instance

QuantumLauncher offers a lightweight and responsive experience. It's 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/quantumlauncher.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.
  • Prism Launcher 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 ~/.local/share/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)

Core

  • Instance creation, deletion, renaming, launching
  • Java/Game args editing
  • Memory allocation editing
  • Optional Microsoft login
  • Integration with Omniarchive, old version support
  • Full controller, keyboard-navigation support in UI

Mods

Loaders

  • Fabric
  • Forge
  • Optifine
  • Quilt
  • Neoforge
  • OptiForge
  • OptiFabric
  • Jar Mods

Sources

  • Modrinth mods
  • Curseforge mods
  • Modrinth modpacks
  • Curseforge modpacks

Features

  • Mod store
  • Mod presets (packaging mods)
  • Mod updater
  • Make mod updater incrementally load in (optimization)
  • UI/UX overhaul of preset system
  • Category Filters in Mod store

Instances

  • Import MultiMC/PrismLauncher instances
  • Migrate from other launchers
  • Package QuantumLauncher instances (in progress by @sreehari425)
  • Upgrading instances to a newer Minecraft version

Servers (disabled in GUI but can be enabled)

  • Ability to create, delete and run Minecraft servers
  • Editing basic server settings (RAM, Java, Args)
  • Editing server.properties
  • Editing any NBT config file
  • Plugin store
  • playit.gg integration

Loaders

Platforms

(note: WIP means work-in-progress)

  • Windows x86_64

  • Linux x86_64

  • macOS x86_64 (WIP)

  • Windows Aarch64 (WIP)

  • Linux Aarch64 (Almost ready)

  • Linux ARM32 (WIP)

  • macOS Aarch64 (Almost ready)

  • Windows i686 (WIP)

  • Linux i686

  • FreeBSD (WIP)

  • Haiku

  • Solaris

  • Android (in the future)

Command-Line interface

  • List installed instances list-instances, -l
  • List versions available for download list-available-versions, -a
  • Create instance from CLI
  • Launch instance from CLI
  • Install loaders from CLI
  • Mod installation features from CLI
  • Preset, modpack features from CLI

MSRV (Minimum Supported Rust Version)

The MSRV is Rust 1.82.0. Any deviation from this is considered a bug, please report if found.

Contributing/Contributors

For more info, see CONTRIBUTING.md

Testing

For more info, see tests/README.md

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 for more information.

Notes

If you play the game in offline mode, 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 as a last resort. If anyone has any issues/complaints, just open an issue in the repo.