1984 · First Star Software
The pages describe a disk image named C64.COM holding the program BOULDER DASH, a re-packaged copy with a BASIC stub and a copier in front of the game; its title screen reads “(C)1984 First Star Software Inc.” The game is one load, and the addresses on these pages are those after the copier has moved it to $5000-$8FFF. The Source tab's listing is built from memory saved a few seconds into cave A, level 1. No other release was compared. No game image is hosted here.
The game's menu screen shows two names: “BY PETER LIEPA” and “WITH CHRIS GREY”. The credits below come from the sources named beside them.
The write-up, facts and symbol map are available under CC BY-SA 4.0; code is under MIT.
| Tier | silver |
|---|---|
| Coverage | 100 % of the bytes the game uses have a description |
| Comments checked | Audited & high error rate. Every comment was audited once, but the last sample of 60 comments had 4 wrong, more than one in 30, so between 3 and 16 % of the listing’s comments are likely wrong. How listings are checked |
| Build analysed | Re-packaged disk named C64.COM: one program, BOULDER DASH, 16,499 bytes, a BASIC stub and a copier ahead of the game; title screen "(C)1984 First Star Software Inc." |
| Copy | agent-draft |
| Tools | host: Linux 6.18 x86_64, cloud container with no display, emulator: VICE 3.14.0 (vice-mcp), driven through kit/c64/vice.py, disassembler: regenerator2000 0.9.20, python: 3.11, widget tests: node: test_levels.js holds the Maps tab builder to a second implementation of the recipe, subagents: one checking agent for the run's 60-verify sample, claude-opus-5-5; for the maintainer's check, seven fresh checkers on claude-opus-5-5: a sample, four audits of the listing by address range, an audit of facts.md, features.md and the pages, and a second sample |
| Model | claude-sonnet-5-5 |
| Kit version | 0.0.318 |
Every step that measured the Source tab’s comments or made them more accurate, in the order it happened, with the models that did it. Accuracy of the Source explains each step and what the row above makes of them.
| Step | By | What it found | Of the listing |
|---|---|---|---|
| Research | claude-sonnet-5-5 | Looked the game up online (its manual, reviews or wiki pages) before reading its code. | |
| Annotation | claude-sonnet-5-5 | Wrote the listing’s comments. 100 % of the program is described, in 358 comments. | |
| Sample 1 | claude-opus-5-5 | 20 of 60 comments wrong, so between 23 and 46 % of the listing is likely wrong. All 20 were then corrected. one checker; 18 wrong in a detail and 2 wrong; the comments sharing a template (cave records, character set and frame table chunks) were corrected too | |
| Sample 2 | air, with claude-opus-5-5 | 22 of 60 comments wrong, so between 26 and 49 % of the listing is likely wrong. All 22 were then corrected. 15 wrong in a detail and 7 wrong; the comments sharing their mistakes were corrected too | |
| Audit 1 | air, with claude-opus-5-5 | Checked all 358 comments and corrected 152. and every claim in facts.md; four checkers by address range, and a fifth on facts.md, features.md and the pages; two runs decoded as code were retyped as data | |
| Sample 3 | air, with claude-opus-5-5 | 4 of 60 comments wrong, so between 3 and 16 % of the listing is likely wrong. All 4 were then corrected. 4 wrong in a detail: two leave out a path the game can reach, two misquote text |
likely wrong the sample’s range corrected right, or likely right not yet measured
What the game is documented to do, with verification status against the binary. Statuses: open, traced (in the code, not exercised), confirmed (in the code, consistent with the emulator), live (observed directly), differs.
Sources:
| Feature | Status | Where |
|---|---|---|
| 16 caves, A to P, each with five difficulty levels | confirmed | 16 descriptions in the table at $582E; the five seed, quota and time bytes in each header; level chosen at the title by up and down (menu_cave_select, $884A); the map of cave A level 1 was checked against the emulator |
| Four bonus caves after D, H, L and P | confirmed | cave_order_table ($81FE) sends cave 4 to number 17, 8 to 18, 12 to 19, 16 to 20; each is a 20 by 12 room walled in steel, the update pass covers only rows 1 to 14 there (update_pass, $8171), and their headers give a time of 10 to 20 seconds |
| Start-menu choice of cave A, E, I or M | traced | menu_cave_select steps the cave number by four at levels 1 to 3; at levels 4 and 5 only cave A can be chosen |
| Collect a quota of diamonds, then the exit opens | confirmed | check_quota ($74F6), exit_handler ($70EC) |
| Time limit per cave and level | confirmed | time bytes 14 to 18 of the header (start_cave_variables, $8274) |
| Diamonds worth more once the quota is met | confirmed | header bytes 2 and 3, check_quota; in caves C, K and L and the four bonus caves byte 3 is 0, so diamonds past the quota score nothing |
| Three men and an extra man every 500 points | traced | new_game ($8ADD), check_bonus_life ($73DE) |
| Boulders and diamonds fall, roll off rounded objects and crush | confirmed | boulder_handler ($76F8), diamond_handler ($731F) and their falling versions |
| Boulders can be pushed sideways | confirmed | try_enter_cell ($7555); the push works one time in four (push_succeeds, $7543) |
| Fireflies and butterflies, which explode into space or diamonds | traced | firefly_handler ($7172), butterfly_handler ($7245), explosion_next_table ($764F) |
| Amoeba that grows, and turns to boulders or diamonds | traced | amoeba_handler ($7368) |
| Magic wall that turns falling boulders into diamonds and back for a limited time | traced | falling_boulder_handler ($7745), falling_diamond_handler ($729D), magic_wall_timer ($7E9F); after its time the wall looks like brick and destroys what falls onto it, and its time runs on through a pause |
| One or two players, one or two joysticks (F3 on the title) | traced | menu_keys ($880F) |
| Pause with SPACE; give up the cave with RUN/STOP, which costs a man, once the opening countdown is over | traced | pause_and_restart_keys ($8103) |
| Demonstration of play on the title screen | confirmed | demo_script ($5EA8) read by demo_play ($8CAA); seen live running at the title |
| Title music | confirmed | music_step ($8754), tune at $5FE8 |
| Bonus for time left, added to the score a second at a time | traced | time_bonus_tally ($8BF0) |
| Game speed depends on level | traced | time_delay_table ($8065) |
| Joystick port 1 for play | live | fire and directions read from $DC01 (read_joystick_1, $6EF5); fire on port 2 did nothing in the emulator; on the first title fire is not read until F1 or the demonstration has taken the logo away ($8918), seen live on the First Star PAL disk |
cave_random_step, $7085) make each cave and level the same on every play. Confirmed against the emulator's map for cave A, level 1.$8740), while the four bonus caves rebuild all of them (mask 7, $8325) (build_animation_frames, $7C61).$5FE8).$68E8-$6E67, and ignores the fire button while it is up ($8918); F1 or the demonstration takes it away for good (live, on the First Star PAL disk).$74A9), so on a PAL machine the cave clock runs 20 % slow (live, on the First Star PAL disk).$7E9F, $80D7), and a falling boulder that lands on the wall ends the update pass early ($7775).end_of_pass, $813B).$8F3D-$8FFF hold the tail of the programmer's assembler symbol table, with names such as SETUP0, GMINIT and NXTPLY.$8248 touches them. What they were for is unknown (cave A has $D4, $20 in bytes 22 and 23).$1F $FF; why the high byte is $FF is unknown.$3A is the amoeba: its handler word points to amoeba_handler ($7368), and the caves that place it (G and M) are the two whose mask has the amoeba bit. The test at $714C (is_rockford_or_amoeba) covers Rockford ($38, $39) and the amoeba, so a firefly or butterfly explodes next to either.$68E8-$6E67 are the title screen's logo: init_graphics ($8D46) copies them into the last six character rows of the bitmap at $2000 ($37C0-$3F3F), and the VIC shows them in multicolour bitmap mode below raster line $CA while the logo flag zpa_A3 is set (vic_split_title, $899C).$8F3D to $8FFF, after the program's last instruction, are an assembler's symbol table left in memory: 12-byte entries of a six-character name, $A8 $00, the label's value and two flag bytes, such as "KEY1" = $8A66, ":SK3A" = $8A74 (at $8F4E) and "SETUP0" = $8AB9. Nothing refers to them.check_restart_fire ($815B) ends the cave when fire is pressed once no Rockford has been handled for 16 update passes (zpa_96) and the cave's clock has started (zpa_AF): after Rockford is killed, fire moves on, which costs a man outside the bonus caves.Every byte of the C64's 64 KB, one pixel each, 512 to a row. Lit pixels are code, graphics, sound, text, tables and variables; dim areas are screen and working memory.
The symbol map is symbols.json; the listing behind the Source tab is listing.json.