97 lines
5.6 KiB
Markdown
97 lines
5.6 KiB
Markdown
# Bone Quest for CoCo
|
||
|
||
An anatomy quiz for a 512 KB Color Computer 3, built from Capital Quest's working
|
||
quiz foundation. Identify 28 skeletal structures on a human skeleton,
|
||
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.
|
||
Designed by Brian Holman with assistance from ChatGPT/Codex.
|
||
|
||
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/).
|
||
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.
|
||
|
||

|
||
|
||
## Machine and loading
|
||
|
||
Use a CoCo 3 with 512 KB RAM, BASIC, an FD-502 Disk BASIC controller and a keyboard.
|
||
RGB is the intended color presentation. Insert a copy of BONEQ.DSK in FD0,
|
||
preserve existing guest work, choose Cold Restart, then type DOS at the OK prompt.
|
||
The direct loading command is `LOADM"BONEQ.BIN":EXEC`. The game does not save scores
|
||
or write to its disk. Use disposable copies while developing.
|
||
|
||
## Controls and rules
|
||
|
||
- At any screen, Q, Escape or CoCo Break quits to BASIC, including during
|
||
a question or the automatic feedback pause.
|
||
- Title: 1 multiple choice, 2 typed answers, C credits.
|
||
- Multiple choice: 1–4 selects an answer. The correct slot is chosen randomly from
|
||
the three that were not correct last time; the first question can use any slot.
|
||
Feedback advances automatically after its sound and reading pause.
|
||
- Typed answers: Enter submits, Backspace edits, blank Enter reveals, Space advances
|
||
after feedback. Case and extra spaces are ignored. Common names such as
|
||
collarbone, shoulder blade, thighbone, kneecap, shinbone and tailbone are accepted.
|
||
A close spelling offers R to retry or V to reveal; a corrected answer earns
|
||
one point, with corrections counted separately. A blank answer or reveal counts
|
||
as a miss. The entry limit is 33 characters.
|
||
- Progress: white bones, red missed structures, yellow current. Correct answers
|
||
return to white; feedback and the score confirm success. The full skeleton keeps
|
||
context while a detail panel enlarges the selected area. Dark linework separates
|
||
neighboring bones and individual ribs. Unquizzed anatomy stays white for context.
|
||
- Results: R review, N next review page, B back, P play again, Q quit. Each topic is
|
||
asked once. One correct answer earns one point; percentage is correct/28×100.
|
||
|
||
The quiz follows the 28 labels in the supplied reference: bones, bone groups,
|
||
bone parts and two facial cavities. It does not cover every individual bone
|
||
in an adult skeleton. Paired left/right counterparts share a question. The
|
||
manubrium, sternum body and xiphoid process are separate topics, as are the
|
||
ilium and pubis. Finger and toe phalanges are separate topics;
|
||
bare "phalanges" is deliberately not a complete answer. See docs/ANATOMY.md.
|
||
|
||
## Build
|
||
|
||
Open the folder containing Makefile and vccplus-project.json in VCC Plus's
|
||
Develop → C Development workspace. Select Release and Build, then use Show Build
|
||
Products to locate build/BONEQ.dsk. Normal builds use the installed app's bundled
|
||
CMOC/LWTools/Make/Perl and need no Xcode, Homebrew or asset-generation tools.
|
||
|
||
Equivalent command-line build:
|
||
|
||
```sh
|
||
export PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:$PATH"
|
||
make VCC_CONFIGURATION=Release disk
|
||
```
|
||
|
||
Debug uses optimized code with frame pointers; Test uses deterministic seed 2709.
|
||
Clean between configurations in one working folder. Generated anatomy metadata
|
||
and BONES.DAT are retained for normal builds. Optional asset regeneration needs Python 3, Pillow
|
||
and rsvg-convert; optional host logic tests need a host C compiler.
|
||
After editing data/bones.json or the skeleton artwork, run make assets to refresh
|
||
the retained metadata and drawing data. make test detects stale question data and invalid geometry.
|
||
|
||
## Credits and source
|
||
|
||
Based on Capital Quest by Brian Holman, revision
|
||
[afa6f3c](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/commit/afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6),
|
||
GPL-3.0-or-later. Capital Quest is maintained as a separate project.
|
||
|
||
Skeleton artwork: Mariana Ruiz Villarreal (LadyofHats), author's public-domain
|
||
release via Wikimedia Commons. The original SVG and source receipt are retained.
|
||
Adaptations remove labels, fit the CoCo pixel aspect, preserve bone/rib linework,
|
||
recolor and encode per-topic masks and enlarged detail views. See assets/CREDITS.md and docs/ANATOMY.md.
|
||
|
||
The game remains GPL-3.0-or-later; preserve the full LICENSE and component notices.
|
||
Pierre Sarrazin's font and boot helper keep their public-domain headers. The
|
||
bundled libraries retain their individual terms, including the original BControl
|
||
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.
|