ue5 · game · chuck · beta

UE5 standalone Shipping client forChuck RPG

The cooked, non-editor Shipping release of the Chuck RPG UE5 client — Win64, Linux, and Mac builds compiled from the external KBVE/chuck repo and shipped to itch.io as kbve/chuckrpg via the ci-unreal pipeline.

View source Build itch.io

Built from external KBVE/chuck

engine.external_repo_url makes the builder clone KBVE/chuck instead of using the monorepo shell; Content blobs come from the chuck Forgejo LFS endpoint. The version gate still lives in this monorepo.

Client — cooked Shipping, -cook -pak of main.
Server — bundled Linux chuckServerBeta for the Agones fleet.

UE 5.8.0Engine

ShippingClient config

Win/Linux/MacPlatforms

itch.ioShips to

Cooked Shipping build

The non-editor -cook -pak Shipping release of the main branch.

External chuck repo

Compiled from the external KBVE/chuck game repo with Content pulled from the chuck Forgejo LFS endpoint.

Bundled dedicated server

The chuckServerBeta target is cooked to the OWS PVC, where the chuckrpg-beta Agones fleet reads it.

itch.io distribution

Ships to itch.io kbve/chuckrpg, one channel per platform (windows / linux / macos).

Pipeline & CI

Build, distribution & release

Overview

Chuck RPG UE5 standalone game client — the cooked, non-editor Shipping release (-clientconfig=Shipping, -cook -pak) of the main branch. Compiled from the external game repo KBVE/chuck (default branch = main, .uproject under engine.project_path, Content pulled from the chuck Forgejo LFS endpoint) and shipped to itch.io under kbve/chuckrpg. The editor/Development counterpart is Unreal Chuck Dev.

Pipeline

pipeline: unreal_game → ci-main.yml dispatches ci-unreal.yml (task: game) → ci-unreal-build.yml (mode: game) whenever the MDX version: here outpaces version.toml, or source_path files change. engine.external_repo_url makes the builder clone KBVE/chuck (default branch) instead of using the monorepo shell; the version gate / version_toml tracker still lives in this monorepo.

Build Matrix

engine.build_targets:

Win64 — native build on the UE5-Win KubeVirt VM (RunUAT.bat)
Linux — BuildCookRun in the cached Epic UE Docker image on arc-runner-ue
Mac — native build on the [self-hosted, macOS, ARM64] runner (MacBook Air, registered directly with GitHub)

Plus the bundled Linux dedicated server (shell_path → task: server): the chuckServerBeta target (server_config: Shipping) is cooked from the monorepo shell and archived to the OWS PVC at /ows-server/chuckServerBeta/<version>, where the chuckrpg-beta Agones fleet reads it (subPath: chuckServerBeta). Same version gate as the client (1:1).

Distribution

Ships to itch.io kbve/chuckrpg, one channel per platform:

windows - Windows builds
linux - Linux builds
macos - macOS builds

Version tracking via butler’s --userversion parameter. Requires the butler_api secret.

Release

Bump version: above version.toml (apps/chuckrpg/unreal-chuck/version.toml), run npx nx run astro-kbve:sync:ci-manifest, commit. The next ci-main run fans out the game build + itch upload for this entry.

Source: external KBVE/chuck

Builds source from the external game repo KBVE/chuck (default branch). The builder clones it with the GitHub PAT, then materializes engine.project_path (chuck/ — the dir holding Chuck.uproject). Content blobs come from the chuck Forgejo LFS endpoint (git.kbve.com/KBVE/chuck.git); the repo’s own .lfsconfig points at the ssh:// Forgejo remote, which the builder normalizes to the authenticated HTTPS ingress route at build time.

When engine.external_repo_url is empty the builder falls back to the monorepo shell apps/chuckrpg/unreal-chuck (the lightweight plugin build/test loop in packages/unreal/). Closes #11828.

What is Unreal Chuck Beta?

It is the cooked, non-editor Shipping release of the Chuck RPG UE5 client, compiled from the external KBVE/chuck game repo and shipped to itch.io under kbve/chuckrpg. The editor/Development counterpart is Unreal Chuck Dev.

Which platforms does Unreal Chuck Beta build for?

It builds Win64 natively on the UE5-Win KubeVirt VM, Linux via BuildCookRun in the Epic UE Docker image on arc-runner-ue, and Mac natively on a self-hosted macOS ARM64 runner, plus a bundled Linux dedicated server for the chuckrpg-beta Agones fleet.

How is a new Unreal Chuck Beta release triggered?

Bump the MDX version above version.toml, run the astro-kbve sync:ci-manifest target, and commit. The next ci-main run fans out the game build and itch.io upload through the manifest-driven ci-unreal game pipeline.