Implement CoCo 3 Quadrapassel and deliver build 01

Add gameplay, keyboard/joystick controls, disk-backed high scores and settings,
standard CMOC effects, and the approved C graphics renderer. Include the clearer
attributed font, title/credits updates, source-verified Modern and Classic (40.2)
scoring, meaningful regression fixtures, and recorded guest validation.

Deliver QUADPSL01.DSK with fresh high scores. Retain source, licenses and selected
guest evidence; exclude personal disks, private connections and build scratch.

Host rules/input/persistence/video checks and memory guards pass. Official
512 KB playtests pass the recorded checks; actual 128 KB/physical joystick
qualification and the normal-window buzzing retest remain pending.
This commit is contained in:
Brian Holman committed 2026-11-11 03:14:14 -07:00
1 parent 8a4b44bc73
commit d412e35c4e
79 files changed
+4187 -16

No files matched your search

+81 -10
View File
@@ -1,18 +1,22 @@
# Quadrapassel for CoCo
A specification for bringing Quadrapassel to the Tandy Color Computer in C,
A CoCo 3 implementation of Quadrapassel in C,
using CMOC and the installed VCC Plus development tools.
Build this candidate with the **Release** configuration.
**Status: specification and implementation prompt ready for Brian's review.
Game implementation has not started. No playable DSK is included yet.**
**Status: CoCo 3 implementation in progress. A playable stage has run in official
VCC Plus 3.6.0 (51), with earlier gameplay/persistence checks on 3.5.5 (48). Persistent high scores/settings have saved and reloaded after cold boot on the
official 512 KB MC6809 playtest. Brian also reported successful play on a physical
512 KB CoCo 3 on November 11, 2026. A clean game disk is available; actual
128 KB qualification is pending.**
| Target | Experience |
| --- | --- |
| CoCo 3, 128 KB | Primary target: complete game, seven distinct piece colors, keyboard and joystick |
| CoCo 2, 64 KB | Same game rules and controls, with a lower-color presentation |
| CoCo 2, 64 KB | Future adaptation; not included in this candidate |
| CoCo 3, 512 KB or more | Runs the baseline game; enhancements only when they offer a measured benefit |
The intended delivery is one floppy image, `Quadrapassel.DSK`, with a convenient
Deliveries use `QUADPSLxx.DSK`, with a two-digit build number and a convenient
DOS launcher and a documented manual launch path. RAM sizes above are **KB**.
## Start here
@@ -20,14 +24,41 @@ DOS launcher and a documented manual launch path. RAM sizes above are **KB**.
- [START_HERE.md](START_HERE.md): prompt for a separate chat within the existing VCC Plus project.
- [SPECIFICATION.md](SPECIFICATION.md): self-contained game behavior and acceptance requirements.
- [AGENTS.md](AGENTS.md): development boundaries and required exception review.
- [VCC Plus workflow](docs/VCC_PLUS_WORKFLOW.md): official build 48, MCP, manuals, API and archive access, and testing.
- [VCC Plus workflow](docs/VCC_PLUS_WORKFLOW.md): approved official build 51, MCP, manuals, API and archive access, and testing.
- [Implementation stages](docs/IMPLEMENTATION_PLAN.md): deliverables and verification checkpoints.
- [Provenance](docs/PROVENANCE.md): source revision, credits, licenses and reference data.
Use standard CMOC APIs first. Assembly and custom low-level work outside those
APIs require review by Brian and the coordinating chat before implementation.
The implementation chat must not inspect VCC Plus internals or the Mac port's
source. The supplied specification is its behavioral reference.
Use standard CMOC APIs first. Brian approved a narrowly scoped C graphics
exception; its exact scope and measured evidence are in [DECISIONS.md](docs/DECISIONS.md).
Other low-level exceptions still require review before implementation.
VCC Plus internals remain outside scope. The supplied specification is the
behavioral reference, with Brian's explicit read-only exception for checking
the Mac port's scoring source recorded in AGENTS.md.
## Current development checks
The current priority is the complete CoCo 3 game with 128 KB support. CoCo 2 work
will follow after that version is working and tested. See the
[implementation status](docs/IMPLEMENTATION_STATUS.md),
[MCP setup](docs/MCP_SETUP.md), and [memory layout](docs/MEMORY_LAYOUT.md).
Host complements to the official-app build/playtest workflow:
```sh
python3 tools/test_rules.py
python3 tools/test_components.py
python3 tools/test_video.py
```
Keyboard: arrows or A/D move, Down/S soft drop, Up/W preferred rotation, Q/E
counterclockwise/clockwise, Space hard drop, H hold, P pause, Enter select, BREAK
back/pause. The title also accepts Space. A short joystick fire press rotates on
release; holding fire for 400 ms opens actions, including Hold and Settings.
High scores are designed to reload from `QPSAVE0.DAT`/`QPSAVE1.DAT` on the game
disk. The two-slot store covers all difficulty/normal-or-difficult categories and
reports write failures. Guest save/reload has passed on official build 48 / MC6809 / 512 KB. See the
[128 KB manual check](docs/TESTING_128K.md) for the remaining target validation.
## Credits and license
@@ -40,3 +71,43 @@ Specification text and derived piece/reference data are provided under
**GPL-3.0-or-later**; see [COPYING](COPYING). The supplied title image is a design
reference with a separate notice in the provenance document. No Mac application,
ROM, emulator implementation, or third-party sound payload is included.
## Run the current CoCo 3 disk
Mount a writable copy of [QUADPSL01.DSK](QUADPSL01.DSK) in drive 0 and type
`DOS`. Keep the downloaded original pristine. The current build targets the
CoCo 3; CoCo 2 adaptation is deferred. Allow disk loading and explicit saves to
finish before the next action. High scores/settings use QPSAVE0.DAT and
QPSAVE1.DAT; QPTEXT.DAT contains read-only menu text.
Each numbered build starts with empty high scores and default preferences.
Existing personal score disks remain untouched; scores are not copied into the
new build. The current delivery is **build 01**; the next changed delivery will
be build 02. See [build records](docs/BUILDS.md). The official recipe still uses
Quadrapassel.DSK as its clean staging artifact.
The separately verified manual fallback on the 512 KB test machine is:
```basic
PCLEAR1
LOADM"QUAD.BIN"
EXEC
```
Audio is explicitly muted between brief effects, including during analog
joystick sampling, using standard CMOC library calls. See
[audio validation](docs/AUDIO_VALIDATION.md) for direct MCP capture results and
the remaining actual-application retest.
## November 11 visual update
The menu and HUD now use Pierre Sarrazin's public-domain CardGame font, with
attribution and original source retained. Modern blocks have dark gray outlines
(RGB 1,1,1); the background remains black. The title credit is
`(c) 2026 Brian Holman` (rendered in the font's uppercase character set).
The font/border pixel fixtures and enforced memory bounds pass. Current official
app qualification and disk identities are recorded in [the latest update](docs/TITLE_AND_SCORING_UPDATE.md).
Settings names the scoring choices **Modern** and **Classic (40.2)**. Switching
changes the next game and defaults to keeping existing high scores. Both
formulas match the supplied Mac source. The reported normal-window buzz remains
unconfirmed fixed; isolated audio is quiet between effects.