Skip to content

Repository files navigation

Repository Banner

OneClient | OneLauncher

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.

Installing

You can install the latest release of OneClient from our website: https://polyfrost.org/projects/oneclient as well as our GitHub releases.

Windows (x86_64) macOS (Intel & Apple Silicon) Linux (x86_64)
Installer 🔄 DMG 🔄 AppImage 🔄
App Bundle 🔄 DEB
RPM
AUR

🔄 = Has support for autoupdating built-in

Contributing

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

Requirements

The project targets Rust 1.97 or later. You can install Rust via rustup.

Building & Running

# Run the app
cargo run -p oneclient_app

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

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].

Versions and release notes come from Knope change files in .changeset/. Add one per user-facing change with knope document-change (installed via cargo install knope). The OneClient Release Build workflow consumes them, bumps the version, writes CHANGELOG.md, and uses the new entry as the GitHub release body, which is what the launcher's changelog page shows.

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!

About

Monorepo containing OneLauncher, OneClient, and their core backend. 100% Rust.

Topics

Resources

Code of conduct

Contributing

Stars

139 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages