Quickstarts

Overview

Quickstarts are the short form of each task: the prerequisites, the commands, and the check that it worked. The matching user guide covers the same task in full. A machine that has never run The Test Cabinet starts with First Time Setup.

Setup

• Set Up Authentication supplies the provider credentials a run’s harness needs.
• Register and Log In creates an account, so launching, reviewing, and publishing are attributed to you.

Development

• Run a Test Case launches one case variant through a harness and watches it finish.
• Run the Local Service Stack brings up the backend, auth, dispatcher, and artifact services on local k3d.
• Review a Run submits a review for a produced run.

Authoring end-to-end and full-stack cases

• End-to-end case scaffolds a playable-game case or version under test-cases/.
• End-to-end variant adds a playable mode to an existing end-to-end version.
• Full-stack case scaffolds a case whose run produces the game and its own assets.

Authoring 2D asset-generation cases

• Sprite case scaffolds a sprite (draw) or sprite-sheet (draw-sheet) case or version.
• Single-sprite variant adds a brief variation to a single-sprite version.
• Sprite-sheet variant adds a brief variation to a sprite-sheet version.
• UI case paints a high-resolution interface asset with the paint and ui binaries.
• Material case authors a tileable PBR material with texture and pbr.

Authoring 3D asset-generation cases

• Voxel model case sculpts a static cube-voxel model with the voxel binary.
• Voxel model variant adds a brief variation to a static voxel-model version.
• Voxel animation case sculpts a rigged voxel model and authors its required animations.
• Voxel animation variant adds a brief variation to a rigged voxel version.
• Mesh model case sculpts a static meshed SDF model with mc, sn, or dc.
• Mesh model variant adds a brief variation to a static meshed version.
• Mesh animation case sculpts and rigs an animated meshed model with declared required animations.
• Mesh animation variant adds a brief variation to a rigged meshed version.
• Skinned character case sculpts one continuous deforming skin on a model-invented skeleton.
• Blender character case builds a rigged, skinned character in headless Blender via build.py and tcab-blend.

Authoring effects and audio cases

• Particle case authors an emitter system simulated live against a brief.
• Audio case authors a short clip through the matching audio binary.
• Audio sample pack builds a pack from its manifest, uploads it to R2, and pins it for the run image.

DevOps

• Add or Update a Model curates a model in the app.
• Probe a Model checks a model’s responses-as-code readiness before spending gg runs on it.
• Publish a Run reviews a produced run and publishes it to the gallery.
• Publish a Reference deploys a case variant’s reference implementation and records it.
• Publish Errata records a known issue with a shipped version without a version bump.
• Roll Production Service Images promotes CI-built service images to the prod cluster.
• Cut a Release ships vX.Y.Z: prepare the release, rehearse it on staging, publish the artifacts, then land the catalog and the services in prod.