c64-basic/README.md

4 KiB

C64 BASIC Collection

Ten small, polished programs for the Commodore 64, written entirely in stock Commodore BASIC V2. The collection mixes arcade action, puzzles, simulations, creative tools, sound, and visual effects. No cartridge, BASIC extension, or machine-language payload is required.

Programs

Program Type Controls Description Run locally
Meteor Dodge Arcade A, D, Q Dodge falling meteors and build your score. Run program
Code Breaker Logic Digits, Q Deduce a four-digit secret in ten guesses. Run program
Submarine Hunt Strategy Coordinates, Q Find three hidden submarines with limited sonar shots. Run program
Lunar Lander Simulation 0-9, Q Choose engine burns and touch down gently. Run program
Memory Matrix Memory 1-4, Q Repeat a growing sequence of flashing quadrants. Run program
Robot Maze Puzzle W, A, S, D, Q Navigate a freshly generated maze to its exit. Run program
Music Box Music A-K, 1-3, Q Play the SID chip as a small computer keyboard. Run program
Pixel Painter Creative Cursor keys, Space, C, Q Draw character-cell pictures on the screen. Run program
Stock Trader Simulation B, S, W, Q Trade a volatile stock over twenty market days. Run program
Starfield Demo 1-3, Q Watch and control a layered animated starfield. Run program

Running the programs

Start the local browser app with Docker Compose:

docker compose up --build -d

Open http://localhost:8134, or click a Run program link in the table. The app runs the VICE x64sc core through WebAssembly and downloads the selected PRG through its own backend, avoiding browser CORS restrictions. Click inside the emulator to enable keyboard input and sound.

The app reads the public repository tree at runtime. New .prg files pushed to the configured branch appear after clicking Refresh list; rebuilding the Docker image is not required. Repository, branch, and host port settings live in .env, where the default host port is 8134.

Each directory contains an editable, line-numbered .bas listing and a matching tokenized .prg file. The PRGs use the normal C64 BASIC load address, $0801.

On a Commodore 64, transfer a PRG to disk or another supported medium, then use:

LOAD"METEOR-DODGE.PRG",8
RUN

Substitute the filename and device number as needed. In VICE or another C64 emulator, drag a PRG into the emulator window or use its autostart command.

Source format

The .bas files are plain ASCII for comfortable reading and editing on a modern computer. They use uppercase BASIC V2 keywords and avoid embedded control-code glyphs. Their corresponding .prg files contain the tokenized PETSCII program that the C64 loads directly.

All programs are self-contained and designed for an ordinary PAL or NTSC Commodore 64. Randomized programs seed BASIC's random-number generator from the machine clock, so every session is different.