Publish Bone Quest player manual and release sources

This commit is contained in:
Brian Holman committed 2026-11-11 23:49:29 -07:00
1 parent 2ceb44a48c
commit ea87321e61
22 files changed
+996 -3

No files matched your search

+15 -3
View File
@@ -4,9 +4,11 @@ An anatomy quiz for a 512 KB Color Computer 3, built from Capital Quest's workin
quiz foundation. Identify 28 skeletal structures on a human skeleton, quiz foundation. Identify 28 skeletal structures on a human skeleton,
choose among four names or type the answer, then review missed questions. choose among four names or type the answer, then review missed questions.
The skeleton uses native 640 × 225 graphics with four colors and page swapping. The skeleton uses native 640 × 225 graphics with four colors and page swapping.
Designed by Brian Holman with assistance from ChatGPT/Codex.
Download the ready-to-test [BONEQ.DSK](BONEQ.DSK). Both complete quiz modes have Download [BONEQ.DSK](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Exclusives/BoneQuest/2026-11-11/373a3f387daf/BONEQ.DSK) and read the [complete online player guide and PDF](https://vccplus.brianholman.com/games/bone-quest/).
been checked in VCC Plus on emulated MC6809 and HD6309 processors. The [manual source](docs/manual/BONEQUEST.md) is included here. Both complete quiz
modes have been checked in VCC Plus on emulated MC6809 and HD6309 processors.
![Bone Quest identifying ribs in the high-resolution full skeleton and enlarged chest view](docs/images/multiple-choice.png) ![Bone Quest identifying ribs in the high-resolution full skeleton and enlarged chest view](docs/images/multiple-choice.png)
@@ -71,7 +73,7 @@ the retained metadata and drawing data. make test detects stale question data an
Based on Capital Quest by Brian Holman, revision Based on Capital Quest by Brian Holman, revision
[afa6f3c](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6), [afa6f3c](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6),
GPL-3.0-or-later. Bone Quest is a separate project; Capital Quest is unchanged. GPL-3.0-or-later. Capital Quest is maintained as a separate project.
Skeleton artwork: Mariana Ruiz Villarreal (LadyofHats), author's public-domain Skeleton artwork: Mariana Ruiz Villarreal (LadyofHats), author's public-domain
release via Wikimedia Commons. The original SVG and source receipt are retained. release via Wikimedia Commons. The original SVG and source receipt are retained.
@@ -82,3 +84,13 @@ The game remains GPL-3.0-or-later; preserve the full LICENSE and component notic
Pierre Sarrazin's font and boot helper keep their public-domain headers. The Pierre Sarrazin's font and boot helper keep their public-domain headers. The
bundled libraries retain their individual terms, including the original BControl bundled libraries retain their individual terms, including the original BControl
notice. No ROM image or private connection is included here. notice. No ROM image or private connection is included here.
The [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/BoneQuest/2026-11-11/cfa179075827/Bone-Quest-Library-Sources.zip)
provides the linked runtime/component sources separately from the small editable
starter. See [provenance](docs/PROVENANCE.md) and the [dated release record](docs/PUBLIC_RELEASE.md)
for source identity, byte-for-byte reconstruction and qualification limits.
The online game release is available independently of the app catalog. Getting
Started inclusion is queued for a future VCC Plus build; the manual loading
instructions above work in the current app.
+100
View File
@@ -0,0 +1,100 @@
# Sources, attribution and licenses
Bone Quest is Brian Holman's C anatomy quiz, developed with assistance from
ChatGPT/Codex. It uses the GPL-3.0-or-later Capital Quest foundation at revision
[afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6).
The geography dataset and Fla-shop map are not part of Bone Quest.
## Game, manual and anatomy bank
Game source and the player manual are GPL-3.0-or-later. The manual is
© Brian K. Holman 2026. LICENSE retains the full GPL version 3 text. These
statements do not replace an original component's file-specific terms.
The authored facts and accepted answer aliases are in data/bones.json. The
28 learning units are bones, bone groups, parts of bones and two cavities;
they do not claim to identify every individual adult bone. Paired left/right
examples share a question. docs/ANATOMY.md explains terminology, factual
references and grouping. tools/prepare_questions.py validates and regenerates
the small runtime table. Textbook questions, passages and images are not copied.
## Skeleton source and adaptations
The original Human_skeleton_front_en.svg is by **Mariana Ruiz Villarreal
(LadyofHats)**, released into the public domain by its author. The retained
SVG and metadata are unchanged:
- [Original/terms](https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg)
- [Original SVG](https://upload.wikimedia.org/wikipedia/commons/c/ca/Human_skeleton_front_en.svg)
- SHA-256: `501752c94533439a31521a929a10ad1dd1b781f588d44fc87144c426a38b8773`
Adaptations remove labels/leader lines, fit the CoCo's native pixel aspect,
preserve internal linework, assign per-structure ownership, encode compact
runs, recolor, and prepare enlarged regions. The sternum and hip components
use documented coordinate cuts. The anatomical left thumb is rotated toward
the palm as one three-bone chain, preserving relative lengths and joints.
The second, user-supplied labeled raster reference guides the 28-topic list and
outline preference; its pixels are not included in the game or public source.
Exact source elements, geometry cuts and masks are recorded in
data/geometry-manifest.json. The optional authoring script is retained;
ordinary builds use the generated C metadata and BONES.DAT, without an SVG
renderer. The artist does not endorse this adaptation. See assets/CREDITS.md.
## Linked components and corresponding sources
- Pierre Sarrazin's **font5x8**, from HiresTxt 0.5.1, retains its explicit
public-domain dedication in the source companion and component notice.
- tools/boot.c adapts Pierre Sarrazin's public-domain autostart.c 0.1.2 to load
BONEQ.BIN. Its original header remains.
- **BControl 0.1.6** provides the original Keyboard_init/poll/shutdown routines.
Its full sources and notices are preserved unchanged. Keyboard.c states public
domain except parts that come from Color Basic. The game's GPL does not rewrite
that source-specific wording; see assets/BCONTROL-NOTICE.txt.
- The original **VCC Plus bank/input SDK** sources and public headers retain
GPL-3.0-or-later. The bank library stores the read-only drawing data. The input
archive appears in the game Makefile but contributes no object to this binary.
- **decbfile 0.1.13** is Pierre Sarrazin's public-domain file library. Only its
ordinary ROM-backed core is linked. It uses the Disk BASIC already in the
guest; no Disk BASIC ROM bytes or standalone Disk BASIC-derived driver are
included. Its exact upstream release and original file hashes are retained.
- **CMOC 0.1.100** supplies CRT, standard-library and BASIC-backed numeric runtime
objects. The companion preserves the source-only pinned snapshot, licenses,
original build system, import/compiler patches and build references.
- The complete local 640 × 225 graphics implementation is in src/graphics.c and
graphics.h. It adapts VCC Plus's GPL SDK gime.c at upstream revision
`f1ab8538a5b6b88a82951e9305db349a470a4e86`, original file SHA-256
`3a4ec27d3bc19cf59b1bcf23ae9ccb89aa308731e97ec12ef9609516c323859d`.
Its four-color packing, page sizes and copy operation do not change the public
SDK's separate 320 × 192 contract. The companion retains that foundation
source; libgime.a is not linked by Bone Quest.
Download the [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/BoneQuest/2026-11-11/cfa179075827/Bone-Quest-Library-Sources.zip).
It is separate from the small writable C-workspace starter so opening the game
need not import hundreds of compiler/runtime files. SOURCE_INVENTORY.json pins
component files, upstream releases and patch provenance. The target-only rebuild
driver uses installed VCC Plus tools in a fresh copy and never modifies snapshots
or the installed app. The full rebuild and comparison receipt accompanies it.
The reconstructed bank, input, ROM-backed decbfile, BControl, CMOC CRT, standard
and BASIC-backed float archives match installed VCC Plus 3.6.1 (54) byte for
byte. The font-only HiresTxt archive intentionally omits unrelated members;
its font5x8.o matches the installed member exactly. Keyboard.o also matches. The relevant runtime/library artifacts in the retained
public VCC Plus 3.6.2 (55) app are identical to those build 54 inputs.
No ROM image, Float09.bin, standalone Disk BASIC-derived driver, private grant,
credential or generated compiler binary is included in the source companion.
Rebuilding a host compiler from its sources is a separate developer task with
additional dependencies; normal game builds use the supported bundled tools.
## Release identity
The accepted game implementation is revision
`2ceb44a48ce45382ab5a531a1db9341de69ca6ca`. Its approved BONEQ.DSK is
161,280 bytes, SHA-256:
`373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba`
The public release adds documentation and packaging without changing executable
inputs or disk bytes. docs/PUBLIC_RELEASE.md describes qualification;
docs/manual/screenshots.json identifies selected unmodified guest illustrations.
The final release descriptor records the publication/source revision separately.
+94
View File
@@ -0,0 +1,94 @@
# Bone Quest dated edition 2026-11-11
Brian approved the complete Bone Quest release treatment, including the online
manual, PDF, native disk and editable sources. Getting Started integration is
queued for a later VCC Plus build; this game publication does not require a new
emulator build or a new VCC Plus product release.
The accepted game implementation is revision
`2ceb44a48ce45382ab5a531a1db9341de69ca6ca`. The approved 161,280-byte BONEQ.DSK
has SHA-256 `373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba`.
Documentation, public-source cleanup and packaging preserve those exact bytes.
The release descriptor records the final source/documentation commit.
## Game and graphics qualification
The Release disk completed both 28-question modes on emulated MC6809 and HD6309
with 512 KB RAM, RGB and FD-502 Disk BASIC. Actual displayed text and all six
skeleton/detail views were checked against the questions/history. This includes
nonrepeating correct slots, white normal/correct structures, red misses, yellow
current structures, aliases, spelling retry, Backspace, blank-answer reveal,
33-character entry bounds, scoring, missed-answer review, replay and exit.
Sixteen targeted global-exit scenarios across both CPUs verified Q/q, native
Escape/Break and ASCII 27, questions, spelling, both feedback paths, credits
and title; full rounds also quit directly from missed review. Disk writes were
zero and the loaded disk identity stayed unchanged.
Host logic checked 56,000 option sets over 2,000 complete shuffles, all permitted
slot transitions, matching/scoring/reset and generated table/geometry identity.
The unchanged graphics fixture qualified packed edges, bank seams, five-bank
pages, front-to-back copy, hidden edits staying hidden, clipping, MMU restoration
and BASIC return on both guest CPUs. Missing/wrong-size/wrong-checksum artwork
returned cleanly to BASIC. The [dated verification receipt](https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest/src/branch/main/docs/VERIFICATION.json)
remains in the public repository; raw private-input runs stay outside the starter.
Program/static storage ends at $73FD in Release, $745B in Debug and $7402 in Test,
below $7800 with a separate 2 KB stack. Optional authoring dependencies are not
needed by normal builds. Separate correct/incorrect feedback captures contain
nonzero guest signal; audible listening is not claimed.
## Reproduction and source packages
The source starter wraps the selected project in BoneQuest/, preserving the
Makefile, root headers, main.c, generated C metadata, BONES.DAT, original SVG,
authored data, conversion scripts, notices, useful optional tests and complete
player manual. Its configuration is BoneQuest/vccplus-project.json; entrySource
is main.c relative to that directory. The original .gitattributes keeps the SVG
byte contract and DAT binary treatment. The prebuilt disk is distributed
separately rather than imported into the editable starter.
The separate matching library-source companion preserves compiler/runtime,
keyboard, font, bank/input and ROM-backed DECB sources with exact file notices,
source hashes and target-only reconstruction instructions. Its rebuilt used
archives/objects match the installed build 54 toolchain; see PROVENANCE.md.
The complete custom graphics implementation remains in the game source package.
No ROM, standalone Disk BASIC-derived driver or replacement keyboard is added.
The reproducible release tool is tools/package_release.py. It accepts reviewed
source, the frozen library-source preparation directory, a reviewed PDF and the
final source revision, then writes deterministic native/source/library ZIPs,
cover/hero copies, the source member manifest, exclusive-title.json and
ARTIFACTS.json. The native ZIP contains the exact BONEQ.DSK and NOTICE.txt.
Every delivery URL is content addressed using its actual hash. The approved disk
is checked before packaging. Optional --qualify builds the extracted source with
the installed bundled tools in separate Release/Debug/Test output directories;
Release must reproduce the approved disk byte for byte.
The normal build uses CMOC 0.1.100, LWTools 4.25, Make, Perl and libraries supplied
by VCC Plus. Qualification limits PATH to that toolchain plus /usr/bin:/bin and
disables host SDK/developer-tool lookup. Python/Pillow/rsvg-convert authoring,
Xcode, Homebrew and a host C compiler are not ordinary build prerequisites.
Python is needed only to run the optional packaging/test drivers themselves.
The retained official VCC Plus 3.6.2 (55) app was inspected read-only. Its nine
relevant runtime/library artifacts are byte-identical to the qualified build 54
inputs. A clean extracted starter built all three configurations using the
public build 55 toolchain; Release reproduced the approved disk exactly, with
the same Release/Debug/Test program ends recorded above. No host app was rebuilt
or installed. Full gameplay qualification remains the build 54 checks described
above; the public 55 check establishes ordinary source-build reproduction.
## Manual and publication boundaries
The authoritative GFM player guide is docs/manual/BONEQUEST.md with metadata
and selected unmodified guest captures. Its online route is
https://vccplus.brianholman.com/games/bone-quest/ . The PDF uses the shared VCC Plus
manual exporter and visual review procedure. The website owns import, upload and
publication; validated receipts identify what is actually hosted. The final
source commit, public repository and download records are distinct from a local
build. Native Getting Started changes are queued for the app owner and must
preserve existing writable cached media and restart safeguards.
No physical CoCo, physical Intel Mac, macOS 14, native-window/source-open workflow
or audible listening qualification is claimed here. Public guest captures do
not imply native marketing-window verification.
+313
View File
@@ -0,0 +1,313 @@
# Bone Quest for CoCo
Bone Quest is a human-anatomy quiz about 28 skeletal structures. Follow the yellow highlight, identify the structure from four choices or type its name, and use the missed-answer review to study what you want to try again. Every round asks all 28 topics once, in a shuffled order.
The skeleton is drawn in the Color Computer 3's 640 × 225 four-color graphics mode. The full figure keeps the question in context while a larger view shows the selected area. White bones and black linework leave room for yellow questions and red misses.
Start with multiple choice to become familiar with the names and locations. Try typed answers when you want to recall the name without seeing choices. Both modes use the same questions and scoring.
By Brian K. Holman. © Brian K. Holman 2026.
## Get the game running
Use the **Download game disk** link accompanying this guide to get `BONEQ.DSK`. You can play the ready-made disk without compiling anything. The [online player guide](https://vccplus.brianholman.com/games/bone-quest/) provides the reading edition and PDF, and the [source repository](https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest) provides the editable project.
### Machine 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, Disk BASIC and an FD-502 floppy controller |
| Disk | `BONEQ.DSK` in FD0, the CoCo's drive 0 |
| Display | RGB is the tested presentation; 640 × 225, four colors |
| Input | Keyboard |
| Sound | Built-in CoCo sound; no sound cartridge needed |
Select at least 512 KB of RAM in VCC Plus's CoCo 3 Disk BASIC setup. The game has been tested in VCC Plus 3.6.1 with both emulated processors. These checks do not establish compatibility with a physical CoCo.
The RAM requirement comes from the graphics and artwork design. One picture stays visible while the next is drawn on a second page. The two graphics pages reserve 80 KB, and a separate banked area holds the drawing data. The game does not use all 512 KB, but this edition cannot run in a 128 KB setup.
### Load the disk in VCC Plus
1. Start VCC Plus with the setup above.
2. Open **Media → Floppy Disks…** and insert a copy of `BONEQ.DSK` into **FD0**.
3. Save any existing work in the emulated CoCo before restarting. Choose **Cold Restart** through the app's machine controls and let BASIC reach its `OK` prompt.
4. Click the CoCo display to give it keyboard focus. Type `DOS` and press `Enter`.
5. At the Bone Quest title, press `1` for multiple choice or `2` to type the names.
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"BONEQ.BIN":EXEC
```
Keep the complete disk together: the executable loads `BONES.DAT` from drive 0 when it starts. You do not need to format the disk or add files. The game never writes to its disk, so a write-protected copy is suitable for play. Keep the original download as your clean copy.
## Choose a mode
| Key | Title-screen action |
| --- | --- |
| `1` | Start a 28-question multiple-choice quiz |
| `2` | Start a 28-question typed-answer quiz |
| `C` | Read the credits |
| `Q`, `Esc` or CoCo `BREAK` | Quit to BASIC |
![The Bone Quest title offers multiple choice, typed names, credits and Quit.](images/title.png)
Choosing a mode starts with zero points, no recorded misses and a fresh shuffled order. Every topic appears once. There is no player-name entry, difficulty selector or countdown that reduces your score. Take as long as you need while a question is waiting for your answer.
Press `Q`, `Esc` or CoCo `BREAK` when you want to leave the quiz. In VCC Plus, the Mac's `Esc` key sends CoCo Break. Release keys between presses so one selection does not become another action.
## Read the skeleton
The top line identifies the quiz mode. Below it, the question number and score show where you are in the round. The full skeleton remains on the left. A larger detail view appears on the right, above the prompt and a short location hint.
| Color | Meaning |
| --- | --- |
| White | Normal anatomy: unanswered structures, correct answers and unquizzed context |
| Yellow | The structure in the current question |
| Red | A structure you missed or whose answer you revealed |
| Black | Background, bone boundaries and internal linework |
Correct answers return to white rather than receiving an extra color. Use the **CORRECT!** message and score to confirm success. A white structure by itself does not tell you whether it has already been answered. Parts that are not separate quiz topics also stay white for context.
The current structure stays yellow while its feedback is shown. On the next question, a miss turns red and a correct answer returns to white; the next target becomes yellow.
![Ribs are highlighted in yellow in both the full skeleton and enlarged chest. Earlier misses are red; ordinary anatomy remains white.](images/progress-skeleton.png)
### Use the enlarged views
The detail panel helps with small or crowded structures. Head and neck, chest, hand, foot, and lower-spine/pelvis views retain the same question and miss colors as the full figure. Long-bone questions may magnify a crop from the overview. The views are learning aids rather than drawings at one common scale.
![The head detail makes the highlighted orbital cavities easier to distinguish from the skull and nasal opening.](images/head-detail.png)
Paired left and right counterparts share one question, so both may light up together. The skeleton faces you: its left hand is on the right side of the screen. The thumb is part of the hand's phalanges topic along with the other digits.
![The enlarged hand preserves individual bone groups and shows the finger phalanges, including the thumb, in yellow.](images/hand-detail.png)
Read the location hint as well as the picture. For example, the radius is on the thumb side of the forearm and the ulna is on the little-finger side. The tibia is on the inner side of the lower leg and the fibula on the outer side.
## Play multiple choice
Press `1` at the title. Each question shows four different names, one per numbered line. Exactly one names the highlighted structure.
Press the number beside your choice: `1`, `2`, `3` or `4`. You do not need `Enter`. The game accepts the choice once, gives feedback and the correct name, and then advances automatically.
![A multiple-choice question shows four numbered structure names beside the full skeleton.](images/multiple-choice.png)
The correct answer can begin in any slot. For each following question, its slot is chosen randomly from the other three. If the correct answer was `3`, it can be `1`, `2` or `4` next, but cannot be `3` again immediately. This rule follows the correct answer's slot, even when you choose a different number. A new quiz starts the rule afresh.
### Answer feedback
A correct answer displays **CORRECT!** and plays a rising pair of tones. A miss displays **NOT THIS TIME.** and plays a lower, falling pair. Both screens show the correct name. During feedback, the top score still shows the total from when that question opened. An awarded point appears on the next question or the results screen.
![Correct feedback confirms the accepted name. The awarded point appears in the next question's score or in the results.](images/correct-feedback.png)
After the tones, multiple choice leaves about 1.5 seconds to read the answer before opening the next question. You do not need `Space` to continue. The reading pause also accepts the quit keys.
Release the answer key after choosing. A held number cannot answer the next question; let go before pressing a new selection.
## Type the structure name
Press `2` at the title. The question appears without answer choices. Type the name in the entry line and press `Enter` to submit it.
The underscore marks the end of your entry. `Backspace` removes the last character so you can type a replacement. This is an end-of-line editor, not a movable text cursor. Letters, spaces, periods and hyphens can be entered. `Q` is reserved for quitting, including in typed mode.
![Typed-answer mode provides an entry line and the submission, blank-answer and quit controls.](images/typed-entry.png)
### Matching names and common forms
Letter case does not matter: `Femur`, `FEMUR` and `femur` all match. Leading and trailing spaces are ignored, and repeated spaces between words count as one space. Extra punctuation is not automatically ignored.
Common forms are accepted where they identify the same topic. **Collarbone** names the clavicle, **shoulder blade** the scapula, **kneecap** the patella, and **tailbone** the coccyx. The [28-topic reference](#the-28-topic-reference) lists every additional accepted form.
Be specific about the highlighted part. **Sternum** alone does not identify only its middle body; use **Body of sternum**, **sternal body** or **sternum body**. **Pelvis** and **hip bone** do not distinguish the ilium from the pubis. Bare **phalanges** cannot distinguish hand from foot: use **Finger phalanges** or **Toe phalanges**, or one of their listed aliases.
An exact name or accepted form earns one point. A different topic's exact name or alias is a miss, even when it resembles the expected spelling. A location hint is not automatically an accepted answer.
### A close spelling
A near spelling may get a second look. **That looks close. Check your spelling.** offers:
- `R`: return to your existing entry and edit it.
- `V`: reveal the correct name and record a miss.
- `Q`, `Esc` or CoCo `BREAK`: quit to BASIC.
![Spelling help offers Retry or Reveal and states that no point has been awarded yet.](images/spelling-retry.png)
No point has been awarded at this stage. After `R`, use `Backspace` to remove the wrong ending and type the correction; you need not retype an unchanged beginning. Submit again with `Enter`.
An accepted correction still earns one point. The results count it as a spelling correction, which is part of your correct total rather than a bonus. The spelling aid compares with the displayed name, not every accepted alias. It is limited: short or substantially different answers may be marked wrong immediately.
### Reveal or skip a question
Press `Enter` with an empty entry to show the correct name and record a miss. If you have already typed something, remove it with `Backspace` first. At the spelling-help prompt, `V` also reveals the answer as a miss.
Escape and Break quit; they do not reveal an answer. Revealing never earns a point. It lets you see the answer and keep learning without guessing.
### Entry length
The line holds at most 33 characters, including spaces and punctuation. Extra characters are ignored and the hint says **Use Backspace to edit.** Shorten the entry or submit it with `Enter`. No listed canonical name needs this much space.
![The entry limit keeps a 33-character answer and its cursor within the panel.](images/input-limit.png)
### Continue after a typed answer
Typed feedback uses the same result messages, correct-name display and tones as multiple choice. It waits for you instead of advancing automatically.
![Incorrect typed feedback supplies the correct name and waits for Space.](images/incorrect-feedback.png)
Read the answer, release the previous key and press `Space` for the next question. A space is part of a name while you are entering it; it advances only at the feedback screen. You can also use the global quit keys here.
## Understand your score
Every topic is worth one point. A correct choice, an accepted typed answer or an accepted spelling correction earns that point. A wrong answer, blank submission or reveal earns zero. Each topic contributes at most one point; there are no time bonuses or penalties.
While a question is waiting for an answer, the top score is the correct total from earlier questions. The feedback screen keeps that number until the next question or results. After question 28, **YOUR RESULTS** shows:
- Your correct total out of 28.
- The whole-number percentage, rounded down.
- The number of correct answers that followed spelling help.
- The number of topics to revisit.
For example, 23 correct answers give 82 percent and five topics to revisit. The maximum is 28 out of 28, or 100 percent. The spelling-correction count does not add extra points.
![Results show the total, percentage, spelling corrections and missed-topic count, with Review, Play Again and Quit.](images/results.png)
| Key | Results-screen action |
| --- | --- |
| `R` | Review the missed questions |
| `P` | Return to the title and choose another quiz |
| `Q`, `Esc` or CoCo `BREAK` | Quit to BASIC |
## Review missed topics
Press `R` at results. **MISSED TOPICS** lists up to three missed questions per page, in the order they appeared in the round. Each entry shows the correct name, your recorded answer and the answer again for comparison.
A blank reveal appears as **[blank]**. If you used `V` after spelling help, review can show the text that was in your entry before you revealed the answer.
![Missed-topic review shows recorded answers and correct names, with next-page, back and quit controls.](images/missed-review.png)
Press `N` when another page is offered. Press `B` to return to results. On the final page, only Back and the quit keys are needed. A perfect round has no missed topics and says **A perfect skeleton! No missed topics.**
Review does not ask the questions again or change the score. Use it to study before starting a fresh round.
## Replay, quit and saved progress
At results, press `P` to return to the title. Choose `1` or `2` for another round. The new game clears the score, answer history, spelling-correction count and red marks, then shuffles all 28 topics again. You can switch modes between rounds.
Press `Q`, `Esc` or CoCo `BREAK` to quit from the title, credits, a question, typed entry, spelling help, feedback, results or review. The automatic reading pause also checks these keys. In VCC Plus, Mac `Esc` supplies CoCo Break.
Quitting releases the keyboard, restores BASIC's text display and normal clock speed, prints **Thanks for playing Bone Quest!** and returns to BASIC. It does not close VCC Plus.
Bone Quest does not save games, scores, high scores or preferences to disk. Progress exists only in the current running session. Quitting, restarting or beginning a new quiz clears it. Take a screenshot of the results if you want a record.
There is no joystick mode or in-game settings screen. Use VCC Plus for display scaling, audio volume and other emulator settings.
## The 28-topic reference
This quiz covers 28 named learning topics, not 28 individual bones or every bone in the adult skeleton. The topics include bones, groups of bones, parts of bones and two cavities. The orbital and nasal cavities are spaces, not bones. Paired left and right counterparts share one topic; the hand and foot phalanges are separate topics.
The reference below is grouped for study. The order of questions in a game is shuffled. Every displayed name is accepted exactly, and the right-hand column lists all additional accepted forms in this edition. Case and spacing normalization apply to these forms too.
### Head, neck and chest
| Name on screen | Where to look | Other accepted forms |
| --- | --- | --- |
| Skull | Head, including the lower jaw | cranium |
| Cervical vertebrae | Neck section of the spine | neck vertebrae; cervical vertebra |
| Orbital cavity | Bony space around the eye | eye socket; orbit |
| Nasal cavity | Space behind the nose | nose cavity |
| Clavicle | Front of the shoulder | collarbone; collar bone |
| Scapula | Back of the shoulder | shoulder blade; shoulderblade |
| Manubrium | Upper breastbone section | manubrium sterni |
| Body of sternum | Middle breastbone section | sternal body; sternum body |
| Xiphoid process | Small tip of the breastbone | xiphoid |
| Ribs | Curving around the chest | rib; rib bones |
The **Skull** topic includes the lower jaw. **Cranium** is accepted as a familiar alternative in this overview; the game does not separately test each cranial or facial bone. The sternum is divided into its upper manubrium, middle body and lower xiphoid process.
### Lower spine and pelvis
| Name on screen | Where to look | Other accepted forms |
| --- | --- | --- |
| Lumbar vertebrae | Lower back | lumbar vertebra; lower back vertebrae |
| Ilium | Upper flared part of the hip | Use the displayed name |
| Sacrum | Base of spine above tailbone | sacral bone |
| Coccyx | Small tip below the sacrum | tailbone; tail bone |
| Pubis | Front lower part of the hip | pubic bone |
The ilium and pubis are separate parts of the hip bone. **Ilium** has one L after the initial I. The ischium and thoracic vertebrae can appear as context but are not separate questions in this set.
### Arm and hand
| Name on screen | Where to look | Other accepted forms |
| --- | --- | --- |
| Humerus | Upper arm | upper arm bone |
| Ulna | Forearm, little-finger side | ulna bone |
| Radius | Forearm, thumb side | radius bone |
| Carpals | Wrist | carpus; wrist bones; carpal bones |
| Metacarpals | Palm between wrist and fingers | metacarpus; palm bones; metacarpal bones |
| Finger phalanges | Digits of the hand | finger bones; hand phalanges |
Finger phalanges includes the thumb. In anatomical position the radius is on the thumb side and the ulna on the little-finger side. Both sides of the body share the same answers.
### Leg and foot
| Name on screen | Where to look | Other accepted forms |
| --- | --- | --- |
| Femur | Thigh | thighbone; thigh bone |
| Patella | Front of the knee | kneecap; knee cap |
| Tibia | Lower leg, inner side | shinbone; shin bone |
| Fibula | Lower leg, outer side | calf bone; calfbone |
| Tarsals | Rear foot and ankle | tarsus; ankle bones; tarsal bones |
| Metatarsals | Mid-foot behind the toes | metatarsus; metatarsal bones |
| Toe phalanges | Digits of the foot | toe bones; foot phalanges |
Tarsals identify the rear foot and ankle region; metatarsals lie between the tarsals and toes. The tibia is the inner lower-leg bone, while the fibula is on the outer side.
## Make your own changes
The [source repository](https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest) provides the editable C project. Keep the released disk as a clean copy and work in a separate, writable folder. The source README explains its layout, build configurations, optional authoring dependencies and tests.
In VCC Plus, choose **Develop → C Development…**, then open the folder containing `Makefile`, `main.c` and `vccplus-project.json`. Select **Release** and choose **Build**. The declared recipe creates the game disk. Use **Show Build Products** to locate `build/BONEQ.dsk` and `build/BONEQ.bin` in the build snapshot, then test your new disk using the setup in [Get the game running](#get-the-game-running).
VCC Plus supplies the supported compiler and build tools. Ordinary builds need no Xcode, Command Line Tools, Homebrew or separate compiler installation. The generated anatomy metadata and `BONES.DAT` drawing data are retained in the source; normal builds do not run an SVG renderer.
For optional artwork regeneration, the source README lists Python 3, Pillow and `rsvg-convert`. Optional host logic tests need a host C compiler. These requirements are separate from opening and building the game in VCC Plus.
If you connect ChatGPT to a personal project copy, review which files it shares and enable the project's Makefile workflow for that connection. Keep private connection files out of anything you distribute. Review suggested edits, build and test separate copies before replacing a disk you want to keep.
## Troubleshooting
| What you see | What to check |
| --- | --- |
| **Requires 512 KB CoCo 3 in BASIC.** | Use a CoCo 3 with at least 512 KB and ordinary BASIC text mode. Preserve guest work, then cold restart before loading. A 128 KB setup is insufficient for this edition. |
| `DOS` does not start the game | Confirm the complete `BONEQ.DSK` is in FD0, with CoCo 3 Disk BASIC and an FD-502 controller. Cold restart and try `DOS` again, or use the explicit `LOADM` command above. |
| **Cannot load BONES.DAT from drive 0.** | Use an intact copy of the supplied disk in FD0. Do not copy only `BONEQ.BIN` to another disk: the drawing file must be present too. A missing, damaged or wrong-size drawing file is rejected. |
| Keys seem unresponsive | Click the CoCo display or use **Input → Focus CoCo Display**. Release the previous key before pressing a new one. |
| Typed feedback seems stuck | It waits for you. Read the name, release the old key and press `Space`, or use a quit key. |
| An answer is marked wrong | Check the highlighted structure, spelling and the accepted forms in the reference. Case and extra spaces are ignored; arbitrary abbreviations, punctuation and broad group names are not. |
| White anatomy appears unchanged after a correct answer | This is expected. White covers normal and correct structures; the feedback and score confirm correctness. Red records misses and yellow marks the current question. |
| A hand appears on the other side | The skeleton faces you, so its left hand is on the right of your screen. Left and right counterparts share each question. |
| There is no sound | Check VCC Plus's audio controls, Mac volume and selected audio output. The game uses built-in CoCo sound and needs no add-on cartridge. |
| You want to leave before question 28 | Press `Q`, `Esc` or CoCo `BREAK`. These quit; they are not reveal shortcuts. |
| A previous score is missing | Scores are not saved. A new game, quit or machine restart clears the session. |
## Credits and licenses
Press `C` at the title for **A JOURNEY THROUGH THE SKELETON**. Press `Space` to return. The screen identifies the skeleton artist, source, adaptations, game foundation and font/boot author.
![The credits identify LadyofHats's public-domain skeleton, the Capital Quest foundation, and the font and boot helper.](images/credits.png)
The original [Human skeleton front en.svg](https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg) is by **Mariana Ruiz Villarreal (LadyofHats)**, released into the public domain by its author. Bone Quest removes the printed labels, adapts the artwork to the CoCo's pixel proportions, preserves linework and rib gaps, recolors it and prepares compact structure masks and enlarged views. The anatomical left thumb's pose is relaxed toward the palm while retaining its bone lengths and relative joints. The original SVG is retained unchanged. The artist's inclusion does not imply endorsement.
Bone Quest is based on Brian Holman's **Capital Quest**, with assistance from ChatGPT/Codex. The anatomy bank and skeletal artwork replace its geography content. Pierre Sarrazin's **font5x8** and the **autostart.c 0.1.2** boot-helper foundation retain their public-domain notices. CMOC, LWTools and the linked runtime, keyboard, file and bank libraries retain their own authorship and file-specific terms. The game's local high-resolution graphics driver adapts VCC Plus's GPL graphics source.
The source includes `assets/CREDITS.md`, the original SVG/source receipt and component notices. Preserve them when sharing modified copies. Matching component sources and their provenance are linked from the project's [source and component notes](https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest/src/branch/main/docs/PROVENANCE.md).
The game and this manual are released under the **GNU General Public License, version 3 or later**. This manual is © Brian K. Holman 2026. That license statement does not relicense the public-domain artwork or replace any component's own notice.
The screenshots are unmodified guest frames from the released disk in VCC Plus. Some practice answers were deliberately wrong to demonstrate feedback, red marks and review; their example scores are not required targets.
+33
View File
@@ -0,0 +1,33 @@
# Bone Quest player manual source
BONEQUEST.md is the authoritative plain GFM player manual. manual.json holds the
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 and GPL-3.0-or-later. Artwork and components
retain their own notices; see assets/CREDITS.md and docs/PROVENANCE.md.
Generate the PDF with VCC Plus's shared documentation exporter, not a separate
game-specific renderer. From the VCCPlus checkout:
```sh
python3 tools/documentation/export_pdf.py prepare /path/to/BoneQuest/docs/manual/BONEQUEST.md \
--metadata /path/to/BoneQuest/docs/manual/manual.json --toc \
--destination /path/to/ignored-output/Bone-Quest-Manual.pdf
```
Inspect every rendered page, caption and link, then run the exporter's
publish REVIEW_DIRECTORY --reviewed action. Source/metadata/image/template
changes invalidate the review. Generated PDF/review outputs remain outside Git.
The website imports an explicit source snapshot with scripts/import-project-manual.py,
slug bone-quest, this Markdown/metadata and the exact reviewed PDF. The shared
site layout owns the online presentation and disk/source/PDF actions. The reading
route is https://vccplus.brianholman.com/games/bone-quest/ . Import and local PDF
export do not publish software or create a VCC Plus app build.
The November 11, 2026 release PDF has 20 pages. All page images were visually
reviewed, and the disk/source cover actions and internal contents links were
checked. pdf-review.json records the exact PDF, source, metadata and disk hashes.
The local reviewed artifact is retained outside Git at
`test-output/manual-release/Bone-Quest-Manual.pdf`.
Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

+14
View File
@@ -0,0 +1,14 @@
{
"title": "Bone Quest for CoCo",
"subtitle": "A player’s guide to the 28 structures, both quiz modes, 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 Bone Quest title screen, captured in VCC Plus.",
"running_title": "Bone Quest for CoCo · Player’s manual",
"brand": "VCC Plus Documentation",
"disk_url": "https://vccplus.brianholman.com/dl/software/CoCoLibrary/Exclusives/BoneQuest/2026-11-11/373a3f387daf/BONEQ.DSK",
"source_url": "https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest",
"access_note": ""
}
+27
View File
@@ -0,0 +1,27 @@
{
"title": "Bone Quest for CoCo",
"date": "2026-11-11",
"pages": 20,
"reviewed": true,
"pdfSHA256": "8c42b44c73b8d93007531be7e2ebcd185594f743ff16623a711b9d2e2b729681",
"pdfBytes": 372715,
"manualSHA256": "c1ffeae0eeb1cb0284edb2aade29ba15c080407f3a119fa30f3888abe684b342",
"metadataSHA256": "6eef50f3cdca69a496a4156005e7212541386e0425678939b6130b3676afdb95",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"screenshots": 13,
"visualReview": "Every page inspected; final pages 11–13 refined and reviewed; other final page PNGs byte-identical to inspected initial render.",
"links": {
"external": [
"https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg",
"https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest",
"https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest/src/branch/main/docs/PROVENANCE.md",
"https://vccplus.brianholman.com/dl/software/CoCoLibrary/Exclusives/BoneQuest/2026-11-11/373a3f387daf/BONEQ.DSK",
"https://vccplus.brianholman.com/games/bone-quest/"
],
"internalAnnotationCount": 15
},
"source": "docs/manual/BONEQUEST.md",
"metadata": "docs/manual/manual.json",
"screenshotReceipt": "docs/manual/screenshots.json",
"generator": "VCC Plus shared Markdown PDF exporter"
}
+210
View File
@@ -0,0 +1,210 @@
[
{
"file": "images/title.png",
"sourceCapture": "6809-title.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "8cd34f02ac0d4ee433e83e2666121daa2c32166b366c171c301a0e831e948222",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/progress-skeleton.png",
"sourceCapture": "6809-mc-27-RIBS.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "d7815e218ff50750556362739f2e096bd3a415a60de20ddb81b1fcfa74a7a3bf",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/head-detail.png",
"sourceCapture": "6809-mc-04-ORBIT.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "05b796dd8bb74979924b4b4af4c2ec10b2f06582a56b1bf5d13a1a61aad9f874",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/hand-detail.png",
"sourceCapture": "6809-mc-20-FINGERS.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "9adca4eed509d5bed1bf1497a1518c91b69cc1b52de0c373a29b0d037101fdf6",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/multiple-choice.png",
"sourceCapture": "6809-mc-21-FEMUR.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "34d5b38fb60a7ec031501c3997f930bf7ae78d70abbf2644a371fffd5a9e2c8c",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/correct-feedback.png",
"sourceCapture": "6809-typed-feedback-01.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "2ef370aaf148e4048bcaf182791f50bf115e1b4bd66728470963e08eaf94c6e5",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/typed-entry.png",
"sourceCapture": "6809-typed-alias.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "04b0149afa66c37ab2aa985bac30a92b24868bbf16f40cb01047c5ac4eea0d77",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/spelling-retry.png",
"sourceCapture": "6809-spelling-retry.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "c60f4913af5ef5958c23f7fa2ffc1fe5a1eb68175b27864fb72a8d2bbbd0e44e",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/input-limit.png",
"sourceCapture": "6809-input-limit.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "177e9643b32444a20e89bd841c0453734ad42c070be12deca1e69d7fa032f831",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/incorrect-feedback.png",
"sourceCapture": "6809-typed-feedback-03.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "1f3e77e3004b433dbf8f7e6dbf74331086433dd76c641ea65e7d244e3c9659a4",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/results.png",
"sourceCapture": "6809-typed-results.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "2dee6d6c16b4bd0fb942dd466ab814f418dc875f81c76fe845428740c826f1af",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/missed-review.png",
"sourceCapture": "6809-typed-review.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "6e81b8b7a95aad126c0af2ac59a6ec51f8307ec2cb7c71a284678ce6fcd6bd55",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
},
{
"file": "images/credits.png",
"sourceCapture": "6809-credits.png",
"width": 640,
"height": 480,
"guestWidth": 640,
"guestHeight": 225,
"sha256": "daa72892b604d6a835b5a5bb808cc1a6e9633c5e5afa0a1a26fbc12e6d750d11",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Deliberate incorrect answers demonstrate feedback and review."
}
]
+190
View File
@@ -0,0 +1,190 @@
#!/usr/bin/env python3
# SPDX-License-Identifier: GPL-3.0-or-later
"""Create deterministic Bone Quest release packages from reviewed local inputs.
Does not publish, mutate Git, run a game or modify source inputs. The optional
qualification rebuilds an extracted starter in fresh configuration directories.
Use --libraries-only to freeze the companion URL before finalizing the manual.
"""
import argparse
import hashlib
import json
import os
from pathlib import Path
import re
import shutil
import subprocess
import tempfile
from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo
ROOT=Path(__file__).resolve().parents[1]
APPROVED_DISK='373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba'
EDITION='2026-11-11'
BASE='https://vccplus.brianholman.com/dl/software/CoCoLibrary/'
PROJECT='https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest'
ROOT_FILES=('AGENTS.md','LICENSE','Makefile','README.md','.gitignore','.gitattributes','vccplus-project.json','main.c')
DIRECTORIES=('src','data','assets','tests','tools','docs/manual')
EXTRA_FILES=('docs/PROVENANCE.md','docs/PUBLIC_RELEASE.md','docs/ANATOMY.md','docs/IMPLEMENTATION.md')
BAD_SUFFIXES={'.dsk','.rom','.bin','.o','.a','.pdf','.zip','.pyc','.map','.link','.lst','.log','.ecb_o','.dylib','.so','.exe'}
def sha(data):return hashlib.sha256(data).hexdigest()
def dump(path,value):path.write_text(json.dumps(value,indent=2)+'\n')
def record(path):return dict(bytes=path.stat().st_size,sha256=sha(path.read_bytes()))
def write_zip(path,files):
if path.exists():raise ValueError('Retain completed packages unchanged; choose a fresh output: '+str(path))
with ZipFile(path,'x',ZIP_DEFLATED,compresslevel=9) as archive:
for name,data in sorted(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;info._compresslevel=9
archive.writestr(info,data)
def regular(path):
if path.is_symlink() or not path.is_file():raise ValueError('Expected a regular file: '+str(path))
return path.read_bytes()
def source_files(root):
names=set(ROOT_FILES+EXTRA_FILES)
names.update(p.name for p in root.glob('*.h'))
for directory in DIRECTORIES:
folder=root/directory
if not folder.is_dir():raise ValueError('Missing source directory: '+directory)
for path in folder.rglob('*'):
if path.is_symlink():raise ValueError('Source symlink is not permitted: '+str(path))
if path.is_dir():continue
if '__pycache__' in path.parts or path.name=='.DS_Store':continue
names.add(path.relative_to(root).as_posix())
result={}
for name in sorted(names):
path=root/name
if any(word in name.casefold() for word in ('connection','vccgrant')):raise ValueError('Private connection filename: '+name)
if path.suffix.casefold() in BAD_SUFFIXES:raise ValueError('Generated/private binary is not starter source: '+name)
result['BoneQuest/'+name]=regular(path)
return result
def library_files(root):
inventory=json.loads(regular(root/'SOURCE_INVENTORY.json'))
expected=inventory['sourceFilesSHA256']
for name,value in expected.items():
if sha(regular(root/name))!=value:raise ValueError('Library source input changed: '+name)
result={}
for path in sorted(root.rglob('*')):
if path.is_dir():continue
name=path.relative_to(root).as_posix()
if '__pycache__' in path.parts or path.name=='.DS_Store':continue
if path.suffix.casefold() in BAD_SUFFIXES:raise ValueError('Compiled/private companion input: '+name)
if name!='SOURCE_INVENTORY.json' and name not in expected:raise ValueError('Unrecorded library source input: '+name)
result['BoneQuest-Library-Sources/'+name]=regular(path)
return result
def url(area,digest,name):return BASE+area+'/Exclusives/BoneQuest/'+EDITION+'/'+digest[:12]+'/'+name
def resource(path,area):
r=record(path);return dict(url=url(area,r['sha256'],path.name),sha256=r['sha256'],byte_size=r['bytes'])
def qualify(source_zip,out,toolchain):
reports=[];env=dict(os.environ,PATH=str(toolchain/'bin')+':/usr/bin:/bin',LC_ALL='C',
DEVELOPER_DIR='/no-host-developer-tools',SDKROOT='/no-host-sdk')
for config in ('Release','Debug','Test'):
folder=out/('qualify-'+config);folder.mkdir()
with ZipFile(source_zip) as archive:archive.extractall(folder)
project=folder/'BoneQuest'
with (folder/'build.log').open('w') as log:
subprocess.run([str(toolchain/'bin/make'),'-j4','VCC_CONFIGURATION='+config,'disk'],cwd=project,env=env,stdout=log,stderr=subprocess.STDOUT,check=True)
disk=project/'build/BONEQ.dsk';mp=(project/'build/BONEQ.map').read_text()
end=re.search(r'Symbol: program_end .*?= ([0-9A-Fa-f]+)',mp)[1]
r=dict(configuration=config,programEnd=end,diskSHA256=sha(disk.read_bytes()),ordinaryBuildWithoutAuthoringTools=True)
if config=='Release' and r['diskSHA256']!=APPROVED_DISK:raise ValueError('Extracted Release differs from approved disk')
reports.append(r)
return reports
def main():
p=argparse.ArgumentParser(description=__doc__)
p.add_argument('--source-root',type=Path,default=ROOT)
p.add_argument('--library-sources',type=Path,required=True)
p.add_argument('--output',type=Path,required=True,help='A fresh retained output directory')
p.add_argument('--revision',help='Exact reviewed source revision, recorded in publication descriptor')
p.add_argument('--pdf',type=Path,help='Reviewed final manual PDF, required for a full release')
p.add_argument('--cover',type=Path,help='Unmodified guest title PNG (defaults to docs/manual/images/title.png)')
p.add_argument('--libraries-only',action='store_true')
p.add_argument('--qualify',action='store_true',help='Rebuild extracted starter in all three configurations')
p.add_argument('--toolchain',type=Path,default=Path('/Applications/VCC Plus.app/Contents/Resources/Toolchain'))
a=p.parse_args();root=a.source_root.resolve();out=a.output.resolve();libraries=a.library_sources.resolve()
if out.exists():p.error('Use a fresh output directory; retain completed outputs unchanged')
if root==out or out in root.parents:p.error('Output must not contain the source checkout')
if root in out.parents and out.relative_to(root).parts[0] not in ('test-output','.release'):
p.error('Keep package output outside the source tree or beneath ignored test-output/.release')
if not a.libraries_only and (not a.pdf or not a.revision):p.error('Full release needs --pdf and --revision')
if a.revision and not re.fullmatch(r'[0-9a-f]{40}',a.revision):p.error('Use a full 40-character source commit')
out.mkdir(parents=True)
library_zip=out/'Bone-Quest-Library-Sources.zip';write_zip(library_zip,library_files(libraries))
library_resource=resource(library_zip,'Sources')
if a.libraries_only:
dump(out/'ARTIFACTS.json',{library_zip.name:record(library_zip)})
print(json.dumps(library_resource,indent=2));return
disk_bytes=regular(root/'BONEQ.DSK')
if sha(disk_bytes)!=APPROVED_DISK:raise ValueError('Approved BONEQ.DSK identity changed')
(out/'BONEQ.DSK').write_bytes(disk_bytes)
source_zip=out/'Bone-Quest-Source.zip';files=source_files(root);write_zip(source_zip,files)
r=record(source_zip)
manifest=dict(schemaVersion=1,projectDirectory='BoneQuest',configurationFile='BoneQuest/vccplus-project.json',entrySource='main.c',
archive=source_zip.name,byteSize=r['bytes'],sha256=r['sha256'],
files=[dict(path=name,byteSize=len(data),sha256=sha(data)) for name,data in sorted(files.items())])
dump(out/'Bone-Quest-Source.manifest.json',manifest)
source_resource=resource(source_zip,'Sources')
notice=('Bone Quest for CoCo - dated edition '+EDITION+'\n\n'
'Designed by Brian Holman with assistance from ChatGPT/Codex.\n'
'Game and manual: GPL-3.0-or-later. Preserve component-specific terms.\n'
'Project: '+PROJECT+'\n'
'Game source starter: '+source_resource['url']+'\n'
'Matching library sources: '+library_resource['url']+'\n'
'Player manual: https://vccplus.brianholman.com/games/bone-quest/\n\n'
'Skeleton: Mariana Ruiz Villarreal (LadyofHats), author\'s public-domain\n'
'dedication via Wikimedia Commons: https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg\n'
'Adaptations remove labels, fit the CoCo pixel aspect, preserve linework,\n'
'assign 28 structure regions, add detail views and relax the left thumb pose.\n'
'The original SVG and source hash are retained; no endorsement is implied.\n\n'
'Font and boot helper: Pierre Sarrazin, public-domain notices retained.\n'
'BControl retains its original keyboard implementation and file-specific\n'
'Color Basic exception. CMOC/VCC Plus SDK sources retain their GPL terms;\n'
'the ROM-backed decbfile library retains its public-domain dedication.\n'
'No ROM or optional standalone Disk BASIC-derived driver is included.\n\n'
'Use a 512 KB CoCo 3, RGB, FD-502 Disk BASIC. Insert BONEQ.DSK in drive 0,\n'
'Cold Restart, then DOS. Q/Escape/Break quit to BASIC; blank Enter reveals.\n'
'This disk is read-only in play; scores are not saved.\n')
(out/'NOTICE.txt').write_text(notice)
native=out/'Bone-Quest.zip';write_zip(native,{'BONEQ.DSK':disk_bytes,'NOTICE.txt':notice.encode()})
pdf_bytes=regular(a.pdf.resolve())
if not pdf_bytes.startswith(b'%PDF-'):raise ValueError('Expected the reviewed PDF')
(out/'Bone-Quest-Manual.pdf').write_bytes(pdf_bytes)
cover=regular((a.cover or root/'docs/manual/images/title.png').resolve())
if not cover.startswith(b'\x89PNG\r\n\x1a\n'):raise ValueError('Expected actual guest PNG cover')
for name in ('cover.png','hero.png'):(out/name).write_bytes(cover)
native_r=record(native);cover_r=resource(out/'cover.png','Artwork/Thumbnails');hero_r=resource(out/'hero.png','Artwork/Thumbnails')
descriptor=dict(schema_version=1,id='vccplus.bone-quest',title='Bone Quest for CoCo',release_id='vccplus.bone-quest.'+EDITION,
game_version=EDITION,publication_status='approved',getting_started=True,browse_categories=['Educational','Games'],primary_browse_category='Educational',category_featured=True,
provenance=dict(kind='project-owned',collection='vccplus-exclusive',author='Brian Holman',license='GPL-3.0-or-later; skeleton public domain; component terms retained',project_url=PROJECT),
disk_package=dict(url=BASE+'Exclusives/BoneQuest/'+EDITION+'/'+APPROVED_DISK[:12]+'/'+native.name,sha256=native_r['sha256'],byte_size=native_r['bytes']),
disk=dict(path='BONEQ.DSK',sha256=APPROVED_DISK,byte_size=len(disk_bytes)),
setup=dict(configuration=dict(profile='disk-basic',processor='6809',ram_kib=512),selected_members=[dict(path='BONEQ.DSK',target='disk0')],command='DOS\r',
validation=dict(scope='runtime-verified',disk_sha256=APPROVED_DISK,app='VCC Plus 3.6.1 (54)',video='RGB',controller='FD-502 Disk BASIC')),
first_play=dict(mode='cold-restart-dos'),links=dict(manual_online='https://vccplus.brianholman.com/games/bone-quest/',manual_pdf=resource(out/'Bone-Quest-Manual.pdf','Documents/Manuals'),source_repository=PROJECT),
source=dict(package=source_resource,project_directory='BoneQuest',configuration_file='BoneQuest/vccplus-project.json',entry_source='main.c',
license_files=['BoneQuest/'+n for n in ('LICENSE','assets/CREDITS.md','assets/BCONTROL-NOTICE.txt','assets/HIRESTXT-NOTICE.txt','assets/VCC-Guest-SDK-NOTICE.txt')]),
artwork=dict(cover=cover_r,hero=hero_r),library_sources=library_resource,source_revision=a.revision,minimum_source_app=dict(version='3.6.1',build=54))
dump(out/'exclusive-title.json',descriptor)
if a.qualify:dump(out/'source-qualification.json',qualify(source_zip,out,a.toolchain.resolve()))
# Only delivery files belong in this inventory, not generated build trees.
dump(out/'ARTIFACTS.json',{p.name:record(p) for p in sorted(out.iterdir()) if p.is_file() and p.name!='ARTIFACTS.json'})
print(json.dumps({'output':str(out),'diskSHA256':APPROVED_DISK,'sourceRevision':a.revision,'librarySources':library_resource},indent=2))
if __name__=='__main__':main()