Community documentation
CubicLauncher documentation
Everything you need to install, configure and get the most out of your Minecraft launcher. Browse the guides or search for a specific answer.
Getting started
Discover CubicLauncher, install it on your system and start playing.
- Introduction to CubicLauncher
What CubicLauncher is, what it can do and how to get started in a few minutes.
- Installation
Install CubicLauncher on Windows, Linux, macOS, Nix/NixOS and Docker. Follow the instructions for your operating system to get started.
- Installation on Arch Linux
CubicLauncher is available in the AUR (Arch User Repository). You can install it with your preferred AUR helper.
- Installing on Nix
CubicLauncher publishes packages for Linux x86_64 and ARM64. Nix downloads the binary from Cachix when available; otherwise it compiles locally.
- How do I use it?
Many people have asked us how to use our launcher, which is understandable since we have a quite unique interface. Here we will show you some basic things…
- Installing with Docker
Run CubicLauncher in a Docker container with X11 or Wayland, GPU, audio and persistent data. Multi-architecture image published on GitHub Packages.
Usage and configuration
Manage accounts, instances, Java and launcher settings.
- User accounts
Set up Microsoft, Ely.by, CubicAuth, custom Yggdrasil servers or offline accounts, and manage skins and capes.
- Instances
How to create, organize and manage isolated Minecraft instances, each with its own content, worlds, servers and configuration.
- What is Java?
What Java is, why Minecraft needs it, how CubicLauncher manages JREs, and how to configure memory and JVM arguments.
- Launcher configuration
Guide to all CubicLauncher Settings sections: storage, interface, notifications, Minecraft, downloads, console, Java and updates.
- Migrating from other launchers
Import profiles from the official launcher, MultiMC/Prism/PolyMC/Pinecone/Freesm instances or X Minecraft Launcher (XMCL) without losing your data.
- Servers and worlds
Manage your local worlds and server lists per instance. Check server status and connect quickly.
Mods and content
Expand Minecraft with mods, additional content and compatible clients.
- Content and Marketplace
Install mods, resource packs, shader packs and modpacks from Modrinth and CurseForge, and update your modpacks from the launcher.
- Mods
Manage Minecraft mods from the Market, with support for Modrinth, CurseForge and already installed mods.
- Install Dawn Client
How to install Dawn Client in CubicLauncher using the standalone Fabric mod for Minecraft 1.17 and above. Recommended version 1.20.1.
Customization
Change the launcher’s appearance and install or create your own themes.
- How to install a theme
Installing a theme in CubicLauncher is very simple. Just follow these 3 steps.
- Creating a theme
A step-by-step guide to creating a CubicLauncher theme from scratch — palette, background, typography, icons, custom CSS, packaging and publishing.
- Theme token reference
Complete list of CSS variables a CubicLauncher theme can override, with their purpose and default value, plus the available icon names.
Help and support
Diagnose errors, find solutions and get help.
- Launcher diagnostics
Resources for diagnosing CubicLauncher issues, collecting logs and troubleshooting NVIDIA and Wayland graphics on Linux.
- Diagnostics and logs
Use the integrated console, log history, sensitive-data cleaning and mclo.gs upload to diagnose issues.
- Linux graphics issues: NVIDIA and Wayland
Blank windows, flickering and CubicLauncher crashes with NVIDIA and Wayland. Using WEBKIT_DISABLE_COMPOSITING_MODE=1 and WebKitGTK alternatives.
- Official Support
Need help with CubicLauncher? We have several official channels where you can get assistance, report issues and receive help from both the community and the…
Development and contribution
Explore the project, set up your environment and contribute to CubicLauncher.
- Architecture
Overview of CubicLauncher architecture: Tauri v2, Rust backend, SvelteKit frontend, internal crates, events and on-disk data.
- Local development
Requirements, commands and workflow to build, test and contribute to CubicLauncher.
- Contributing
How to report issues, propose changes, send PRs and collaborate with translations in CubicLauncher.
- Versioning and releases
Sequential version scheme, update channels and the two-stage publishing process.
Legal information
Read the license, privacy policy and terms of use.
- License
Cubic Launcher Licenses
- Privacy Policy
CubicLauncher is a completely open source project for the community. This means anyone can review the source code, use it and contribute to its development.…
- Terms of Service
By using CubicLauncher, you agree to the following terms and conditions. This project is designed for the Minecraft community with a focus on transparency…