Integrate CoCo Letters with VCC Plus and verified board startup

Add project library bindings, delivered CoCoLetters.DSK, actual board screenshots and installed build-43 public-MCP validation. Preserve upstream application sources and original notices.
This commit is contained in:
Brian Holman committed 2026-11-09 23:39:35 -07:00
1 parent 4cedb2d94a
commit a1b27b2233
12 files changed
+478 -32

No files matched your search

+36 -21
View File
@@ -1,36 +1,51 @@
# Word Game
# CoCo Letters
Copyright © 2026 Pierre Sarrazin <http://sarrazip.com/>
A word game for the Color Computer 3 by **Pierre Sarrazin**. This repository
contains upstream version **0.1.0** with a VCC Plus project and playable disk.
License: GNU GPL v3 or later, except where stated otherwise.
See file COPYING.
![CoCo Letters board and letter rack running in VCC Plus](docs/screenshots/gameplay.png)
Home page: <http://sarrazip.com/dev/FIXME.html>
## Download and run
Insert the floppy disk that contains this game in drive 0,
then type DOS and press the Enter key.
Download [CoCoLetters.DSK](CoCoLetters.DSK). Mount a writable copy in drive 0 of a
**512 KB CoCo 3 / 6809 / Disk BASIC** machine and type:
```basic
DOS
```
# Requirements
Allow the dictionary to finish loading. Choose **R** for an RGB monitor, **E**
for easy difficulty and **U** to take the first turn. The board then shows the
letter rack and cursor. Follow the on-screen arrow/Enter instructions; **?**
opens help and **Break** opens options.
## Hardware
## Build in VCC Plus
* CoCo 3.
* RGB monitor.
* Floppy disk controller.
1. Open this repository’s root folder in **Develop → C Development → Open**.
2. Select **Release**, then choose **Build Disk**.
3. Use **Show Build Products** to find `coco-letters-0.1.0.dsk` in the build
snapshot. Mount a writable copy and type `DOS`.
The declared disk target is `all` in `Makefile`. The supplied `CoCoLetters.DSK` is
this disk image under a short download filename. VCC Plus provides the bundled
compiler, disk tools and supported target libraries.
## Software
The disk build and illustrated run were verified through the public MCP
interface in **VCC Plus 3.5.0 build 43**. [Validation details](docs/VALIDATION.md)
describe the observed behavior and its limits.
These libraries are needed to build this game from its source code:
## Original source
* decbfile (>= 0.1.13)
* bcontrol (>= 0.1.6) (keyboard and joystick support)
* bsound (>= 0.1.4) (sound)
- Author: [Pierre Sarrazin](http://sarrazip.com/).
- [Project page](http://sarrazip.com/dev/coco-letters.html).
- [Version 0.1.0 source archive](http://sarrazip.com/dev/coco-letters-0.1.0.tar.gz).
- Archive SHA-256: `ad7c7771845e1a35014644fb562634a558abee632e1d7738683db6e9e9e46b94`.
They can be obtained from the CMOC Home Page.
The [original README](docs/UPSTREAM_README.md) and source notices are preserved.
See [source provenance](docs/PROVENANCE.md) for the import and integration history.
## License
# Version history
0.1.0 20??-FIXME First public release.
The application is licensed under **GPL-3.0-or-later**, except where individual
files state otherwise. Fonts, loader and word-list files retain their separate
public-domain notices. See [COPYING](COPYING) and the original source notices.