Prepare Capital Quest public edition and player manual

This commit is contained in:
Brian Holman committed 2026-11-11 19:27:51 -07:00
1 parent 46f4b9cae0
commit afa6f3c2a0
40 files changed
+1072 -106

No files matched your search

+45
View File
@@ -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.
+47
View File
@@ -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.
+76
View File
@@ -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.
+59
View File
@@ -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.
+7 -1
View File
@@ -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**,
Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

+248
View File
@@ -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 |
![The Capital Quest title screen offers multiple choice, typed answers, credits, and Quit.](images/title.png)
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 progress map uses teal for unanswered states, purple for correct answers, red for misses, and yellow for the current question.](images/progress-map.png)
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.
![The Northeast detail enlarges small states while the national overview remains visible.](images/northeast.png)
### 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.
![A Hawaii question shows an enlarged island view beside the national map.](images/hawaii.png)
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.
![A multiple-choice question places four numbered capital choices below the highlighted state.](images/multiple-choice.png)
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.
![Correct-answer feedback confirms the result and names the capital.](images/correct-feedback.png)
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.
![Typed-answer mode shows an editable answer line and the keys for submission, correction, or reveal.](images/typed-entry.png)
### 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 close-spelling prompt offers Retry or Reveal and says that no point has been awarded yet.](images/spelling-retry.png)
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.
![Incorrect typed-answer feedback gives the correct capital and waits for Space before continuing.](images/incorrect-feedback.png)
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.
![The results screen shows the correct total, percentage, spelling-correction count, and options to review, replay, or quit.](images/results.png)
| 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.
![Missed-answer review lists the state, the player's answer, and the correct capital, with paging controls below.](images/missed-review.png)
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 credits screen identifies Fla-shop.com's map, its CC BY 4.0 license, the adaptations, and Pierre Sarrazin's font.](images/credits.png)
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.
+27
View File
@@ -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.
Binary file not shown.

After

Width:  |  Height:  |  Size: 7.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.0 KiB

+14
View File
@@ -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": ""
}
+238
View File
@@ -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"
}