Files
BoneQuest/README.md
T

77 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Bone Quest for CoCo
An anatomy quiz for a 512 KB Color Computer 3, built from Capital Quest's working
quiz foundation. Identify 25 major bones and bone groups on a human skeleton,
choose among four names or type the answer, then review missed questions.
Download the ready-to-test [BONEQ.DSK](BONEQ.DSK). Both complete quiz modes have
been checked in VCC Plus on emulated MC6809 and HD6309 processors.
![Bone Quest identifying the neck vertebrae in the full skeleton and enlarged detail view](docs/images/multiple-choice.png)
## 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
- Title: 1 multiple choice, 2 typed answers, C credits, Q quit to BASIC.
- 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, Esc/CoCo Break 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. The entry limit is 33 characters.
- Progress: teal unanswered, purple correct, red missed, yellow current. The full
skeleton keeps context while a detail panel enlarges the selected area.
- 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/25×100.
The quiz covers 25 named major bones/groups shown by the supplied anterior-view
illustration, not every individual bone in an adult skeleton. Paired left/right
counterparts share a question. 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/drawing C
is 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 C tables. 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. Bone Quest is a separate project; Capital Quest is unchanged.
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, reduce resolution, recolor and encode per-topic masks
and selected 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.