1988 · Lucasfilm Games

About this page

This minisite was contributed by air. It’s agent-generated and needs a human editor. Clone https://github.com/gamesexplained/gamesexplained and follow kit/START.md to curate games/c64/zak-mckracken-and-the-alien-mindbenders 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.

This game is in 2 parts. The map is of The game, which stays in memory; the band marked as varying holds The music player, loaded over it, while it is there. The Source tab has the listing of each part that has one.

Status

Tiersilver
Coverage100 % of the 31,190 bytes in memory, and none of the 116,884 bytes of its program the game reads from the disk during play: in all, 21 % 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 analysedCommodore 64 original, three disks from the C64 Preservation Project's G64 collection: zak_mckracken_boot, _s1 and _s2 [activision_1988](manual)(!)
Copyagent-draft
Toolshost: Linux 6.18 x86_64, cloud container with no display, emulator: VICE, release v3.14.0, v3.14.0-linux-x86_64-gui.zip (x64sc, PAL), disassembler: regenerator2000 0.9.20, python: 3.13.18, checker: codex-cli 0.166.0, node: 22.23.4
Modelclaude-opus-5-5
Kit version0.0.309

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 976 comments.
Sample 1gpt-6-astra11 of 60 comments wrong, so between 11 and 30 % of the listing is likely wrong. All 11 were then corrected.
Codex CLI, reasoning effort medium; 25 more comments that shared the mistakes corrected with them
Audit 1gpt-6-astraChecked 24 of 976 comments and corrected 4.
all 24 comments of the part music, the music player, when it was added; Codex CLI, reasoning effort medium

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
Boots from its own boot disk with LOAD"*",8,1, then asks "Put in side 1 and push joystick button."livethe boot file BOOT loads AA at main $0400 and jumps there (orientation.md); the prompt's text is at main $309E
Joystick in port 1 moves the cursor; its button clickslivethe cursor moves on port 1 and not on port 2 (5 November 2026); read_joystick main $1CE0 reads port 1 alone
Game disk sides swapped at a prompt, "Put in side 2 and push joystick button."liveask_for_side main $300B reads the side's number from track 1, sector 0
The opening title sequence: Zak dreams, the title over his bed, creditslivereference/; its tune, sound 95, starts 7,780 frames in
Screen in four bands: two message lines at the top, the animation window, the sentence line, the verbs and the inventorylivemessage text at main $CC00-$CC4F, the sentence line at row 18, verbs rows 19-21, inventory rows 22-23 of the screen at main $CC00; the raster interrupts switch from multicolour to hires text at line $C3 (raster_interface main $1102)
Verbs chosen from the list below the sentence line: Push, Pull, Give, Open, Close, Read, Walk to, Pick up, What is, Put on, Take off, Use, Turn on, Turn offlive20 verb slots in the interface's table (main $F0D9); the verbs are placed by the scripts (verbOps main $5F86)
New verbs appear as the game goes on; "Switch" appears once Zak has met Annietraceda verb is added or deleted by verbOps (main $5F86) from a script; when "Switch" is added is in the scripts, which are not decoded, and was not played to
A sentence is a verb and one or two objects; "with", "on" and "to" are put in by the programtracedeach verb keeps a preposition (main $F165, set by verbOps) that the sentence line puts between the objects (append_name main $07FC, object_preposition main $0825); not exercised with a two-object verb
A second click on the last word, or one on the sentence line, carries the sentence outtraceda click is passed to the scripts with where it came from in variable 32 (click_room main $F2EE, click_sentence main $F314, start_input_script main $067D); the scripts decide when a sentence is complete; not exercised
"What is" names whatever is under the cursor as it moveslivethe sentence line shows each object's name while the cursor passes over it
"Walk to" comes back on the sentence line after every sentencelive
An inventory for each character, four shown at a time, arrows to scroll when there are moretracedredraw_inventory main $F380 and draw_arrow main $F3C6 show four items from the scroll; click_arrow main $F34E scrolls by two, a row, so with an odd number of items the last scroll shows three and a blank
Four characters to control: Zak, Annie, Melissa and Leslie, switched with F1, F3, F5 and F7tracedF1, F3, F5 and F7 reach the scripts as 1 to 4 in variable 39 (key_table main $1CF8, handle_key main $234D); the switch itself is done by the scripts
Cut-scenes, during which the verbs and inventory disappear; RETURN bypasses one, and on an airliner takes you straight to your destinationtracedop_cutscene main $5AE3 hides the verbs, the inventory and the cursor; the cut-scene key, variable 40 (13, RETURN, in the bedroom), sends the script to its override when it set one (handle_key main $234D); which cut-scenes have one, the flights among them, is in the scripts
Save and load with SHIFT and F1, on a blank formatted disk; not during cut-scenestracedsave_game main $0A53 refuses one of the game's own disks and writes tracks 1 and 5 on, load_game main $0AD5 reads them back (parts/main/facts.md, "Saving"); the key reaches the scripts, which call saveLoadGame main $5E6F; not exercised
Restart with SHIFT and F7tracedop_restart main $5F5A goes back into the start-up at main $0418; the key is the scripts'
Pause with the space bar; the game pauses by itself after five minutes with no inputlivehandle_key main $234D pauses on space; read_keys main $1BAF files a space when the idle count, 18,000 frames, runs out; joystick input resets it and keys do not (parts/main/facts.md, "Timing")
A snail replaces the cursor while the disk is read or the game is pausedtracedbusy_cursor main $13DA shows the snail (main $F080) around every load (load_resource main $D4BE); the cursor during the pause was not looked at
Message line speed: + faster, - slowerlivechange_message_speed main $23D0: the speed, 6 at the start, goes from 0 to 10; three presses of + took it from 6 to 3
Sound off and onopenthe Commodore cell of the manual's table did not survive the OCR; the program's own keys (handle_key main $234D) are space, +, - and the cut-scene key, so any key for the sound would be the scripts', which are not decoded
The room "irises" to black while the next room is loaded from disktracedclose_room main $D61E closes the iris (main $D60C) and open_room main $D645 opens it from the middle (main $D615)
Rooms wider than the screen scroll left and righttraceddraw_room main $3610 shifts the room a column and decodes the new one; move_camera main $CAD0 follows the actor when it comes within 10 columns of an edge
The copy protection: a security code from the code sheet when flying out of the USA, asked again on later flights; five wrong codes is a gagopennothing in the 6502 program asks for a code; it is in the scripts, which are not decoded
Money on Zak's CashCard, spent on flights; the lottery numbers on the alien ship win the lottery in San Franciscoopenin the scripts, which are not decoded
Characters can be "killed" only with difficultyopenin the scripts, which are not decoded
Mazes on Earth and Mars (the Mexican temple, the Sphinx, the Mars chambers)openthe mazes are rooms and scripts on the disk; the rooms were not matched to places
Music by Matthew Kane; sound effects by Matthew Kane, Chris Grigg and David Warhollivefour tunes, sounds 95, 102, 103 and 104, played by the player in sound 1, music $C304 (parts/music/facts.md); tune 95 heard in the opening
The National Inquisitor newspaper in the box carries hintsopenprinted in the box; nothing on the disks was looked for

