5.8 KiB
Capital Quest for CoCo
A map-based geography quiz about all 50 United States and their capitals, designed by Brian Holman with assistance from ChatGPT/Codex. Play with four capital choices or type each answer. Review the states you missed when the journey ends.
Play
Use a Color Computer 3 with 512 KB or more, BASIC, an FD-502 Disk BASIC controller, and a keyboard. RGB is the tested display presentation. MC6809 and HD6309 have been tested in VCC Plus; this is not physical-hardware qualification. The two graphics pages reserve 64 KB outside a 128 KB machine's RAM, so this edition requires 512 KB even though it does not use all installed memory.
Download CAPITAL.DSK, preserve your existing guest work, insert a
copy into FD0, and Cold Restart. At the Disk BASIC OK prompt, type DOS
and press Enter. Alternatively use LOADM"CAPITAL.BIN":EXEC. The game does not
write to its disk, and a write-protected copy is suitable for play.
Read the complete player manual for every screen, control and answer rule. The online guide is the shared reading edition.
- Title: 1 multiple choice, 2 typed answers, C credits, Q quit.
- Multiple choice: 1–4. The correct slot is random, excluding the previous question's correct slot. The first question may use any slot. Feedback advances automatically after its tones and reading pause.
- Typed answers: letters, spaces and periods; Backspace edits and Enter submits. Case and extra spaces do not matter. Saint Paul, St Paul and St. Paul are accepted. A close spelling offers R to retry or V to reveal. Esc/CoCo Break reveals while editing. Space advances after feedback.
- Map: teal unanswered, purple correct, red incorrect, yellow current. Northeast and Hawaii details use the same colors.
- Results: R review, N next review page, B back to results, P play again, Q quit to BASIC. Release keys between presses. Scores and progress are not saved; a new quiz clears them.
Build your own copy in VCC Plus
- Download/extract the source project or clone this repository into a new, writable folder. Preserve a clean disk and any source changes you already have.
- In VCC Plus, choose Develop → C Development…, then open the folder that
contains
Makefile,main.candvccplus-project.json. - Select Release, then Build. The declared target builds the disk.
- Use Show Build Products to find
build/CAPITAL.dskandbuild/CAPITAL.binin that build's snapshot. Mount a copy with the setup above and runDOS.
The project uses VCC Plus's bundled CMOC 0.1.100, LWTools 4.25, Make, Perl and libraries. Ordinary game builds need no Xcode, Command Line Tools, Homebrew or system Perl. Generated map/state C files are included. Opening source does not build or run it automatically. Read provenance and notices before redistributing modifications.
An equivalent command-line build uses the installed app's tools:
export PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:$PATH"
make VCC_CONFIGURATION=Release disk
Release uses -O2; Debug retains frame pointers with -O2 to fit the same
memory budget. Test uses -O2 and seed 2709. Clean before switching
configurations in one working folder because the Makefile shares obj/:
make clean
make VCC_CONFIGURATION=Test disk
Code/static data are linked at $2000, below $7800, with a separate 2 KB stack
allowance below $8000. Graphics use the public GIME library's two reserved
physical pages at $40000–$4FFFF.
Editable inputs and optional tests
main.c, src/quiz.c and src/ui.c implement play. data/states.tsv,
data/map-seeds.json and assets/usa-source.svg are the editable data/artwork
inputs. src/states.c and src/map_data.c are generated and retained. Root-level
headers remain available to isolated C-workspace builds.
Python 3 is required only for optional asset regeneration and test scripts:
python3 tools/prepare_assets.py
make test
make test additionally needs a host C compiler. It checks state shuffles,
unique choices, nonrepeating correct slots, matching, scoring, reset and geometry.
These extra prerequisites do not apply to an ordinary in-app disk build.
For assistant-assisted development, review Assistant… → Files shared, enable
Use Project Makefile and Allow Disposable Playtests where appropriate,
and export a fresh private connection outside the project. Discover the actual
advertised tools and project revision before building. Private grants, tokens,
ROMs and personal media never belong in a source download. The optional
tests/playtest.py PRIVATE_GRANT --evidence /outside/project/evidence driver
uses the supported public MCP interface and keeps full captures outside the
watched source folder.
License, credits and development history
Game source is GPL-3.0-or-later; see LICENSE. The adapted map remains © Fla-shop.com, CC BY 4.0. Pierre Sarrazin's font and disk boot helper retain their public-domain notices. Linked compiler/runtime libraries retain their component terms. Preserve assets/CREDITS.md, the component notices, and the corresponding-source information in docs/PROVENANCE.md.
The original development brief is historical project evidence,
not instructions to overwrite a downloaded project. Dated records in docs/
describe their named milestones; older tool limitations are not current app
compatibility claims. The player manual describes the delivered game.
