Files

53 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` contains the
verified release build.
For MCP builds, enable **Use Project Makefile** in the C Assistant panel.
Enable **Allow Disposable Playtests** to test the app and capture screenshots
through MCP. 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).
Source archive SHA-256:
`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.
## 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.