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:
1 parent
8a4b44bc73
commit
d412e35c4e
79 files changed
+4187
-16
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user