Support VCC Plus builds with verified disk and MCP screenshots

This commit is contained in:
Brian Holman committed 2026-11-09 23:19:55 -07:00
1 parent 5a725e2a5b
commit 42bf10fb87
12 files changed
+788 -19

No files matched your search

+54
View File
@@ -0,0 +1,54 @@
# CoCoSmash
Pierre Sarrazin’s CoCo arcade shooter, adapted for development in **VCC Plus**
with its bundled CMOC toolchain. Move the automatic laser with the left/right
arrows, shoot descending objects, and protect your lives and score.
![CoCoSmash title screen captured through VCC Plus MCP](docs/screenshots/title.png)
## Download and play
[Download CoCoSmash.DSK](CoCoSmash.DSK), built and boot-tested using
**VCC Plus 3.5.0 build 43**, on a **512 KB CoCo 3 with a Motorola 6809**.
Mount a writable copy in FD0 under Disk BASIC and type **DOS**. At the title
screen, press **Space** to start or **I** for instructions. Move with the
**left/right arrows**; the gun fires automatically. **Space** jumps to a random
position, **M** toggles sound and **Break** pauses.
![CoCoSmash gameplay captured through VCC Plus MCP](docs/screenshots/gameplay.png)
## Build in VCC Plus
1. Open this repository folder with **Develop → C Development → Open**.
2. Select **Release**, then **Build Disk**. The declared `all` target builds
`cocosmash-0.1.0-coco.dsk` using the bundled tools and library bindings.
3. Launch that built disk with **DOS**. The top-level `CoCoSmash.DSK` is the
separately retained, verified release copy.
MCP builds require **Use Project Makefile**. For isolated boot/input/screenshot
tests, also approve **Allow Disposable Playtests** and export a private
connection outside this repository. Private grants and credentials do not belong
in Git. See [verification details](docs/VALIDATION.md).
## Original source and attribution
**Original author: Pierre Sarrazin. Original version: 0.1.0.**
Source download: [cocosmash-0.1.0.tar.gz](http://sarrazip.com/dev/cocosmash-0.1.0.tar.gz).
The retained original archive’s SHA-256 is
`c4ebc24166a026a0accd5c40a074a95b2c186c7e84bdb654c4b8af8fc48a4072`.
This repository starts with an import of that original archive, followed by
the VCC Plus integration and verification changes. It is an independent
compatibility copy, not an original VCC Plus game.
The integration retains the game code and artwork. Makefile changes allow
bundled library lookup, and `loader-support/runDOSLoader.c` and `.h` supply
Pierre Sarrazin’s public-domain loader support. `vccplus-project.json`, these
instructions, screenshots and the verified DSK complete the VCC Plus package.
The original archive and prior prepared folder remain retained locally.
## License
The game is **GPL-3.0-or-later**; see [COPYING](COPYING) and the original
file headers. Public-domain components retain their own notices. Original
copyright, author and component attributions are preserved. Screenshots show
the original program running through VCC Plus MCP; no emulator ROM is included.