Skip to content

Unreal Chuck Beta

Overview

Section titled “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

Section titled “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

Section titled “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 is stubbed until the macos-builder VM is provisioned.

Distribution

Section titled “Distribution”

Ships to itch.io kbve/chuckrpg, one channel per platform (win64-v<version>, linux-v<version>). Requires the butler_api secret.

Release

Section titled “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

Section titled “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.