135 lines
6.3 KiB
Markdown
135 lines
6.3 KiB
Markdown
# 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.**
|