Files
Quadrapassel/README.md
T
Brian Holman d412e35c4e 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.
2026-11-11 03:14:14 -07:00

114 lines
5.7 KiB
Markdown

# Quadrapassel for CoCo
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: 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 | 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 |
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
- [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): 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. 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
Based on [GNOME Quadrapassel](https://gitlab.gnome.org/GNOME/quadrapassel) and
[Brian Holman's macOS port](https://github.com/bkholman/quadrapassel-macos).
Preserve the original authors and component notices listed in
[PROVENANCE.md](docs/PROVENANCE.md).
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.