diff --git a/.gitignore b/.gitignore index 28415a6..6fbe2cb 100644 --- a/.gitignore +++ b/.gitignore @@ -9,6 +9,7 @@ obj/ *.bin *.dsk *.DSK +!/CAPITAL.DSK .DS_Store *.vccgrant *connection*.json diff --git a/CAPITAL.DSK b/CAPITAL.DSK new file mode 100644 index 0000000..fbe287d Binary files /dev/null and b/CAPITAL.DSK differ diff --git a/README.md b/README.md index 634806a..ed7fbba 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,12 @@ The application was generated with **ChatGPT Codex** using **GPT-6.1 Sol High**, following the project brief in [CHATGPT_PROMPT.md](CHATGPT_PROMPT.md). Development included builds and gameplay tests through VCC Plus’s public MCP interface. +## Download + +Download the ready-to-run [CAPITAL.DSK](CAPITAL.DSK) included at the repository +root. Mount a copy in VCC Plus with a **512 KB CoCo 3 / 6809 Disk BASIC** setup, +then type **DOS**, or `LOADM"CAPITAL.BIN":EXEC`. + ## Build and play 1. In VCC Plus, choose **Develop → C Development → Open**, and select this folder. @@ -69,8 +75,9 @@ The editable inputs are `data/states.tsv`, `data/map-seeds.json`, `assets/usa-source.svg`, `main.c`, `src/quiz.c`, `src/ui.c` and the root-level `quiz.h`, `ui.h` and `map_data.h` headers. Keeping project headers beside `main.c` also makes them available to VCC Plus's isolated build snapshots. Generated drawing -and state C files are retained for toolchain-only builds. Build outputs are -ignored. The public MCP JSON-RPC client in `tools/vcc_mcp.py` takes an exported +and state C files are retained for toolchain-only builds. Generated build outputs +are ignored; the root-level `CAPITAL.DSK` is the checked-in playable release. +The public MCP JSON-RPC client in `tools/vcc_mcp.py` takes an exported private grant path; keep that grant outside Git. See [test evidence](docs/TESTING.md) for baseline emulator coverage, [feedback tests](docs/FEEDBACK_TESTING.md) for the sound and automatic-advance checks, and [credits](assets/CREDITS.md) @@ -88,3 +95,19 @@ This builds the advertised Test configuration, plays two complete quizzes with ordinary physical keys, checks actual framebuffer text and state fill pixels, and retains the test disks. Evidence stays outside the checkout until tests finish so VCC Plus's watched source revision remains stable. + +## Sample screens + +Screenshots of Capital Quest running in VCC Plus. + +### Title and mode selection + +![Title screen with a U.S. map and choices for multiple-choice or typed answers](docs/images/title.png) + +### Multiple choice + +![Multiple-choice question asking for Ohio's capital, with Ohio highlighted on the map](docs/images/multiple-choice.png) + +### Results + +![Results screen showing 47 out of 50 correct answers and a score of 94 percent](docs/images/results.png) diff --git a/docs/images/multiple-choice.png b/docs/images/multiple-choice.png new file mode 100644 index 0000000..13ce512 Binary files /dev/null and b/docs/images/multiple-choice.png differ diff --git a/docs/images/results.png b/docs/images/results.png new file mode 100644 index 0000000..902df39 Binary files /dev/null and b/docs/images/results.png differ diff --git a/docs/images/title.png b/docs/images/title.png new file mode 100644 index 0000000..4fe431f Binary files /dev/null and b/docs/images/title.png differ