Beyond the documentation

Found in the code, not in the manual.

FeatureStatusWhere
The music keeps playing through a change of room: video_off, which turns the picture and the interrupts off while a room loads, does nothing while the music playslivevideo_off main $13F3, the check of main $43E8; three changes of room in the 3,000 frames after tune 95 starts, with the frame interrupt in every frame (parts/main/facts.md, "Live tests")
The cursor has weight: it speeds up as the joystick is held and slides to a stop, more slowly over some kinds of slottracedmove_cursor main $F5F5, set_cursor_feel main $F5AE
At most four actors can be on the screen at once, one sprite column each; a fifth stops the gametracedassign_sprites main $3491, fatal error 13
The cursor's colour pulses through six greys, a step every seventh frametracedmain $1163-$1167, frame_irq main $117C
An object in someone's inventory sends a walk to the wrong place: walkActorToObject and two other opcodes check the wrong registertracedparts/main/facts.md, "Bugs in the program"
A disk that will not take a write is never noticed when savingtraceddisk_write main $3AD1, bus_write_sector main $3BCB

Open questions

Each part of the game has its own symbol map and listing: The game, symbols.json and listing.json; The music player, symbols.json and listing.json. Write-ups, facts and symbol maps are CC BY-SA 4.0. The game itself is not hosted here.