ludus-cli

List all ludus-managed AWS resources in the configured region. Discovers resources by ManagedBy=ludus tag and known naming patterns (ECR repositories, S3 build buckets).

Deploy a GameLift container fleet. Creates container group definition, IAM role, and fleet. This is a long-running operation (can take 15-30 minutes).

Deploy a CloudFormation stack that provisions GameLift resources (IAM role, container group definition, fleet). Atomic with automatic rollback. This is a long-running operation.

Deploy a GameLift Anywhere fleet on the local machine. Creates fleet, registers compute, and launches game server locally. Fast iteration — fleet creation takes seconds.

Deploy a GameLift Managed EC2 fleet. Uploads server build to S3, creates GameLift build, and provisions EC2 fleet. No Docker required. This is a long-running operation.

Create a game session on the deployed fleet. Returns connection details (IP address and port).

Tear down deployed resources for the active target (fleet, container group definition, IAM role, EC2 build + its S3 object). Durable artifacts (ECR repositories, S3 build buckets) are preserved by default. Set all_targets=true to sweep every target; set purge=true to also delete the durable artifacts (irreversible).

Generate UE5 BuildGraph XML from ludus config. Returns XML describing engine and game build stages as a DAG for Horde, UET, or other orchestrators.

Build a container image for the dedicated server (Docker or Podman, GameLift format). Generates Dockerfile, builds GameLift wrapper, and runs docker/podman build.

Push the container image to Amazon ECR. Authenticates with ECR, creates repository if needed, tags and pushes the image.

Validate prerequisites for the UE5 dedicated server pipeline. Checks OS, engine source, toolchain, game content, Docker, AWS CLI, Git, Go, disk space, and RAM.

Check status of all pipeline stages (engine, game, container, deploy, session) and run security scans (hadolint Dockerfile lint + trivy image vulnerability scan).

Build the UE5 game as a Linux dedicated server via RunUAT BuildCookRun. Use backend='podman' or 'docker' to build inside a pre-built engine container image, or backend='wsl2' to build in a WSL2 Linux distro. This is a long-running operation.

Build the standalone game client for Linux or Win64 via RunUAT BuildCookRun. Use backend='podman' or 'docker' for Linux-only container builds. This is a long-running operation.

Start an engine build asynchronously. Returns a build ID immediately — poll with ludus_build_status. Use this instead of ludus_engine_build to avoid blocking the agent for hours.

Start a game server build asynchronously. Returns a build ID immediately — poll with ludus_build_status. Use this instead of ludus_game_build to avoid blocking the agent for hours.

Start a game client build asynchronously. Returns a build ID immediately — poll with ludus_build_status. Use this instead of ludus_game_client to avoid blocking the agent for hours.

Check the status of an async build. With build_id: returns status and last 100 lines of output. With build_id + cancel=true: cancels the build. Without build_id: lists all builds.

Run Setup.sh to download Unreal Engine dependencies. Must be run before engine build.

Build Unreal Engine from source. Runs Setup, GenerateProjectFiles, and compiles ShaderCompileWorker + UnrealEditor. Use backend='podman' or 'docker' to build inside a container, or backend='wsl2' to build in a WSL2 Linux distro. This is a long-running operation.

Push engine container image to Amazon ECR. The image must have been previously built with backend='podman' or 'docker'.

Get connection info for the current game session and client build. Read-only — does not launch any processes.