# 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. - **[Download the game disk - QUADPSL05.DSK](https://vccplus-git.brianholman.com/VCCPlusApps/Quadrapassel/raw/commit/49bc78158a5e17ba717381a3a2cbb4ab35c36dfe/QUADPSL05.DSK)** - **[Read the illustrated player's manual and download its PDF](https://vccplus.brianholman.com/games/quadrapassel/)** - **[Browse or clone the public source repository](https://vccplus-git.brianholman.com/VCCPlusApps/Quadrapassel)** The disk link identifies the exact build-05 delivery. The repository also contains its [Markdown manual and real emulator screenshots](docs/manual/QUADRAPASSEL.md). ## 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: ```basic PCLEAR1 LOADM"QUAD.BIN" EXEC ``` ## Build with the downloaded VCC Plus app Get the public [VCC Plus for Mac](https://vccplus.brianholman.com/downloads/) 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](docs/VCC_PLUS_WORKFLOW.md) 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: ```sh 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: ```sh 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](START_HERE.md) provides a portable prompt for an existing checkout. The [MCP setup guide](docs/MCP_SETUP.md) 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](AGENTS.md), the [behavioral specification](SPECIFICATION.md), [provenance](docs/PROVENANCE.md) and [memory contract](docs/MEMORY_LAYOUT.md) 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](COPYING) and [PROVENANCE.md](docs/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.**