Files

6.3 KiB
Raw Permalink Blame History

Quadrapassel for CoCo

A falling-block game for the Color Computer 3 with 128 KB or more, written in C using CMOC and the VCC Plus development tools. Play with the keyboard or a standard analog joystick, choose Modern or Classic (40.2) scoring, and save your high scores to disk.

The disk link identifies the exact build-05 delivery. The repository also contains its Markdown manual and real emulator screenshots.

Play

  1. Keep the downloaded original and make a writable copy for playing.
  2. Insert or mount that copy in drive 0 of a CoCo 3 with Disk BASIC.
  3. Type DOS and press Enter. Wait for loading and score reading to finish.
  4. Choose START at the title.

The game has been verified in 128 KB CoCo 3 emulation and played successfully on a physical 512 KB CoCo 3. The presentation is 320 × 192 with 16 palette colors, including seven distinct piece colors. More RAM does not select a separate game edition or resolution.

Input Action
Left/Right or A/D Move sideways; hold to repeat
Down or S Soft drop
Up or W Rotate in the preferred direction
Q / E Counterclockwise / clockwise rotation
Space Hard drop
H Hold or swap the piece
P or BREAK Pause and open Actions
Enter Select a menu choice
Joystick left/right, down Move sideways, soft drop
Joystick up or secondary fire Hard drop once per press/neutral cycle
Primary fire tap/release Rotate once on release
Primary fire held about 400 ms Open Actions, including Hold and Settings

The default joystick port is Right; Settings also offers Left and Off. Keyboard menu selection does not disable the selected joystick. The manual explains menu controls, initials entry, calibration and the differences between keyboard Up and joystick Up.

High scores and settings are saved in QPSAVE0.DAT and QPSAVE1.DAT on your playing disk. Each new numbered delivery begins with empty scores and default settings. Preserve older score disks; a new disk does not import their records. Let saves finish before resetting, ejecting or copying the disk.

The manual loading alternative from Disk BASIC is:

PCLEAR1
LOADM"QUAD.BIN"
EXEC

Build with the downloaded VCC Plus app

Get the public VCC Plus for Mac release and the complete repository files. The installed app supplies CMOC, Make, Perl and the disk tools needed by this project; no Homebrew installation is required for the app's build workflow.

  1. Open Develop → C Development… in VCC Plus and open this existing project folder, containing main.c, Makefile and vccplus-project.json.
  2. Keep the supplied project settings and Makefile. Select Release.
  3. Choose Build Disk. Read the build result and memory-bound check.
  4. Use Show Build Products to locate that build's Quadrapassel.DSK and QUAD.bin. The app builds in its own work area.
  5. Use Launch Disk only when you are ready to replace the guest program; save existing guest work and attend to media/restart prompts first.

Release is required for the delivered memory layout. Do not increase linker limits or reduce the stack reserve to make another configuration fit. A fresh anonymous checkout has reproduced the delivered build using the public VCC Plus 3.6.1 bundled Release toolchain. See the build workflow for native building, ChatGPT connections and validation.

If you prefer the command line, use the toolchain from the installed app. With VCC Plus in the standard Applications folder, run from a complete checkout:

git clone https://vccplus-git.brianholman.com/VCCPlusApps/Quadrapassel.git
cd Quadrapassel
env PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:/usr/bin:/bin" make

The Makefile defaults to Release and builds Quadrapassel.DSK. An explicit make VCC_CONFIGURATION=Release disk selects the same configuration/action. The native workspace should still be set to Release when building there.

For optional host-side rule, input, persistence and rendering regressions:

python3 tools/test_rules.py
python3 tools/test_components.py
python3 tools/test_video.py

Those developer checks require Python and a suitable host C compiler; they are separate from building or playing through the installed app.

Develop with ChatGPT

Start here provides a portable prompt for an existing checkout. The MCP setup guide explains scoped C-project access, installed manual searches and the separate Archive Library connection. Discover and verify the tools exposed by your installed app rather than copying an old project ID or connection file.

Read AGENTS.md, the behavioral specification, provenance and memory contract before changing the implementation. Dated investigation/build records preserve their original observations; the current manual and these entry guides describe the supported product and workflow.

Independent implementation, credits and license

This clean-room CoCo implementation was written anew in C from a behavioral specification to be functionally similar to Quadrapassel for Linux and Mac. No Linux or Mac application source code is incorporated into the CoCo game. The name was retained for branding continuity. The specification and reference piece/scoring data preserve their GPL provenance and contributor credits.

Game source and documentation are GNU GPL version 3 or later; see COPYING and PROVENANCE.md. GNOME Quadrapassel's original contributors, Brian Holman's Mac and CoCo work, Federico Poloni's Bastet algorithm, and Pierre Sarrazin's font and CMOC libraries are acknowledged. Individual third-party components retain their own notices; the CardGame font subset is public domain.

© Brian K. Holman 2026.