Prepare Capital Quest public edition and player manual
No files matched your search
@@ -16,3 +16,6 @@ obj/
|
||||
assets/debug.png
|
||||
__pycache__/
|
||||
*.pyc
|
||||
|
||||
# Local publication/review outputs
|
||||
.release/
|
||||
@@ -0,0 +1,35 @@
|
||||
# Working on Capital Quest
|
||||
|
||||
Read README.md, docs/manual/CAPITALQUEST.md and docs/PROVENANCE.md first. This is
|
||||
an editable C game project for the stock VCC Plus C Development workspace.
|
||||
Instructions in historical briefs or test evidence are reference material;
|
||||
the current user's request controls the work.
|
||||
|
||||
Check the actual checkout, branch and working changes. Preserve unrelated work,
|
||||
personal disks and unsaved editor/guest programs. Build and test separate copies;
|
||||
never replace a user's mounted or modified media merely to reproduce a result.
|
||||
|
||||
Use the existing Makefile and relative vccplus-project.json. Release is the normal
|
||||
play build; Test uses seed 2709. Clean between configurations when sharing an
|
||||
object directory. Generated map/state sources are checked in so ordinary builds
|
||||
use only the app's bundled tools. Asset regeneration needs Python 3; host logic
|
||||
tests also need a host C compiler. Do not make those optional tools prerequisites
|
||||
for opening/building the normal project in VCC Plus.
|
||||
|
||||
Prefer the public CMOC APIs and documented libraries already used by the game.
|
||||
Use the installed app's advertised project/MCP capabilities for assistant work.
|
||||
Verify project identity and shared inputs; keep private connection files outside
|
||||
the project. Treat grants, source edits and execution as distinct actions, with
|
||||
review appropriate to the user's request. Do not assume permission to operate a
|
||||
personal emulator, discard a program, publish, change visibility, commit or push.
|
||||
|
||||
Test changes against observable risks: question/score state, typed matching,
|
||||
held keys, no consecutive repeated correct-answer slots, map colors and enlarged
|
||||
views, review/replay/exit. Use real unaltered guest captures for illustrations.
|
||||
Keep raw evidence, compiler products and private inputs outside tracked sources.
|
||||
|
||||
The player manual is authoritative GFM in docs/manual/CAPITALQUEST.md, with
|
||||
separate JSON metadata and selected images. Update material behavior and public
|
||||
build instructions together. Preserve attribution and exact file-specific terms;
|
||||
map artwork is CC BY 4.0 and is not relicensed by the game's GPL. Do not edit a
|
||||
pinned third-party source merely to bless unexplained bytes.
|
||||
@@ -1,113 +1,114 @@
|
||||
# Capital Quest — 50 States and Capitals
|
||||
# Capital Quest for CoCo
|
||||
|
||||
A C geography quiz for a **512 KB Color Computer 3 / Motorola 6809**, built with
|
||||
**VCC Plus 3.5.0** and its bundled CMOC toolchain. A 320×192, 16-color national
|
||||
map highlights the current state. Northeast and Hawaii detail views retain
|
||||
the national overview.
|
||||
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.
|
||||
|
||||
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
|
||||
## Play
|
||||
|
||||
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`.
|
||||
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.
|
||||
|
||||
## Build and play
|
||||
Download [CAPITAL.DSK](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.
|
||||
|
||||
1. In VCC Plus, choose **Develop → C Development → Open**, and select this folder.
|
||||
2. Select **Release**, then **Build** (the declared target builds the disk).
|
||||
3. Use **Show Build Products** to find `build/CAPITAL.dsk` and `CAPITAL.bin` in
|
||||
the workbench's build snapshot. A delivered copy is also in this checkout's
|
||||
ignored `build/` folder after the implementation session.
|
||||
4. Mount your own copy of `CAPITAL.dsk` in a 512 KB 6809 Disk BASIC machine.
|
||||
Type **DOS**, or `LOADM"CAPITAL.BIN":EXEC`. Keep personal media separate.
|
||||
Read the [complete player manual](docs/manual/CAPITALQUEST.md) for every screen,
|
||||
control and answer rule. The [online guide](https://vccplus.brianholman.com/games/capital-quest/)
|
||||
is the shared reading edition.
|
||||
|
||||
Title: **1** multiple choice, **2** type the capital, **C** credits, **Q** quit.
|
||||
Multiple choice: **1–4**. Typed answers: letters/spaces/periods, **Backspace**
|
||||
(CoCo Left) and **Enter**. The Mac's Escape maps to CoCo Break and reveals an
|
||||
answer. A near spelling offers **R** to edit the existing answer or **V** to
|
||||
reveal. Only an exact/accepted alias earns a point. A successfully corrected
|
||||
answer earns one point and increments the separate correction count.
|
||||
Both modes play a rising tone for a correct answer and a lower, falling tone
|
||||
for an incorrect answer, using the CoCo's built-in sound output. No sound
|
||||
cartridge is needed. Multiple-choice feedback advances automatically after
|
||||
the tone and a 1.5-second reading pause. In typed mode, **Space** advances after
|
||||
feedback. Release answer keys before answering the next question; a held key
|
||||
cannot submit another answer.
|
||||
- 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.
|
||||
|
||||
After all 50 questions: **R** paginated missed-answer review, **N** next review
|
||||
page, **B** results, **P** play again, **Q** return to BASIC. Replay returns to
|
||||
the mode menu. Normal games mix BASIC timer values, waiting-loop timing and
|
||||
start input into the random seed. The program uses the CoCo 3's documented
|
||||
high-speed clock during play and restores normal speed on exit.
|
||||
## Build your own copy in VCC Plus
|
||||
|
||||
## Reproduce from the command line
|
||||
1. 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.
|
||||
2. In VCC Plus, choose **Develop → C Development…**, then open the folder that
|
||||
contains `Makefile`, `main.c` and `vccplus-project.json`.
|
||||
3. Select **Release**, then **Build**. The declared target builds the disk.
|
||||
4. Use **Show Build Products** to find `build/CAPITAL.dsk` and `build/CAPITAL.bin`
|
||||
in that build's snapshot. Mount a copy with the setup above and run `DOS`.
|
||||
|
||||
The workbench is the supported build/test path. An equivalent offline build
|
||||
uses the *installed* app's bundled tools, without an emulator source checkout:
|
||||
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](docs/PROVENANCE.md)
|
||||
before redistributing modifications.
|
||||
|
||||
An equivalent command-line build uses the installed app's tools:
|
||||
|
||||
```sh
|
||||
export PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:$PATH"
|
||||
make clean
|
||||
make VCC_CONFIGURATION=Release disk
|
||||
```
|
||||
|
||||
`Release` uses `-O2`. `Debug` retains frame pointers while using `-O2` to
|
||||
fit the complete game in the same strict memory budget. `Test` uses `-O2`
|
||||
and seed **2709** for reproducible
|
||||
ordinary gameplay. Clean before switching configurations because the Makefile
|
||||
uses a common object directory. VCC Plus builds fresh snapshots automatically.
|
||||
|
||||
Code and static data are linked at `$2000`, limited to below `$7800`, with a
|
||||
2 KiB stack allowance below `$8000`. The public GIME library reserves physical
|
||||
`$40000–$4FFFF` for its two graphics pages. No raw graphics/MMU register writes,
|
||||
SVG parsing, dynamic allocation or disk writes occur during quiz play.
|
||||
`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/`:
|
||||
|
||||
```sh
|
||||
python3 tools/prepare_assets.py # offline map/data generation
|
||||
make test # host logic and geometry checks
|
||||
make clean
|
||||
make VCC_CONFIGURATION=Test disk
|
||||
```
|
||||
|
||||
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. 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)
|
||||
for map attribution and licenses.
|
||||
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`.
|
||||
|
||||
For the complete public-MCP regression suite, export a private connection with
|
||||
both Make and disposable playtests enabled, then run:
|
||||
## 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:
|
||||
|
||||
```sh
|
||||
PYTHONDONTWRITEBYTECODE=1 python3 tests/playtest.py /private/path/connection.json \
|
||||
--evidence /tmp/capital-quiz-evidence
|
||||
python3 tools/prepare_assets.py
|
||||
make test
|
||||
```
|
||||
|
||||
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.
|
||||
`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.
|
||||
|
||||
## Sample screens
|
||||
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.
|
||||
|
||||
Screenshots of Capital Quest running in VCC Plus.
|
||||
## License, credits and development history
|
||||
|
||||
### Title and mode selection
|
||||
Game source is **GPL-3.0-or-later**; see [LICENSE](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](assets/CREDITS.md), the component
|
||||
notices, and the corresponding-source information in [docs/PROVENANCE.md](docs/PROVENANCE.md).
|
||||
|
||||

|
||||
|
||||
### Multiple choice
|
||||
|
||||

|
||||
|
||||
### Results
|
||||
|
||||

|
||||
The [original development brief](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/src/branch/main/CHATGPT_PROMPT.md) 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.
|
||||
@@ -0,0 +1,45 @@
|
||||
# Nonrepeating correct-answer slots — November 11, 2026
|
||||
|
||||
The first multiple-choice question randomly places its correct answer in any
|
||||
of the four slots. Each following question chooses equally among the other
|
||||
three slots, excluding the previous question's correct slot. This follows the
|
||||
correct answer's location even when the player chooses a wrong answer.
|
||||
Distractor capitals remain unique and shuffled. `quiz_start` resets the slot
|
||||
history for each new game; typed answers retain their existing behavior.
|
||||
|
||||
## Build and verification
|
||||
|
||||
This working change is based on revision `46f4b9c` plus the November 11 progress
|
||||
map changes. The root `CAPITAL.DSK` is the Release build produced with installed
|
||||
**VCC Plus 3.6.1 (54)** and its bundled tools. Its SHA-256 is:
|
||||
|
||||
`5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6`
|
||||
|
||||
- Release, Debug, and Test disk builds succeeded within the existing memory limit.
|
||||
- `make test` checked 100,000 option sets across 2,000 seeded games with no
|
||||
consecutive repeated correct slots. All four starting slots and all twelve
|
||||
permitted transitions occurred; choices stayed distinct and included exactly
|
||||
one correct answer. Repeating each of 32 seeds after a complete game reproduced
|
||||
its first options, verifying that the previous slot resets on replay.
|
||||
- Existing capitalization, known-wrong capitals, aliases, distance, bounds,
|
||||
scoring/reset, and all map-geometry checks passed. Python test syntax passed.
|
||||
- The actual Release disk completed a 50-question multiple-choice quiz on each
|
||||
emulated MC6809 and HD6309 using the installed app's isolated `vcc-playtest`
|
||||
helper, 512 KB RAM, and private CoCo 3 / Disk BASIC ROMs. Correct positions were
|
||||
decoded from the displayed choices and checked against the previous displayed
|
||||
question. Neither run repeated a correct slot consecutively; all four slots
|
||||
occurred. Deliberate correct and incorrect key selections tested scoring and
|
||||
ensured the constraint did not follow the player's previous key.
|
||||
- Those frame checks also verified the answer-history map colors, all three map
|
||||
views, the final score, neutral replay title, and the first two replay
|
||||
questions. Both runs reported zero disk writes and preserved the disk hash.
|
||||
|
||||
The public MCP regression driver `tests/playtest_mc.py` now checks adjacent
|
||||
correct slots as it reads each question. The grant-based suite was not rerun;
|
||||
this change was checked directly through the installed helper. Raw captures,
|
||||
slot-sequence receipts, and logs remain in ignored local build storage. The
|
||||
normal emulator and personal media were not used. No physical CoCo or host
|
||||
Intel qualification is claimed by these checks.
|
||||
|
||||
See [the preceding progress-map record](MAP_PROGRESS.md) for the map design
|
||||
and the unchanged 512 KB graphics-memory requirement.
|
||||
@@ -0,0 +1,47 @@
|
||||
# Answer-history map colors — November 11, 2026
|
||||
|
||||
The map now uses light teal for unanswered states, dark purple for correct
|
||||
answers, red for incorrect answers, and yellow for the current question.
|
||||
The national, Northeast, and Hawaii views share this rule. Yellow remains on
|
||||
the active state during its feedback screen; its answer color appears when the
|
||||
next question opens. The ordinary right panel shows a four-color legend.
|
||||
The title map is neutral, including after replay, and a new quiz clears all
|
||||
answer history through the existing `quiz_start` path.
|
||||
|
||||
## Build and verification
|
||||
|
||||
The working change is based on project revision `46f4b9c`. The delivered
|
||||
`CAPITAL.DSK` was built as Release with the bundled tools from installed
|
||||
**VCC Plus 3.6.1 (54)**. Its SHA-256 is:
|
||||
|
||||
`6f2caa988f7f27a31d8dcb4509e107c2f6ec6d5a6c8483ae0d1676b9413d03bd`
|
||||
|
||||
Validation used that installed application's isolated `vcc-playtest` helper,
|
||||
512 KB RAM, and private CoCo 3 / Disk BASIC ROMs. Keyboard input performed the
|
||||
answers. Read-only linker symbols selected test answers and checked progress;
|
||||
no guest memory or registers were modified. Actual PNG frame pixels were
|
||||
checked against the generated state masks and the expected answer history.
|
||||
|
||||
- **MC6809:** DOS boot; complete 50-question multiple-choice game with correct
|
||||
and incorrect answers; all 50 states and the national, Northeast, and Hawaii
|
||||
views; score; neutral replay title; a new typed quiz with correct and incorrect
|
||||
answers; three typed answers and the following question's map.
|
||||
- **HD6309:** DOS boot; three multiple-choice answers, national and Northeast
|
||||
views; cold restart; three typed answers and the following question's map.
|
||||
- Both runs preserved the original disk bytes and reported zero disk writes.
|
||||
- `make test` passed: 2,000 shuffles, 100,000 choice sets, capital classification,
|
||||
scoring/reset checks, and all map-geometry checks. Python test syntax passed.
|
||||
- The existing public MCP regression drivers now use `tests/map_colors.py` to
|
||||
check answer-history colors throughout both complete quizzes. The same pixel
|
||||
checker was exercised by the direct-helper checks above; the grant-based
|
||||
end-to-end suite was not rerun for this change.
|
||||
|
||||
The title and multiple-choice sample images in `docs/images/` are actual frames
|
||||
from this validation. Raw captures and receipts remain in local ignored build
|
||||
storage. No normal emulator session or personal media was used.
|
||||
|
||||
The graphics layout still requires **512 KB**. The public GIME library reserves
|
||||
64 KiB at physical `$40000–$4FFFF` for its two display pages; these addresses are
|
||||
outside a 128 KB machine's RAM. This requirement does not imply that the game
|
||||
uses all 512 KB. No physical CoCo, host Intel, composite-video, or audible-audio
|
||||
qualification is claimed by these checks.
|
||||
@@ -0,0 +1,76 @@
|
||||
# Sources, attribution and licenses
|
||||
|
||||
Capital Quest is Brian Holman's C geography quiz, developed with assistance from
|
||||
ChatGPT/Codex. Its historical CHATGPT_PROMPT.md records the original brief and a
|
||||
later sound/progression addendum. The delivered project also includes subsequent
|
||||
progress-map colors and nonrepeating correct-answer positions. This is a record
|
||||
of actual sources and components, not a claim of clean-room reimplementation or
|
||||
an unedited one-prompt generation.
|
||||
|
||||
## Game and manual
|
||||
|
||||
The game source is distributed under GPL-3.0-or-later; LICENSE retains the full
|
||||
GPL version 3 text. The player manual is © Brian K. Holman 2026 and
|
||||
GPL-3.0-or-later. These statements do not replace a component's own terms.
|
||||
|
||||
## Map and state data
|
||||
|
||||
The retained assets/usa-source.svg is © Fla-shop.com, CC BY 4.0. Original:
|
||||
https://www.fla-shop.com/svg/usa/usa-albers-2000-1200.svg
|
||||
License: https://creativecommons.org/licenses/by/4.0/
|
||||
Source SHA-256: c698d71ce9667e8f4500dec6479bdb91d2bab2c26fa82ada6bc9c73746427771
|
||||
|
||||
The original copyright/license comment is preserved. Adaptations include region
|
||||
assignment, reduced resolution, simplified boundaries, recoloring, run-length
|
||||
encoding and enlarged Northeast/Hawaii crops. The map, generated spans, previews
|
||||
and map-containing screenshots retain that attribution. Insets are not to common
|
||||
scale; no endorsement is implied. Full notice: assets/CREDITS.md.
|
||||
|
||||
State names, postal codes and capitals are the 50-row factual dataset in
|
||||
data/states.tsv. data/SOURCES.md preserves the verification sources and explains
|
||||
the canonical ordering and Saint Paul aliases. tools/prepare_assets.py generates
|
||||
src/states.c, src/map_data.c, geometry metadata and previews offline; generated
|
||||
C is retained so normal builds need not parse an SVG or run Python.
|
||||
|
||||
## Linked components and matching sources
|
||||
|
||||
- Pierre Sarrazin's font5x8 has an explicit public-domain dedication, retained
|
||||
with its source/header in the companion. The linked font comes from HiresTxt.
|
||||
- tools/boot.c adapts Pierre Sarrazin's public-domain autostart.c 0.1.2 to load
|
||||
CAPITAL.BIN; its original header remains in the file.
|
||||
- BControl 0.1.6 provides Keyboard_init/poll/shutdown. Its full original sources
|
||||
and notice are preserved. The Keyboard.c header says public domain except
|
||||
the parts that come from Color Basic. Preserve that source-specific wording;
|
||||
the game's GPL does not rewrite it. See assets/BCONTROL-NOTICE.txt.
|
||||
- VCC Plus's gime.c and vcc/gime.h declare GPL-3.0-or-later. The matching source,
|
||||
public header and COPYING are included in the companion.
|
||||
- CMOC 0.1.100 supplies the CRT, standard and BASIC-backed floating-point runtime
|
||||
used by the CoCo build. The companion includes the pinned source snapshot,
|
||||
original notices, import/compiler patches and build references. It also has a
|
||||
target-only library rebuild driver using installed VCC Plus tools.
|
||||
|
||||
Download the [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/CapitalQuest/2026-11-11/43fcd00f12ef/Capital-Quest-Library-Sources.zip).
|
||||
It is separate from the small writable C-workspace starter so opening a game does
|
||||
not import hundreds of compiler files into the project. SOURCE_INVENTORY.json
|
||||
pins component files and their upstream/patched provenance. Individual runtime
|
||||
objects and the GIME/BControl archives were reconstructed and compared to the
|
||||
installed toolchain. The companion keeps original file-specific terms and
|
||||
contains no private ROM images, private runtime inputs or compiled binaries.
|
||||
|
||||
The ordinary game Makefile uses VCC Plus's bundled compiler, assembler, linker,
|
||||
Make, Perl and libraries. It does not require a host compiler or Apple SDK.
|
||||
Rebuilding the host CMOC compiler from its source is a different developer task
|
||||
with additional dependencies, explained in the companion.
|
||||
|
||||
## Edition identity and validation
|
||||
|
||||
The November 11, 2026 edition retains the approved CAPITAL.DSK unchanged:
|
||||
5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6
|
||||
|
||||
Base repository revision: 46f4b9cae00951b9924af129b9f74e912766fff8, plus approved
|
||||
map and answer-slot changes. Exact compile-input fingerprint:
|
||||
3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56
|
||||
|
||||
Public-source/documentation cleanup changes no game source, build recipe,
|
||||
compiled data or executable bytes. See docs/PUBLIC_RELEASE.md for qualification,
|
||||
and docs/manual/screenshots.json for selected unmodified guest capture hashes.
|
||||
@@ -0,0 +1,59 @@
|
||||
# Capital Quest dated edition 2026-11-11
|
||||
|
||||
This edition is the unchanged 161,280-byte CAPITAL.DSK with SHA-256
|
||||
5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6.
|
||||
It includes answer-history map colors and nonrepeating correct-answer slots.
|
||||
|
||||
The accepted source is based on public revision 46f4b9c plus those changes;
|
||||
the exact compile-input fingerprint is
|
||||
3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56.
|
||||
The cleanup adds public instructions, player documentation, selected captures,
|
||||
source packaging and attribution, without changing gameplay or disk bytes.
|
||||
|
||||
## Reproduction and runtime checks
|
||||
|
||||
A fresh copy built Release using only the retained public VCC Plus 3.6.1 (53)
|
||||
app's bundled toolchain and a PATH limited to its bin plus /usr/bin and /bin.
|
||||
The resulting disk matched the accepted SHA-256 exactly. No Xcode, Apple SDK,
|
||||
Homebrew command, system Perl, private build dependency or optional ROM-derived
|
||||
standalone disk driver is required by this recipe.
|
||||
|
||||
The same disk also builds with local app3.6.1 (54); Release, Debug and Test builds
|
||||
passed. Host logic tests checked 100,000 question sets across 2,000 seeds, with no
|
||||
consecutive repeated correct slots, all twelve permitted slot transitions,
|
||||
unique choices, reset, matching and scoring; geometry checks passed.
|
||||
|
||||
Local build 54 runtime qualification completed a 50-question multiple-choice quiz
|
||||
on each emulated MC6809 and HD6309, including displayed choice positions, map
|
||||
colors, score and replay. Original public build 53 qualification completed a
|
||||
50-question multiple-choice quiz, all three map views, score/review/replay, and
|
||||
typed entry, Backspace, spelling retry/correction, wrong answer, length limit,
|
||||
reveal and exit. Tests used separate 512 KB Disk BASIC guests and writable disk
|
||||
copies; the original disk remained unchanged and guest disk writes were zero.
|
||||
|
||||
Selected manual illustrations are unchanged displayed 320 × 192 guest framebuffers
|
||||
from the official public build 53 helper. The return-to-BASIC illustration is an
|
||||
unchanged full 640 × 480 frame. Capture hashes/configuration are recorded separately.
|
||||
These are guest screenshots, not native-app marketing-window captures.
|
||||
|
||||
## Public source package
|
||||
|
||||
The primary source ZIP wraps the project in CapitalQuest/, preserving Makefile,
|
||||
main.c, headers, generated sources, data/artwork inputs and vccplus-project.json.
|
||||
The project's entrySource is main.c relative to that directory. Opening source
|
||||
is separate from building/running it. The archive excludes Git data, historical
|
||||
brief/evidence bundles, ROMs, private connections, compiler products and caches.
|
||||
The historical brief remains linked in the public repository and Book 12.
|
||||
|
||||
The separate library-source companion provides matching runtime/GIME/BControl/font
|
||||
sources, original notices and target-library rebuild instructions. Component
|
||||
terms remain intact; no replacement keyboard implementation is included.
|
||||
|
||||
Privacy review covered all three reachable original commits and 64 unique blobs,
|
||||
plus the working tree: no private keys, populated connection credentials, private
|
||||
ROM payloads, personal absolute paths or private-network URLs were found. No
|
||||
history rewrite was performed. Old development evidence remains clearly dated.
|
||||
|
||||
No physical CoCo, physical Intel Mac, macOS 14 or audible listening qualification
|
||||
is claimed by these checks. The native Getting Started/source-open integration
|
||||
is a separate app feature, owned and validated by the VCC Plus app project.
|
||||
@@ -1,6 +1,12 @@
|
||||
# Initial release test results — 2026-11-09
|
||||
|
||||
For the current sound and automatic-feedback changes, see
|
||||
For the latest November 11 disk and nonrepeating correct-answer slots, see
|
||||
[ANSWER_SLOTS.md](ANSWER_SLOTS.md).
|
||||
|
||||
For the November 11 progress-map change, see
|
||||
[MAP_PROGRESS.md](MAP_PROGRESS.md).
|
||||
|
||||
For the sound and automatic-feedback changes, see
|
||||
[FEEDBACK_TESTING.md](FEEDBACK_TESTING.md). The results below describe the initial release.
|
||||
|
||||
Built and played with installed **VCC Plus 3.5.0, build 41**, bundled **CMOC 0.1.100**,
|
||||
|
||||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 15 KiB |
|
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 17 KiB |
@@ -0,0 +1,248 @@
|
||||
# Capital Quest for CoCo
|
||||
|
||||
Capital Quest is a geography quiz about the 50 United States and their capitals. Follow the highlighted state on a color map, choose its capital or type the answer yourself, and watch the map record your progress. Every game asks about all 50 states once, in a shuffled order.
|
||||
|
||||
Start with multiple choice to learn the names and locations. Switch to typed answers when you want to recall a capital without seeing the choices. After the last question, review the states you missed and try another journey.
|
||||
|
||||
By Brian K. Holman. © Brian K. Holman 2026.
|
||||
|
||||
## Get the game running
|
||||
|
||||
Use the **Download game disk** link supplied with this manual to obtain `CAPITAL.DSK`. The [online player guide](https://vccplus.brianholman.com/games/capital-quest/) offers the reading edition and reviewed PDF download. You can play the ready-made disk without compiling the source. The **Source code** link provides the editable project; see [Make your own changes](#make-your-own-changes).
|
||||
|
||||
### Machine setup
|
||||
|
||||
Capital Quest needs this setup:
|
||||
|
||||
| Item | Required setup |
|
||||
| --- | --- |
|
||||
| Computer | Color Computer 3 |
|
||||
| RAM | 512 KB or more |
|
||||
| Processor | MC6809; HD6309 also tested in VCC Plus |
|
||||
| System | CoCo 3 BASIC with Disk BASIC and an FD-502 floppy controller |
|
||||
| Disk | `CAPITAL.DSK` in floppy drive FD0, the CoCo's drive 0 |
|
||||
| Display | RGB is the tested color presentation |
|
||||
| Input | Keyboard |
|
||||
| Sound | Built-in CoCo sound; no sound cartridge needed |
|
||||
|
||||
Use VCC Plus's normal CoCo 3 Disk BASIC setup and select at least 512 KB of RAM. This edition has been tested in VCC Plus 3.6.1 with both emulated processors. These emulator checks do not establish compatibility with a physical CoCo.
|
||||
|
||||
The 512 KB requirement comes from the graphics design. The game keeps one picture visible while drawing the next picture in a second buffer. Those buffers occupy a reserved 64 KB area outside a 128 KB machine's RAM. The game does not use all 512 KB, but this edition cannot run with only 128 KB.
|
||||
|
||||
### Load the disk in VCC Plus
|
||||
|
||||
1. Start VCC Plus and select the machine setup above.
|
||||
2. Open **Media → Floppy Disks…** and insert your copy of `CAPITAL.DSK` into **FD0**.
|
||||
3. Save any existing work in the emulated CoCo before restarting it. Choose **Cold Restart** through the app's machine controls, then let BASIC reach its `OK` prompt.
|
||||
4. Click the CoCo display to give it keyboard focus. Type `DOS` and press `Enter`.
|
||||
5. When the Capital Quest title screen appears, press `1` for multiple choice or `2` to type the capitals.
|
||||
|
||||
The disk's DOS loader starts the game. If you need to load it explicitly, enter this command at the Disk BASIC prompt:
|
||||
|
||||
```text
|
||||
LOADM"CAPITAL.BIN":EXEC
|
||||
```
|
||||
|
||||
The game does not write to its disk, so a write-protected copy is suitable for play. Keep your original download as a clean copy. You do not need to format the disk or add any files to it.
|
||||
|
||||
## Choose a mode
|
||||
|
||||
The title screen shows the national map and four choices. It is also where **Play Again** returns you after a completed quiz.
|
||||
|
||||
| Key | Title-screen action |
|
||||
| --- | --- |
|
||||
| `1` | Start a 50-question multiple-choice quiz |
|
||||
| `2` | Start a 50-question typed-answer quiz |
|
||||
| `C` | Read the credits |
|
||||
| `Q` | Quit to BASIC |
|
||||
|
||||

|
||||
|
||||
Choosing either quiz mode starts with zero points and a fresh map. All 50 states appear once. The state order is shuffled for each game; repeated play can still produce familiar stretches by chance. There is no difficulty menu, player-name entry, or timer that reduces your score. The two modes use the same states, capitals, map colors, and scoring.
|
||||
|
||||
The title map is light teal throughout. It does not carry over the colored answer history of a previous game.
|
||||
|
||||
## Read the map
|
||||
|
||||
The top of a question screen identifies the mode, question number, and current score. Beneath the map, the game names the state and asks for its capital. Read that state name even when a very small state is hard to pick out on the national map.
|
||||
|
||||
| Map color | Meaning |
|
||||
| --- | --- |
|
||||
| Light teal | You have not answered this state yet |
|
||||
| Dark purple | You answered this state correctly |
|
||||
| Red | You answered this state incorrectly or revealed its answer |
|
||||
| Yellow | This is the state in the current question |
|
||||
|
||||
The colors describe your answers, not regions of the country. They do not group states by geography, time zone, or political boundaries. A correct answer after a spelling correction counts as correct and becomes purple.
|
||||
|
||||

|
||||
|
||||
The current state stays yellow while its answer feedback is visible. When the next question opens, the state you just answered changes to purple or red and the next state becomes yellow. The ordinary right-hand panel shows the four-color legend.
|
||||
|
||||
### Northeast detail
|
||||
|
||||
For selected northeastern states, a larger **NORTHEAST** view replaces the legend. A yellow outline on the national map marks the enlarged area. Both views use the same progress colors, so you can see the small current state without losing its national location.
|
||||
|
||||

|
||||
|
||||
### Alaska and Hawaii
|
||||
|
||||
Alaska and Hawaii appear as labeled insets on the national map. A Hawaii question also opens an enlarged **HAWAII** view on the right. The island shapes are simplified to fit the display.
|
||||
|
||||

|
||||
|
||||
The national map and its insets are learning aids. Alaska, Hawaii, and the enlarged views are not drawn to one common scale. Very small islands may disappear at the CoCo's screen resolution.
|
||||
|
||||
## Play multiple choice
|
||||
|
||||
Press `1` at the title screen. Each question presents four different capitals in numbered positions: `1` and `2` on the upper row, `3` and `4` on the lower row. Exactly one belongs to the highlighted state.
|
||||
|
||||
Press the number beside your answer. You do not need to press `Enter`. The game accepts that choice once, shows whether it was correct, gives the capital, and then moves on automatically.
|
||||
|
||||

|
||||
|
||||
The correct answer starts in any of the four positions. On each following question, it is chosen randomly from the other three positions. For example, if the correct answer was `3`, it can be `1`, `2`, or `4` next, but it cannot be `3` again immediately. This follows the correct answer's position, even if you chose a different number. A new quiz starts this rule afresh.
|
||||
|
||||
### Answer feedback
|
||||
|
||||
A correct answer displays **CORRECT!** and plays a rising pair of tones. An incorrect answer displays **NOT THIS TIME.** and plays a lower, falling pair. In both cases, the screen states the correct capital.
|
||||
|
||||

|
||||
|
||||
After the sound, multiple-choice mode leaves about 1.5 seconds to read the feedback, then opens the next question. You do not need `Space` or `Enter` to continue.
|
||||
|
||||
Release the number key after choosing. A held key cannot submit an answer to the next question; let go before pressing its answer. You can take as long as you need while a question is waiting for a choice.
|
||||
|
||||
## Type the capital
|
||||
|
||||
Press `2` at the title screen. The question appears without answer choices. Type the capital in the entry line, then press `Enter` to submit it.
|
||||
|
||||
Letters and spaces form the answer. Periods are also accepted for the supported **St. Paul** spelling. The underscore marks the end of your entry. `Backspace` removes the last character; continue typing to append a replacement. This is an end-of-line editor, not a movable text cursor.
|
||||
|
||||

|
||||
|
||||
### What counts as a match
|
||||
|
||||
Capital Quest ignores letter case. `Denver`, `DENVER`, and `denver` all match. Leading and trailing spaces are ignored, and repeated spaces between words are treated as one space. For example, an answer with extra spaces around **Salt Lake City** is accepted.
|
||||
|
||||
For Minnesota, **Saint Paul**, **St Paul**, and **St. Paul** are accepted. The period belongs in the abbreviated spelling shown here. Other punctuation changes and informal nicknames are not automatically accepted.
|
||||
|
||||
An exact match or accepted alias earns one point. Pressing `Enter` on a blank answer records a miss. Entering a different state's known capital is also a miss, even if its spelling happens to resemble the expected answer.
|
||||
|
||||
### A close spelling
|
||||
|
||||
If the entry is close to the expected spelling, the game may offer a second look. The screen says **That looks close. Check your spelling** and offers:
|
||||
|
||||
| Key | Spelling-prompt action |
|
||||
| --- | --- |
|
||||
| `R` | Return to the entry and edit the answer you already typed |
|
||||
| `V` | Reveal the correct capital and record a miss |
|
||||
|
||||
No point has been awarded at this prompt. Press `R`, use `Backspace` to remove the wrong ending, and type the correction. Press `Enter` again when ready. You do not have to retype the entire answer if only its ending needs changing.
|
||||
|
||||

|
||||
|
||||
The spelling aid is a limited safety net. It does not recognize every possible typo. Short or substantially different answers can be marked incorrect immediately. Keep checking the state name: a correctly spelled capital for another state is not a spelling correction.
|
||||
|
||||
An accepted answer after `R` still earns one point. The results also count it under **correct after spelling correction**. That count describes part of your correct total; it is not a bonus added on top.
|
||||
|
||||
### Reveal an answer
|
||||
|
||||
While editing a typed answer, press the CoCo's `BREAK` key to reveal the capital and record the question as incorrect. In VCC Plus, the Mac's `Esc` key supplies CoCo Break. The feedback names the capital, and the map will mark the state red on the next question.
|
||||
|
||||
At the close-spelling prompt, use `V` to reveal instead. Revealing never earns a point. It can be useful when you want to see the answer and continue learning rather than keep guessing.
|
||||
|
||||
### Entry length
|
||||
|
||||
The entry holds at most 39 characters, including spaces and periods. Extra characters are ignored and a message says **39 characters maximum. Backspace to edit.** Use `Backspace` to shorten the entry, or submit it with `Enter`. No state capital needs an entry this long.
|
||||
|
||||
### Continue after a typed answer
|
||||
|
||||
Typed feedback uses the same result messages, capital display, and tones as multiple choice. It stays visible until you are ready to continue.
|
||||
|
||||

|
||||
|
||||
Release the key you used, read the answer, and press `Space` for the next question. The game does not advance typed feedback automatically. During entry, a space is part of the capital's name; it advances only when the feedback screen asks you to continue.
|
||||
|
||||
## Understand your score
|
||||
|
||||
Each state is worth one point. A correct multiple-choice selection, a correct typed answer, or an accepted spelling correction earns that point. A wrong answer, blank submission, or reveal earns zero. There are no speed bonuses, time penalties, or negative points.
|
||||
|
||||
The score beside the question number is your correct-answer total so far. At the end, **YOUR RESULTS** shows:
|
||||
|
||||
- Your number correct out of 50.
|
||||
- Your percentage: the correct total multiplied by two.
|
||||
- How many correct answers followed a spelling correction.
|
||||
- How many states you missed and can revisit.
|
||||
|
||||
For example, 40 correct answers produce 80 percent and 10 states to revisit. The maximum is 50 out of 50, or 100 percent. Each state contributes at most one point.
|
||||
|
||||

|
||||
|
||||
| Key | Results-screen action |
|
||||
| --- | --- |
|
||||
| `R` | Review the missed states |
|
||||
| `P` | Return to the title screen to choose another quiz |
|
||||
| `Q` | Quit to BASIC |
|
||||
|
||||
## Review missed states
|
||||
|
||||
Press `R` at the results screen. **MISSED STATES** lists up to three missed questions per page, in the order they appeared during your game. Each entry shows the state, your recorded answer, and its correct capital.
|
||||
|
||||
A directly revealed typed answer is shown as **[revealed]**. A blank entry is shown as **[blank]**. If you used `V` after a close spelling, the review can show the text you had entered before revealing.
|
||||
|
||||

|
||||
|
||||
Press `N` when **NEXT PAGE** is offered. Press `B` to return to the results screen. On the last page, only `B` is needed. If you answered every state correctly, the review says **A perfect trip! No missed states.**
|
||||
|
||||
Reviewing does not ask the questions again and does not change your score. It lets you study the completed game's misses before replaying or quitting.
|
||||
|
||||
## Replay, quit, and saved progress
|
||||
|
||||
At the results screen, `P` returns to the title. Choose `1` or `2` for a new quiz. The new game clears the score, answer history, spelling-correction count, and map colors, and shuffles all 50 states again. You can change modes between games.
|
||||
|
||||
`Q` quits from the title or results screen. The game uses the CoCo 3's high-speed clock during play. Quitting restores BASIC's text display and normal clock speed, prints **Thanks for playing Capital Quest!**, and returns to BASIC. There is no separate quit command during an unfinished quiz. In typed mode, `Q` is an ordinary answer letter.
|
||||
|
||||
Capital Quest does not save games, results, high scores, or preferences to disk. Your current quiz and review exist only in the running session. Quitting, restarting the machine, or beginning a new quiz loses them. Take a screenshot of the results if you want a record.
|
||||
|
||||
There is no in-game settings screen or joystick mode. Use the keyboard controls in this guide. Display scaling and sound volume are controlled by VCC Plus rather than by a game settings menu.
|
||||
|
||||
## Credits and licenses
|
||||
|
||||
Press `C` at the title screen to open **A MAP FOR EVERY STATE**. Press `Space` to return. The screen identifies the map source, its Creative Commons license, the adapted map work, and the font author.
|
||||
|
||||

|
||||
|
||||
The map is **© Fla-shop.com**, used under [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/). The original map and its source information are available from [Fla-shop.com's United States SVG map](https://www.fla-shop.com/svg/usa/).
|
||||
|
||||
The game adapts that map through state-region assignment, reduced resolution, simplified boundaries, recoloring, run-length encoding, and Northeast and Hawaii detail views. The insets are not to a common scale. The map's inclusion does not imply endorsement by its creator.
|
||||
|
||||
Pierre Sarrazin's **font5x8** is public domain. The disk boot helper is adapted from his public-domain **autostart.c 0.1.2**. CMOC, LWTOOLS, and the linked libraries retain their own authorship and notices. The source distribution includes `assets/CREDITS.md` and the component notice files; preserve them when sharing modified copies. The [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/CapitalQuest/2026-11-11/43fcd00f12ef/Capital-Quest-Library-Sources.zip) provides the linked runtime, graphics, keyboard, and font sources with their original notices.
|
||||
|
||||
This manual is © Brian K. Holman 2026 and is released under the **GNU General Public License, version 3 or later**. The project includes the full license text. The map retains its CC BY 4.0 terms, and the public-domain font and boot helper retain their separate status.
|
||||
|
||||
## Make your own changes
|
||||
|
||||
The **Source code** link accompanying this manual provides the editable C project. Keep an untouched copy of the approved disk and work in a separate, writable copy of the source. You can change the quiz's presentation or use it as a small learning project while preserving its licenses and attribution.
|
||||
|
||||
In VCC Plus, choose **Develop → C Development → Open** and select the extracted project folder containing `vccplus-project.json` and `Makefile`. Select **Release** and choose **Build**. The declared build target produces the game disk. Use **Show Build Products** to find `build/CAPITAL.dsk` and `build/CAPITAL.bin` in the workspace's build snapshot, then test your new disk with the machine setup in [Get the game running](#get-the-game-running).
|
||||
|
||||
VCC Plus supplies the supported compiler and build tools for this workflow. You do not need Xcode, Homebrew, or a separate compiler installation merely to open and build this project in the app. Asset regeneration and optional host-side tests have additional requirements described in the source README; the generated drawing and state data are already included for ordinary builds.
|
||||
|
||||
If you connect ChatGPT to your personal project copy, review which files the connection shares and enable the project's Makefile workflow when building through that connection. Keep private connection files out of anything you share. Review suggested edits, build them, and test a separate disk copy before replacing a game you want to keep.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
| What you see | What to check |
|
||||
| --- | --- |
|
||||
| **Requires 512 KB CoCo 3 in BASIC.** | Select a CoCo 3 with at least 512 KB, start in ordinary BASIC text mode, and cold restart before loading. A 128 KB setup is insufficient for this edition. |
|
||||
| `DOS` does not start Capital Quest | Confirm that the complete `CAPITAL.DSK` is in FD0 and that the machine has Disk BASIC with its floppy controller. Cold restart and try `DOS` again. The explicit `LOADM` command above is another loading route. |
|
||||
| The game does not respond to keys | Click the CoCo display or use VCC Plus's **Input → Focus CoCo Display** command. Release the previous key before pressing a new one. |
|
||||
| Typed feedback seems to be stuck | Read the feedback, release the previous key, and press `Space`. Typed feedback waits for you; multiple-choice feedback advances automatically. |
|
||||
| A typed capital is marked wrong | Check the named state, the spelling, and the accepted Saint Paul forms. Case and extra spaces are ignored, but arbitrary abbreviations and punctuation are not. |
|
||||
| There is no sound | Check the app's sound controls, Mac volume, and selected audio output. The feedback uses built-in CoCo sound and does not require an add-on sound cartridge. |
|
||||
| The map's colors seem unexpected | Yellow is the current question, teal is unanswered, purple is correct, and red is incorrect. The current state remains yellow through feedback. |
|
||||
| **Graphics timer stopped.** | The game could not complete a display update and has exited. Return to the standard BASIC setup, cold restart, and load the disk again. |
|
||||
| A previous score is missing | Scores are not saved. A new quiz, quit, or machine restart clears the session's results. |
|
||||
|
||||
Before restarting, preserve any other work in the emulated computer. Keep a clean downloaded disk and a separate copy for your own builds so that troubleshooting does not replace a project or program you want to retain.
|
||||
@@ -0,0 +1,27 @@
|
||||
# Capital Quest player manual source
|
||||
|
||||
CAPITALQUEST.md is the authoritative plain GFM player manual. manual.json holds
|
||||
cover/website metadata. images/ contains selected unmodified guest frames;
|
||||
screenshots.json records exact hashes, machine/app configuration and disk identity.
|
||||
The manual is © Brian K. Holman 2026, GPL-3.0-or-later. Map artwork and the other
|
||||
components keep their own notices; see assets/CREDITS.md and docs/PROVENANCE.md.
|
||||
|
||||
Generate the PDF with the shared VCC Plus documentation exporter, not a separate
|
||||
game-specific renderer. From the VCCPlus checkout, supply these selected files:
|
||||
|
||||
```sh
|
||||
python3 tools/documentation/export_pdf.py prepare /path/to/CapitalQuest/docs/manual/CAPITALQUEST.md \
|
||||
--metadata /path/to/CapitalQuest/docs/manual/manual.json --toc \
|
||||
--destination /path/to/ignored-output/Capital-Quest-Manual.pdf
|
||||
```
|
||||
|
||||
Inspect every rendered page and its links/captions, then run the exporter's
|
||||
publish REVIEW_DIRECTORY --reviewed action. Changes to source, metadata, images
|
||||
or shared templates invalidate the review. Generated PDFs/review outputs remain
|
||||
outside tracked sources.
|
||||
|
||||
The website owner imports an explicit snapshot with scripts/import-project-manual.py,
|
||||
slug capital-quest, this Markdown/metadata and the exact reviewed PDF. Its shared
|
||||
layout owns desktop/mobile presentation and prominent disk/source/PDF actions.
|
||||
The online route is https://vccplus.brianholman.com/games/capital-quest/ . Import
|
||||
and PDF generation do not publish software or change the emulator.
|
||||
|
After Width: | Height: | Size: 7.7 KiB |
|
After Width: | Height: | Size: 7.2 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 7.9 KiB |
|
After Width: | Height: | Size: 8.0 KiB |
|
After Width: | Height: | Size: 8.1 KiB |
|
After Width: | Height: | Size: 5.1 KiB |
|
After Width: | Height: | Size: 7.8 KiB |
|
After Width: | Height: | Size: 8.6 KiB |
|
After Width: | Height: | Size: 7.9 KiB |
|
After Width: | Height: | Size: 9.0 KiB |
|
After Width: | Height: | Size: 5.0 KiB |
|
After Width: | Height: | Size: 8.0 KiB |
|
After Width: | Height: | Size: 8.0 KiB |
|
After Width: | Height: | Size: 9.0 KiB |
|
After Width: | Height: | Size: 7.8 KiB |
|
After Width: | Height: | Size: 8.0 KiB |
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"title": "Capital Quest for CoCo",
|
||||
"subtitle": "A player’s guide to both quiz modes, the progress map, spelling help, and missed-answer review.",
|
||||
"author": "Brian K. Holman",
|
||||
"copyright": "© Brian K. Holman 2026",
|
||||
"edition": "Player’s manual · November 11, 2026",
|
||||
"hero_image": "images/title.png",
|
||||
"hero_caption": "The Capital Quest title screen, captured in VCC Plus.",
|
||||
"running_title": "Capital Quest for CoCo · Player’s manual",
|
||||
"brand": "VCC Plus Documentation",
|
||||
"disk_url": "https://vccplus.brianholman.com/dl/software/CoCoLibrary/Exclusives/CapitalQuest/2026-11-11/5dbc30b7c69f/CAPITAL.DSK",
|
||||
"source_url": "https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz",
|
||||
"access_note": ""
|
||||
}
|
||||
@@ -0,0 +1,238 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"gameSourceBaseRevision": "46f4b9cae00951b9924af129b9f74e912766fff8",
|
||||
"gameSourceState": "approved uncommitted map-color and answer-slot changes",
|
||||
"gameEdition": "2026-11-11",
|
||||
"artifactDiskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"emulator": "VCC Plus 3.6.1 (53)",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"video": "RGB",
|
||||
"system": "CoCo 3 BASIC with FD-502 Disk BASIC",
|
||||
"captureDate": "2026-11-11",
|
||||
"method": "Official public-build vcc-playtest helper; disposable disk and machine. All screenshots except exit are exact displayed 320x192 framebuffer previews. Exit is full 640x480 frame.",
|
||||
"images": [
|
||||
{
|
||||
"file": "images/title.png",
|
||||
"sha256": "e551b0b41e899c756fa7620018bb5ba4357791f8aba83f32514f2035ac893488",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 1560,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/credits.png",
|
||||
"sha256": "f1bf3976b1cfe9315a988fbacd9917f92ba0aa8f1c3c80d046ac27219804688c",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 2168,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/multiple-choice.png",
|
||||
"sha256": "b974354f8db97b434cc5e51ff4e604e9b2c72bf56d503e195fd948edb15f17e4",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 3384,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/correct-feedback.png",
|
||||
"sha256": "b9d5dbe6e64aeb235ad3f120054bbe528e23edba86b8ca380ca77252dc750940",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 3572,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/progress-map.png",
|
||||
"sha256": "26346213ad2bf3db9bc704ab060f9505a55a00a06e434f3918b4a7feb4abe1b7",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 5388,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/northeast.png",
|
||||
"sha256": "e5c35cf085ab176c3209ce6e21de10c4bcd91eb1e64c9d8a615de4c315b1aca1",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 5996,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/hawaii.png",
|
||||
"sha256": "8aa3bc58ba87771854ddfd850822ef18a144fe08fb669f6591d82e7e736925ce",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 24844,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/results.png",
|
||||
"sha256": "ef13f1b5d676ccaf3a3d99b37ce0b700d4536215fd90bd2e15fb934c45194685",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 33964,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/missed-review.png",
|
||||
"sha256": "44909bca408b4bf9dbd1eb1c3680f9273b0b33e9138712921a720f2a99278e44",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 34572,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/replay-title.png",
|
||||
"sha256": "e551b0b41e899c756fa7620018bb5ba4357791f8aba83f32514f2035ac893488",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 35788,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/typed-entry.png",
|
||||
"sha256": "325d97d803ed65827d089ae117b692721ee27b5a5bfa87ef2806b31e22d4a43d",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 36468,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/spelling-retry.png",
|
||||
"sha256": "8e4de7bc842824f10405c11c0a0fddbcacd85c028848c981beff329cf2ce8ec6",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 37292,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/typed-corrected.png",
|
||||
"sha256": "c6a109fab2877ce7814217bcb4a02c7b2523ef40cbc37d2f955b726d5006070f",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 38796,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/incorrect-feedback.png",
|
||||
"sha256": "5c4673f597c20058083655b1e53b59f1b00f95003ed3b720ab9195d3ffd3a52e",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 40084,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/input-limit.png",
|
||||
"sha256": "534966d1eb5060750a5495645c9c7e46d89844b9af64d2eb043f504a495911d6",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 42372,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/revealed-feedback.png",
|
||||
"sha256": "055723413e378f1d96fbac7809857417639bed0b577d6fe9a66f31597fa52073",
|
||||
"width": 320,
|
||||
"height": 192,
|
||||
"capture": "VCC Plus vcc-playtest graphics_capture",
|
||||
"fieldClock": 42980,
|
||||
"boot": 1,
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection."
|
||||
},
|
||||
{
|
||||
"file": "images/exit.png",
|
||||
"sha256": "2c8f9768704e9705c3ed9beb51ef4ab9bbc7dfc99daa2bbf34564b51ea0f2b4a",
|
||||
"width": 640,
|
||||
"height": 480,
|
||||
"capture": "VCC Plus vcc-playtest capture",
|
||||
"processor": "MC6809",
|
||||
"ramKB": 512,
|
||||
"diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"note": "Unmodified full guest frame after title-screen Quit, with BASIC return message."
|
||||
}
|
||||
],
|
||||
"finalDiskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6",
|
||||
"diskWrites": 0,
|
||||
"gameInputFingerprintSha256": "3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56"
|
||||
}
|
||||
@@ -39,7 +39,7 @@ static U8 title(void)
|
||||
do {
|
||||
phase=0;frame("50 STATES");
|
||||
text(8,19,"HOW WELL DO YOU KNOW YOUR CAPITALS?",6);
|
||||
show_map(49);
|
||||
show_map(STATE_COUNT);
|
||||
/* Right panel is replaced by the mode selector. */
|
||||
gime_fill_rect(209,32,111,111,0);
|
||||
text(212,40,"CHOOSE A MODE",6);
|
||||
|
||||
@@ -9,6 +9,7 @@ U8 answered[50], correct[50], corrected[50];
|
||||
char responses[50][ANSWER_SIZE];
|
||||
unsigned random_state;
|
||||
static U8 distance_rows[3][ANSWER_SIZE];
|
||||
static U8 previous_correct_slot=4;
|
||||
unsigned quiz_random(unsigned bound)
|
||||
{
|
||||
unsigned x, limit;
|
||||
@@ -28,6 +29,7 @@ void quiz_start(unsigned seed)
|
||||
U8 i,j,t;
|
||||
random_state = seed ? seed : 0xACE1;
|
||||
question=score=corrections=0;
|
||||
previous_correct_slot=4;
|
||||
memset(answered,0,sizeof(answered));
|
||||
memset(correct,0,sizeof(correct));
|
||||
memset(corrected,0,sizeof(corrected));
|
||||
@@ -39,7 +41,10 @@ void quiz_start(unsigned seed)
|
||||
}
|
||||
void quiz_options(U8 state)
|
||||
{
|
||||
U8 i,j,c,t;
|
||||
U8 i,j,c,t,slot;
|
||||
/* First question: all four slots. Later: equally choose the other three. */
|
||||
slot=(U8)quiz_random(previous_correct_slot<4?3:4);
|
||||
if(previous_correct_slot<4 && slot>=previous_correct_slot) ++slot;
|
||||
options[0]=state;
|
||||
for(i=1;i<4;++i) {
|
||||
do {
|
||||
@@ -48,9 +53,12 @@ void quiz_options(U8 state)
|
||||
} while(j<i);
|
||||
options[i]=c;
|
||||
}
|
||||
for(i=3;i>0;--i) {
|
||||
j=(U8)quiz_random(i+1);t=options[i];options[i]=options[j];options[j]=t;
|
||||
/* Shuffle the distractors, then put the correct answer in its chosen slot. */
|
||||
for(i=3;i>1;--i) {
|
||||
j=1+(U8)quiz_random(i);t=options[i];options[i]=options[j];options[j]=t;
|
||||
}
|
||||
t=options[slot];options[slot]=state;options[0]=t;
|
||||
previous_correct_slot=slot;
|
||||
}
|
||||
void normalize(const char *in,char *out)
|
||||
{
|
||||
|
||||
@@ -34,7 +34,9 @@ static void spans(const U8 *data,const unsigned *off,U8 state,unsigned ox,unsign
|
||||
{
|
||||
U8 s,y,x,n,col;unsigned i,end;
|
||||
for(s=0;s<50;++s) {
|
||||
col=s==state?6:((s&1)?3:4);end=off[s+1];
|
||||
/* A title map has no active state; a new quiz starts with no answers. */
|
||||
col=state>=STATE_COUNT?3:(s==state?6:(!answered[s]?3:(correct[s]?4:5)));
|
||||
end=off[s+1];
|
||||
for(i=off[s];i<end;i+=3) {
|
||||
y=data[i];x=data[i+1];n=data[i+2];
|
||||
gime_fill_rect(ox+x,oy+y,n,1,col);
|
||||
@@ -60,11 +62,10 @@ void show_map(U8 state)
|
||||
text(218,36,"HAWAII",7);
|
||||
spans(hawaii_spans,hawaii_offsets,state,211,53);
|
||||
} else {
|
||||
text(218,52,"50 STATES",2);
|
||||
text(218,71,"ONE JOURNEY",7);
|
||||
gime_fill_rect(218,91,8,8,6);text(232,92,"FIND IT",7);
|
||||
text(218,116,"AK / HI",2);
|
||||
text(218,127,"INSETS",2);
|
||||
gime_fill_rect(218,51,8,8,3);text(232,52,"TO ANSWER",7);
|
||||
gime_fill_rect(218,71,8,8,4);text(232,72,"CORRECT",7);
|
||||
gime_fill_rect(218,91,8,8,5);text(232,92,"INCORRECT",7);
|
||||
gime_fill_rect(218,111,8,8,6);text(232,112,"CURRENT",7);
|
||||
}
|
||||
}
|
||||
static U8 any_key(void)
|
||||
|
||||
@@ -0,0 +1,60 @@
|
||||
"""Check progress colors in actual guest frames, including enlarged map views."""
|
||||
import re
|
||||
from pathlib import Path
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
LIGHT = (85, 170, 170)
|
||||
DARK = (85, 85, 170)
|
||||
RED = (255, 85, 85)
|
||||
YELLOW = (255, 255, 0)
|
||||
NORTHEAST = {6, 7, 18, 19, 20, 28, 29, 31, 37, 38, 44}
|
||||
SOURCE = (ROOT / 'src/map_data.c').read_text()
|
||||
|
||||
|
||||
def numbers(pattern):
|
||||
return list(map(int, re.search(pattern, SOURCE)[1].replace('\n', '').split(',')))
|
||||
|
||||
|
||||
GEOMETRY = {
|
||||
view: (numbers(view + r'_spans\[\] = \{\s*([\d,\s]+)'),
|
||||
numbers(view + r'_offsets\[51\] = \{([\d,]+)'))
|
||||
for view in ('national', 'northeast', 'hawaii')
|
||||
}
|
||||
|
||||
|
||||
def check_map_colors(screen, current, outcomes):
|
||||
"""outcomes maps answered state IDs to correctness; None selects title mode."""
|
||||
views = [('national', 6, 33)]
|
||||
if current in NORTHEAST:
|
||||
views.append(('northeast', 211, 42))
|
||||
elif current == 10:
|
||||
views.append(('hawaii', 211, 53))
|
||||
checked = {}
|
||||
for view, ox, oy in views:
|
||||
spans, offsets = GEOMETRY[view]
|
||||
pixels = 0
|
||||
for state in range(50):
|
||||
expected = LIGHT
|
||||
if current is not None:
|
||||
if state == current:
|
||||
expected = YELLOW
|
||||
elif state in outcomes:
|
||||
expected = DARK if outcomes[state] else RED
|
||||
for k in range(offsets[state], offsets[state + 1], 3):
|
||||
y, x, count = spans[k:k + 3]
|
||||
for dx in range(count):
|
||||
xx, yy = ox + x + dx, oy + y
|
||||
# Labels and the northeast overview marker cover map pixels.
|
||||
if view == 'national':
|
||||
if 134 <= yy < 142 and (8 <= xx < 20 or 62 <= xx < 74):
|
||||
continue
|
||||
if current in NORTHEAST and (
|
||||
(xx in (158, 199) and 44 <= yy <= 88) or
|
||||
(yy in (44, 88) and 158 <= xx <= 199)
|
||||
):
|
||||
continue
|
||||
actual = screen.guest(xx, yy)
|
||||
assert actual == expected, (view, state, current, xx, yy, actual, expected)
|
||||
pixels += 1
|
||||
checked[view] = pixels
|
||||
return checked
|
||||
@@ -2,9 +2,10 @@ import os
|
||||
from pathlib import Path
|
||||
import sys,runpy,json,re
|
||||
sys.path.insert(0,str(Path(__file__).parent));from framebuffer import Screen,ROOT,shuffle,EVIDENCE
|
||||
from map_colors import check_map_colors
|
||||
c=runpy.run_path(str(Path(__file__).with_name('playtest_support.py')));run=json.load(open(os.environ['CAPITAL_TEST_STATE']))['run']['run_id']
|
||||
rows=[x.split('\t') for x in (ROOT/'data/states.tsv').read_text().splitlines()]
|
||||
order,_=shuffle();evidence=[];score=0;pos=[0]*4
|
||||
order,_=shuffle();evidence=[];score=0;pos=[0]*4;outcomes={};previous_correctpos=None
|
||||
c['key'](run,'1',8,600)
|
||||
for q,state in enumerate(order):
|
||||
name=f'mc-q{q+1:02d}-{rows[state][0]}'
|
||||
@@ -12,15 +13,19 @@ for q,state in enumerate(order):
|
||||
heading=scr.text(8,19,45);prompt=scr.text(8,145,50)
|
||||
assert heading==f'Question {q+1} of 50 Score {score}',(q,heading,score)
|
||||
assert prompt==f'{rows[state][1]}: what is its capital?',(q,prompt,rows[state])
|
||||
check_map_colors(scr,state,outcomes)
|
||||
opts=[scr.text(8+(i%2)*156,157+(i//2)*12,25)[2:] for i in range(4)]
|
||||
assert len(set(opts))==4 and rows[state][2] in opts,(q,opts)
|
||||
correctpos=opts.index(rows[state][2]);pos[correctpos]+=1
|
||||
assert correctpos!=previous_correctpos,(q,correctpos,previous_correctpos)
|
||||
previous_correctpos=correctpos
|
||||
# Confirm selected state's actual framebuffer mask has the expected gold fill.
|
||||
src=(ROOT/'src/map_data.c').read_text();d=list(map(int,re.search(r'national_spans\[\] = \{\s*([\d,\s]+)',src)[1].replace('\n','').split(',')));off=list(map(int,re.search(r'national_offsets\[51\] = \{([\d,]+)',src)[1].split(',')))
|
||||
points=[(6+x,33+y) for k in range(off[state],off[state+1],3) for y,x0,n in [d[k:k+3]] for x in range(x0,x0+n)]
|
||||
gold=sum(scr.guest(x,y)==(255,255,0) for x,y in points)
|
||||
assert gold>=len(points)*.8,(q,rows[state][0],gold,len(points))
|
||||
right=q%7!=0;selection=correctpos if right else (correctpos+1)%4
|
||||
outcomes[state]=right
|
||||
if right:score+=1
|
||||
# Read the feedback as soon as it appears, before its automatic timeout.
|
||||
held=[str(selection+1)] if q==0 else []
|
||||
@@ -58,7 +63,9 @@ for page in range(3):
|
||||
cap=next(x[2] for x in rows if x[0]==m['code'])
|
||||
assert s.text(8,61+i*43,48)==f'Capital: {cap}'
|
||||
if page<2:c['key'](run,'n',8,500)
|
||||
c['key'](run,'b',8,500);c['key'](run,'p',8,500);c['capture'](run,'replay-title');c['key'](run,'q',8,200);final=c['capture'](run,'mc-exit')
|
||||
c['key'](run,'b',8,500);c['key'](run,'p',8,500);c['capture'](run,'replay-title')
|
||||
check_map_colors(Screen(str(EVIDENCE)+'/replay-title.png'),None,outcomes)
|
||||
c['key'](run,'q',8,200);final=c['capture'](run,'mc-exit')
|
||||
assert 'screen_text' in final or final.get('screen_text_unavailable') is None,final
|
||||
json.dump(dict(score=score,positions=pos,questions=evidence,run_id=run,artifact=result['artifact_id'],exit=final),open(str(EVIDENCE)+'/mc-report.json','w'),indent=2)
|
||||
print('PASS complete multiple-choice quiz, all 50 masks, automatic feedback advance without Space, held-key protection, 42/50, review, replay, exit.',flush=True)
|
||||
|
||||
@@ -3,10 +3,11 @@ from pathlib import Path
|
||||
import runpy,json,sys,uuid
|
||||
from pathlib import Path
|
||||
sys.path.insert(0,str(Path(__file__).parent));from framebuffer import Screen,ROOT,shuffle,EVIDENCE
|
||||
from map_colors import check_map_colors
|
||||
c=runpy.run_path(str(Path(__file__).with_name('playtest_support.py')));state=json.load(open(os.environ['CAPITAL_TEST_STATE']))
|
||||
r=c['call']('start_playtest',dict(project_id=state['cap']['project_id'],revision=state['cap']['revision'],artifact_id=state['artifact']['artifact_id'],request_id=str(uuid.uuid4())))
|
||||
run=r['run_id'];state['typed_run']=r;Path(os.environ['CAPITAL_TEST_STATE']).write_text(json.dumps(state))
|
||||
rows=[x.split('\t') for x in (ROOT/'data/states.tsv').read_text().splitlines()];order,_=shuffle();report=[];score=corrections=0
|
||||
rows=[x.split('\t') for x in (ROOT/'data/states.tsv').read_text().splitlines()];order,_=shuffle();report=[];score=corrections=0;outcomes={}
|
||||
|
||||
def press(k,hold=4,settle=12):return c['key'](run,k,hold,settle)
|
||||
def settle():c['inp'](run,[{'keys':[],'fields':600},{'keys':[],'fields':300}])
|
||||
@@ -24,15 +25,17 @@ settle();c['key'](run,'2',8,600);settle();c['inp'](run,[dict(keys=['shift','0'],
|
||||
# First alias in mixed case. Capture input before submission to verify the real keys.
|
||||
type_text('sT pAuL');s=cap('typed-alias-input');print('input=',s.text(8,158,45),flush=True)
|
||||
assert s.text(8,158,45)=='sT pAuL_',s.text(8,158,45)
|
||||
check_map_colors(s,order[0],outcomes)
|
||||
press('enter',8,600);s=cap('typed-alias-feedback');assert s.text(8,158,30)=='CORRECT!',s.text(8,158,30)
|
||||
c['inp'](run,[dict(keys=[],fields=300)]);s=cap('typed-feedback-waits')
|
||||
assert s.text(8,19,45)=='Question 1 of 50 Score 1'
|
||||
assert s.text(8,183,48)=='Release your key, then SPACE to continue.'
|
||||
score=1;report.append(dict(question=1,code='MN',answer='sT pAuL',correct=True,correction=False));c['key'](run,'space',8,600);settle()
|
||||
score=1;outcomes[order[0]]=True;report.append(dict(question=1,code='MN',answer='sT pAuL',correct=True,correction=False));c['key'](run,'space',8,600);settle()
|
||||
for q in range(1,50):
|
||||
st=order[q];code,name,capital=rows[st];s=cap(f'typed-q{q+1:02d}-{code}')
|
||||
assert s.text(8,19,45)==f'Question {q+1} of 50 Score {score}',(q,s.text(8,19,45),score)
|
||||
assert s.text(8,145,50)==name+': what is its capital?'
|
||||
check_map_colors(s,st,outcomes)
|
||||
spelling=False;right=True
|
||||
if q==1 or code=='CO':
|
||||
# Adjacent transpositions, followed by a real Backspace correction.
|
||||
@@ -64,6 +67,7 @@ for q in range(1,50):
|
||||
assert s.text(8,170,50)==f'The capital is {capital}.'
|
||||
if right:score+=1
|
||||
if spelling:corrections+=1
|
||||
outcomes[st]=right
|
||||
report.append(dict(question=q+1,code=code,answer=answer,correct=right,correction=spelling))
|
||||
c['key'](run,'space',8,600)
|
||||
if q!=49:settle()
|
||||
|
||||
@@ -5,19 +5,33 @@
|
||||
static unsigned index_of(const char *code){unsigned i;for(i=0;i<50;++i)if(!strcmp(states[i].code,code))return i;assert(0);return 0;}
|
||||
int main(void)
|
||||
{
|
||||
unsigned seed,i,j,p,positions[4]={0},last[50],changes=0;
|
||||
unsigned seed,i,j,p,slot,previous,positions[4]={0},first[4]={0};
|
||||
unsigned transitions[4][4]={{0}},last[50],changes=0;
|
||||
U8 first_options[4];
|
||||
char a[160],b[ANSWER_SIZE];
|
||||
for(seed=1;seed<=2000;++seed){
|
||||
unsigned seen[50]={0};quiz_start(seed);
|
||||
unsigned seen[50]={0};quiz_start(seed);previous=4;
|
||||
for(i=0;i<50;++i){
|
||||
assert(order[i]<50);++seen[order[i]];quiz_options(order[i]);p=0;
|
||||
for(j=0;j<4;++j){unsigned k;assert(options[j]<50);if(options[j]==order[i]){++p;++positions[j];}for(k=0;k<j;++k)assert(options[k]!=options[j]);}
|
||||
assert(p==1);if(seed>1 && last[i]!=order[i])++changes;last[i]=order[i];
|
||||
assert(order[i]<50);++seen[order[i]];quiz_options(order[i]);p=0;slot=4;
|
||||
for(j=0;j<4;++j){unsigned k;assert(options[j]<50);if(options[j]==order[i]){++p;++positions[j];slot=j;}for(k=0;k<j;++k)assert(options[k]!=options[j]);}
|
||||
assert(p==1 && slot!=previous);
|
||||
if(i)++transitions[previous][slot];else ++first[slot];
|
||||
previous=slot;
|
||||
if(seed>1 && last[i]!=order[i])++changes;last[i]=order[i];
|
||||
}
|
||||
for(i=0;i<50;++i)assert(seen[i]==1);
|
||||
}
|
||||
for(i=0;i<4;++i)assert(positions[i]>20000);
|
||||
for(i=0;i<4;++i){
|
||||
assert(positions[i]>20000 && first[i]>300);
|
||||
for(j=0;j<4;++j)assert(i==j?transitions[i][j]==0:transitions[i][j]>6000);
|
||||
}
|
||||
assert(changes>90000);
|
||||
/* Replaying a seed must reset the remembered slot as well as the answers. */
|
||||
for(seed=1;seed<=32;++seed){
|
||||
quiz_start(seed);quiz_options(order[0]);memcpy(first_options,options,4);
|
||||
for(i=1;i<50;++i)quiz_options(order[i]);
|
||||
quiz_start(seed);quiz_options(order[0]);assert(!memcmp(first_options,options,4));
|
||||
}
|
||||
for(i=0;i<50;++i){
|
||||
assert(classify(i,states[i].capital)==2);
|
||||
strcpy(a,states[i].capital);
|
||||
@@ -43,6 +57,6 @@ int main(void)
|
||||
for(i=0;i<50;++i)assert(answered[i]==1);
|
||||
quiz_start(2710);assert(score==0 && corrections==0);
|
||||
for(i=0;i<50;++i)assert(!answered[i] && !responses[i][0]);
|
||||
printf("PASS: 2000 shuffles, 100000 option sets, all casing / known-wrong capitals, aliases, distance, bounds, scoring, reset.\n");
|
||||
printf("PASS: 2000 shuffles, 100000 option sets with no repeated correct slot, all 12 allowed slot transitions, replay reset, all casing / known-wrong capitals, aliases, distance, bounds, scoring, reset.\n");
|
||||
return 0;
|
||||
}
|
||||
@@ -0,0 +1,73 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Create a deterministic, source-only Capital Quest starter ZIP.
|
||||
|
||||
No compiler, network, Git mutation, private inputs or game execution is involved.
|
||||
"""
|
||||
import argparse
|
||||
import hashlib
|
||||
import json
|
||||
from pathlib import Path
|
||||
from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
ROOT_FILES = ('AGENTS.md', 'LICENSE', 'Makefile', 'README.md', '.gitignore',
|
||||
'vccplus-project.json', 'main.c', 'quiz.h', 'ui.h', 'map_data.h')
|
||||
DIRECTORIES = ('src', 'data', 'assets', 'tests', 'tools', 'docs/manual')
|
||||
EXTRA_FILES = ('docs/PROVENANCE.md', 'docs/PUBLIC_RELEASE.md')
|
||||
|
||||
|
||||
def source_files():
|
||||
names = set(ROOT_FILES + EXTRA_FILES)
|
||||
for directory in DIRECTORIES:
|
||||
for path in (ROOT / directory).rglob('*'):
|
||||
if path.is_dir():
|
||||
continue
|
||||
name = path.relative_to(ROOT).as_posix()
|
||||
if '__pycache__' in path.parts or path.suffix == '.pyc' or path.name == '.DS_Store':
|
||||
continue
|
||||
if path.is_symlink() or not path.is_file():
|
||||
raise ValueError('Only regular source files are permitted: ' + name)
|
||||
names.add(name)
|
||||
result = {}
|
||||
for name in sorted(names):
|
||||
path = ROOT / name
|
||||
if path.is_symlink() or not path.is_file():
|
||||
raise ValueError('Missing regular source input: ' + name)
|
||||
if any(word in name.casefold() for word in ('connection', 'vccgrant')):
|
||||
raise ValueError('Private-connection filename is not a source input: ' + name)
|
||||
if path.suffix.casefold() in ('.dsk', '.rom', '.bin', '.o', '.a', '.pdf', '.zip'):
|
||||
raise ValueError('Binary, archive or generated output is not source: ' + name)
|
||||
result['CapitalQuest/' + name] = path.read_bytes()
|
||||
return result
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument('--destination', type=Path, required=True)
|
||||
args = parser.parse_args()
|
||||
destination = args.destination.resolve()
|
||||
if destination.is_relative_to(ROOT):
|
||||
parser.error('Keep package output outside the source project.')
|
||||
if destination.exists():
|
||||
parser.error('Destination already exists; retain completed packages unchanged.')
|
||||
files = source_files()
|
||||
destination.parent.mkdir(parents=True, exist_ok=True)
|
||||
with ZipFile(destination, 'x', compression=ZIP_DEFLATED, compresslevel=9) as archive:
|
||||
for name, data in files.items():
|
||||
info = ZipInfo(name, date_time=(1980, 1, 1, 0, 0, 0))
|
||||
info.create_system = 3
|
||||
info.external_attr = 0o100644 << 16
|
||||
info.compress_type = ZIP_DEFLATED
|
||||
archive.writestr(info, data)
|
||||
manifest = dict(schemaVersion=1,projectDirectory='CapitalQuest',
|
||||
configurationFile='CapitalQuest/vccplus-project.json',entrySource='main.c',
|
||||
archive=destination.name,byteSize=destination.stat().st_size,
|
||||
sha256=hashlib.sha256(destination.read_bytes()).hexdigest(),
|
||||
files=[dict(path=name,byteSize=len(data),sha256=hashlib.sha256(data).hexdigest())
|
||||
for name,data in files.items()])
|
||||
destination.with_suffix('.manifest.json').write_text(json.dumps(manifest,indent=2)+'\n')
|
||||
print(json.dumps({k:v for k,v in manifest.items() if k!='files'},indent=2))
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||