# 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 [QUADPSL02.DSK](QUADPSL02.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 02**; the next changed delivery will be build 03. 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. Build 02 corrects joystick fire being mistaken for keyboard actions and allows horizontal movement when only X has centered. Host regressions and official keyboard smoke checks pass; actual joystick confirmation remains pending. See [joystick correction](docs/JOYSTICK_FIX.md).