shellcade-kit

Documentation

Overview

Command shellcade-kit is the shellcade game developer kit (PROTOTYPE):

shellcade-kit version                              print kit/ABI compatibility info
shellcade-kit new   [--rust] [--license ID] <name> scaffold a complete, catalog-submittable kit game
shellcade-kit check <gamedir|game.wasm>            run the conformance harness (limits ON) + print a report
shellcade-kit play  <gamedir|game.wasm> [flags]    play the game in a local 80x24 terminal room
shellcade-kit smoke <gamedir|game.wasm>            run the game's smoke.yaml and write the shot files

check/play/smoke accept either a built .wasm or the game directory — a directory is built first (TinyGo for go.mod, cargo wasm32-wasip1 for Cargo.toml), so `shellcade-kit play .` is the whole inner loop for any source language.

play flags:

--seed N            seed the room RNG (reproducible runs)
--heartbeat DUR     wake cadence (default 50ms)
--config KEY=VALUE  inject a per-game config value (repeatable; value may be @file)
--players N         scripted extra players that join alongside you (default 0)