1983 · Cosmi (U.S. Gold in the UK)

About this page

This minisite was contributed by air, Nico-van-der-Zijden. It’s agent-generated and needs a human editor. Clone https://github.com/gamesexplained/gamesexplained and follow kit/START.md to curate games/c64/aztec-challenge with me to Gold.

Footprint

Every byte of the C64's 64 KB, one pixel each, 512 to a row. Lit pixels are what this game is: its code, graphics, level data, sound, text, tables and variables, exactly where they sit in memory. Dim areas are screen and working memory; dark is unused.

Status

Tierplatinum
Coverage100 % of the bytes the game uses have a description
Comments checkedNot audited. No audit has checked every comment, and the last sample of 60 comments had 11 wrong, so between 11 and 30 % of the listing’s comments are likely wrong. How listings are checked
Build analysedPAL cassette in the KERNAL's own format, two files (AC, a BASIC boot; AZTEC, the game at $1000-$7FFE); the U.S. Gold release of Cosmi's tape as the Ultimate Tape Archive V4.0 has it (entry 733)
Copyagent-draft
Toolsemulator: own build of github.com/barryw/vice-mcp, release v3.13.2, commit 1e83aab134; driven through kit/c64/vice.py; check-emulator 57 of 57, disassembler: regenerator2000, live, through kit/c64/r2000.py, host: Linux 6.18 x86_64 (WSL2) on Windows 11, Ubuntu 26.04.1, Intel Core i7-3770, eight threads, display through WSLg, node: 24.21.0 (tools/node), browser: Google Chrome, headless, on Windows 11, for the page checks
Modelclaude-opus-5-5
Kit version0.0.314

How the listing was checked

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.

StepByWhat it foundOf the listing
Researchclaude-opus-5-5Looked the game up online (its manual, reviews or wiki pages) before reading its code.
Annotationclaude-opus-5-5Wrote the listing’s comments. 100 % of the program is described, in 315 comments.
Sample 1claude-fable-5-111 of 60 comments wrong, so between 11 and 30 % of the listing is likely wrong. All 11 were then corrected.
60 of 313 comments, all wrong in a detail; corrected with four more that shared two of the beliefs
Play tabclaude-opus-5-5Ported the whole game to JavaScript for the Play tab and corrected 2 comments it showed wrong.
the whole game ported routine by routine and held in lockstep with its own code; 2 comments the port showed wrong were corrected: the Stairs' colour loops that run once ($6CF5) and the third block's X from CIA 2's timer, which never runs ($7000)

likely wrong the sample’s range corrected right, or likely right not yet measured

Contributors

Other places to love this game

What the game does, and where we found it

Read this before annotating code. What the game is documented to do, with verification status against the binary. Statuses: open (documented, not found yet), traced (in the code, could not be exercised; say what was tried), confirmed (in the code, consistent with the emulator), live (observed directly), differs (the code does something else). "Absent" is not a status.

Sources:

Features

FeatureStatusWhere
Joystick in control port 2 only (manual: "will not function in CONTROL PORT NO. 1")confirmedall 14 reads are of $DC00; nothing reads $DC01 (census); every level played from port 2
Cosmi logo and title, then the player selection: F1 one player, F3 two playerslivespiral at $1000; select text $5D40, drawn by $1500
Attract "previews" of the levels until a function key is pressedlivedemos of the levels seen running from the select loop
Scorecard: level, phase and score for both players, the level's instruction text, "PRESS FIRE BUTTON TO START"live$1195-$1229, text blocks from $1600 by $1480
Flashing player indicator ("1 UP") between the two columnsliveseen on the scorecard
RUN/STOP starts the game from the very beginninglive$1223-$122B: on the scorecard, STOP jumps to $1000
Five lives per level; losing all five returns the scorecard and, with two players, passes the turnconfirmed$02 counts lives lost, $1300; live: five losses back to the scorecard on the same level. With two players the turn passes after every attempt, won or lost (live)
Staying on the same level until it is wonliveafter five losses the level counter $03 stayed at 1
Win bonus: 1000, 800, 600, 400, 200 points for 0 to 4 lives lostconfirmed$1400: adds 10, 8, 6, 4 or 2 hundreds by $02; live: the Gauntlet won with no life lost added 1,010
10 points for each achievement (dodging spears, jumping, crossing rooms)confirmed$1456 adds 10 points $68+1 times; live: five losses with no achievements scored 10, a win with none 1,010
Seven levels in a fixed order, then the next phase; four phasesconfirmedlevel digit $03/$04 '1'-'7', phase $05/$06 '1'-'4'; $137C-$1390
After phase 4 the game starts again from the beginningconfirmed$1390 jumps to $1000 when the phase passes '4'
Later phases faster; the last phase "at night"confirmedphase tables $5C50-$5C8F copied to $50-$5F by $1256; phase 4's two colours darken the Gauntlet, Hopaztec's doorway, the Piranha and the Bridge (live); the Stairs, the Temple and the Vermin look the same by night
Background music that changes and builds with progress, on every level but level 5confirmed$1C00 plays the tune; $6530 changes tune and voices by the stage $45, called by every level but Hopaztec
Level 1, The Gauntlet: run toward the temple between two rows of spear throwers; forward jumps, back ducks; staying jumped or ducked too long makes the runner fall; any spear killslive$6000; played; any input held 8 passes of the loop falls ($614F, traced)
Level 2, The Stairs: climb while stone blocks roll down; left and right dodgelive$6CF5; played. Up and down alone also move left, and fire moves right ($71A0, traced)
Level 3, The Temple: a divided hallway; spears and stones fall, spikes rise, trapdoors open; left stops, right jumps highlive$7600; played; four traps picked at random per room ($7835); only a touch on the runner's lower half alone catches it ($79F0, live: a spear on the head and on both halves passed, on the legs alone it caught)
Level 4, The Vermin: creatures; back is a low jump, forward a high one; touching a creature for more than a second killslive$6595; played; a bite is 8 steps of touching in a row ($6BE0); one of the six creatures never appears (live, 60 s)
Level 5, The Tiles (Hopaztec): hop in any direction across booby-trapped tiles to the door; after five lost lives a new pattern of bad tileslive$7200; the pattern is picked once per attempt ($74C2, called only from $7200), so it changes only after the fifth loss; a trapped tile throws spears from both walls ($7502); the floor is 65 tiles, four hops lead off it (test_hop.js, live); the patterns are windows of one fixed sequence (live, 20 lists)
Level 6, The Piranha: swim any direction, fire dives; under water for only 2 to 3 seconds or drown; must keep moving up the screenlive$7E98; fire held alone drowned the swimmer 18 times in 60 s; progress counts passages off the edge of the lake ($1AB8, live)
Level 7, The Bridge: run across a grass bridge with holes; back low jump, left medium, forward high; jump at the last steplive$7B00; played; the runner stays put while the planks scroll ($7C8A)
Fire must be pressed with the stick centred, or neither works (manual)differstrue of the Piranha's swimming and diving ($1DE0), but its bite check tests the fire bit alone ($1EA0): fire with a direction kept the swimmer safe for a minute (live). On the Stairs fire moves right ($71A0)

Beyond the documentation

Found in the code, not in the manual.

Open questions

The symbol map for this game is symbols.json; the listing behind the Source tab is listing.json. Write-ups, facts and symbol maps are CC BY-SA 4.0. The game itself is not hosted here.