OneLauncher | OneClient

The monorepo containing the code for OneLauncher, OneClient, and their core backend.

OneClient is a Minecraft client featuring fully 100% open-source components, offering many packaged and pre-configured mods in one click. OneLauncher is a WIP Minecraft launcher giving power-users the greatest customization whilst featuring a clean UI.

Note

This is OneLauncher/OneClient v2 — a full rewrite in Rust using Freya. All previous web-based (React / Tauri) code has been removed.

Technologies Used

• Rust (edition 2024)
• Freya - native GUI framework for Rust

Contributing

We welcome contributions! Please read our contributing guidelines before getting started.

Requirements

The project targets Rust edition 2024, so a recent Rust toolchain is required.

• Install Rust via rustup
• Use a toolchain that supports edition 2024 (rustc 1.85+)

Building & Running

# Run the app
cargo run -p oneclient_app

# Build a release binary
cargo build --release -p oneclient_app

Packaging / Releasing

Installers are produced with cargo-packager (the standalone bundler spun out of the Tauri bundler). Config lives in packages/oneclient_app/Cargo.toml under [package.metadata.packager].

cargo install cargo-packager --locked

# Build the binary, then bundle it for the current OS:
cargo build --release -p oneclient_app
cargo packager --release -p oneclient_app --formats <targets>
#   Windows: nsis      macOS: app,dmg      Linux: deb,appimage

Versioning

The workspace shares a single version, defined in the root Cargo.toml under [workspace.package]. Current version: 2.0.0.

Project Structure

All crates live under packages/ in a single Cargo workspace.

• oneclient_app/ - The Freya desktop application (UI, routes, entry point).
• oneclient_core/ - Launcher core. Contains the entire launcher logic.
• oneclient_db/ - SQLx-based database layer.
• oneclient_macro/ - Macro definitions to simplify some code.
• polyio/ - PolyIO-rs. Shared IO utilities (archives, files, system helpers).

Code signing

This program uses free code signing provided by SignPath.io, and a certificate by the SignPath Foundation. We thank them very much to their contributions to OSS software!