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.

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
*RPM (COPR) 🔄
AUR

🔄 = Has support for autoupdating built-in

COPR Installation

On supported distributions (RHEL, Fedora, Bazzite etc.), you can make use of the Fedora COPR instead of using the AppImage or manually installing the RPM file.

  1. First you have to enable the repository:
sudo dnf copr enable polyfrost/OneClient
  1. Then you can install the package:
sudo dnf install oneclient-bin

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!

Releases

Packages

Used by

Contributors

Languages