55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# 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.
|
||
|
||

|
||
|
||
## 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.
|
||
|
||

|
||
|
||
## 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.
|