1983 · Virgin Games
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.
| Tier | silver |
|---|---|
| Coverage | 100 % of the bytes the game uses have a description |
| Comments checked | Not measured. No sample of the listing’s comments has been checked. How listings are checked |
| Build analysed | Remember crack, 'Falcon Patrol +5 and Highscoresaver 100%', highscore-saver only (no trainers) |
| Copy | agent-draft |
| Tools | emulator: VICE 3.10 via vice-mcp 3.11.0 (macOS arm64 GUI build), disassembler: regenerator2000 0.9.20, python: 3.9.6, host: macOS 15 (Darwin 25.5.0), Apple silicon |
| Model | claude-opus-5[1m] |
| Kit version | 0.0.6 |
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-opus-5[1m] | Looked the game up online (its manual, reviews or wiki pages) before reading its code. | |
| Annotation | claude-opus-5[1m] | Wrote the listing’s comments. 100 % of the program is described, in 496 comments. |
likely wrong the sample’s range corrected right, or likely right not yet measured
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:
Falcon_Patrol_1983_Virgin_Games, read 2026-09-19| Feature | Status | Where |
|---|---|---|
| Player flies a jet; horizontal two-way scrolling world | live | Player is hardware sprite 0, fixed at screen X = 172; the world moves around it |
| Joystick in control port 1 | live | Read at $5700 (lda $DC01), called from $419A. Port 1 shares $DC01 with the keyboard, which is why the game parks $DC00 at $7F and reads one port for both |
Keyboard alternative: ←/1 height, CTRL/2 turn, space fire | open | Documented by the wiki. All six keys sit in keyboard matrix row 7, the row $DC00 = $7F selects, so one read of $DC01 serves both keyboard and joystick. The bit-level mapping has not been traced yet |
| Up/down climbs and dives | live | Bit 0 = climb, bit 1 = dive, held in $0C after $5700 |
| Left/right turns and accelerates | live | $54A8 steps $2A one unit per 8 passes of $2D. Held right, vel_x ramps to exactly +3 and world_x advances $46→$90; held left it ramps to −3 and retreats $96→$5C |
| Fire launches a missile ("AAM") | live | Bit 4. Pressing it moves eight zero-page bytes at once ($07, $08, $10, $1D, $1E–$21) |
| Ceiling and floor on the player's altitude | live | $5705–$5723: if sprite 0 Y < $30 the game sets the up bit in $0C (cancelling climb); if Y ≥ $BF it sets the down bit. The limits are enforced by forging the joystick byte, not by clamping a coordinate |
| Firing is disabled at low altitude | confirmed | $5724–$5730: if sprite 0 Y ≥ $7C the game sets bit 4 in $0C, so the fire button reads as released. Not in any documentation found |
| Take-off gates the controls down to the climb | live | $5731 ORs the input with $FE, setting every bit but bit 0, so only the climb reaches the game. It does not fly the aircraft for you: left alone it sits on the pad indefinitely, and the bit clears the instant it rises |
| Automatic descent, and touchdown that stops the aircraft dead | confirmed | $573D–$575F: when $22 has bit 3 or 7 set, $0C is forced to $FD (down only). Then, if bit 3 is set and the sprite 0 pointer at $07F8 has reached $88, $0C becomes $FF (no input at all) and both velocities $2A and $2B are zeroed |
| Landing must be vertical, onto a base | confirmed | $559A requires all three at once: sprite Y exactly $84, vel_x zero, and a base tile $16 in the terrain map under both $3800[$0D+$12] and $3800[$0D+$14]. Stopped, at the right height, over a base |
| Refuel and rearm by landing | live | $5420 adds a unit of GAS and, one time in eight, an AAM; $559A runs it at double rate while on a base; $5000 is the wind-up at the start of a life that loops until the tank is full |
| Limited fuel | confirmed | Three decimal digits at $17/$18/$19, drawn as a nine-cell bar at row 22 by $4EA0 |
| Low fuel warns you, visibly and audibly | confirmed | Not in any documentation found. $4900 toggles $2E between $01 and $02 for the alarm, and $4EA0 uses $2E as the colour of the GAS bar, so the gauge flashes in time with the sound |
| Exactly 100 air-to-air missiles | live | The count at $1A/$1B/$1C fills alongside the fuel and stops dead at [1,0,0] |
| Radar showing enemies and surviving bases | live | The black panel in the centre of the status area; blips appear and move during play |
| Six bases | confirmed | Six, exactly as the wiki says: $16 $17 $16 $17 at columns 4, 40, 84, 136, 172 and 200 of the terrain map's top page at $3800 |
| Destroyed bases return only when a life is lost | confirmed | A destroyed base reads $6F/$70; $5FD0 turns them back into $16/$17 and is called from one place only, the life-lost reset at $564E |
| Enemy jets attack in waves | confirmed | $4540 drip-feeds four slots at spacing $62; $4730 places them as sprites 1-4 |
| Wave size grows with progress | differs | The wiki says one extra attacker every six waves. The code has no wave counter: $4A80 reads the score digits $13/$14 — under 400 points 2 aircraft, 400-1499 three, 1500 or more four. The ten-thousands digit $12 is never tested, so a score of 10000-10399 drops the wave back to two |
| Enemy aircraft bank through five drawn attitudes | confirmed | Blocks $94–$98 nose-left, mirrored at $99–$9D nose-right, stepped one frame at a time by $4367–$4392 and walked back to the level frame $96 when the manoeuvre ends |
| A destroyed aircraft gets a random explosion frame | confirmed | $4340 branches to $43A9 only when the slot's state at $57,x has reached $E0; there $D41B (SID oscillator 3) masked to 0–3 plus $88 picks one of the first four debris frames. The player's own wreck uses all eight ($56A1) |
| Collisions are detected in hardware | confirmed | $4200 reads $D01E (sprite to sprite) and $D01F (sprite to background); bit 0 of either is the player and calls player_hit at $4400 |
| Enemies bomb the bases | confirmed | $5C00 drops a bomb from the lowest enemy, $5CB0 makes it fall, $5D00 draws it as sprite 5 or 6, and $5F60 wrecks the base |
| Enemy aircraft shoot at the player | confirmed | $5B00, not in any documentation found. One shot per sky row, spawned only from the side that makes it travel toward the player |
| Enemies bomb the bases, and bomb the player while landed | open | Wiki and the instruction screen |
| Enemies veer off if not shot down in time | confirmed | $460E ages each slot at $57+x; past $80 the aircraft climbs, past $D0 it sinks, past $E0 it flies level and is frozen by both movement routines |
| Scoring 25 / 50 / 100 / 200 for the 1st–4th jet of a wave | confirmed | $4500 seeds $AA = $19 (25) at the start of each wave; the adder at $5E10 adds $AA to the score and then does asl $AA, so each kill within a wave is worth double the last |
| Extra life at 3,000 points, once | confirmed | $55DF: if $67 is zero and the thousands digit $13 has reached 3, $67 becomes $30 and a life is added. $67 is never cleared again, so it is awarded once; $4FA0 plays the fanfare |
| Three lives | open | Wiki. This release is "+5" when trainers are chosen; we chose H, no trainers |
| High-score table with name entry | live | Title screen shows five rows and the alphabet strip .ABCDEFGHIJKLMNOPQRSTUVWXYZ_; entry routine at $4CE2 walks an index 0–$1B with left/right and accepts with fire, building a name in a buffer at $0AB4 |
| High-score saving to disk | confirmed | The crack's, not the original game's. $28A0 reads the table back off the screen, restores the KERNAL vectors and SAVEs $2800–$2854 as @S:F.PATROL HI /REM |
| Music / sound effects | live | SID voice control registers written from $4BD3–$4BE1 in the title loop; a filter sweep at $4D4B during name entry |
Found in the code, not in the manual.
$5840, $58A0, $5960, $59C0 and $5F60.$5B00 spawns a white character-drawn streak, and only from the side of the screen that sends it toward the player's fixed column.$D015 reads $01 in the analysed snapshot, but that is a moment before the first wave arrives, not a general truth: the collision code at $4200 handles sprites 1-6, and $D015 is written from eight sites. An earlier draft of this file concluded from that single $01 that enemies were character graphics. They are not.$41C0 spins on lda $DD07 / cmp #$7F until the timer's high byte matches. The raster interrupt at $4AC0 only repaints the three-band colour split. Rates derived from "one frame" would be wrong.$0C and believes it. It is an elegant trick and it means $0C is not the joystick: it is "what the game wants the pilot to have done".$07F8, the sprite 0 pointer, doubles as the aircraft's state. The touchdown test compares it against $88, so the plane's current shape is also what the logic reads to decide it has landed.$5470 is dead code. It has no cross-references at all, while $5495 — inside it — is entered by a jsr $5495 at $5780, the tail of the live read_input. So $5470–$5494 is the stump of a shorter earlier input handler, left stranded when the longer $5700 replaced it, and both share the flight model from $5495 on. Whether Virgin or Remember cut it is still not established.The question mattered because the wiki says this release carries "additional bugfixes" as well as trainers, so anything described from this image might not be how the game shipped. Remember answered it themselves, in the scroll text of their own intro, still sitting unread at $0E80–$123F and signed "Back Alien/Remember in October 1997":
> first the game fucked up sometimes, I just changed something in the IRQ
> in the game was no routine which sets the places downwards when you > entered your name in the highscorelist, so I coded a routine
So the raster interrupt was touched, and the high-score place-shifting cascade at $294E is Remember's code, not Virgin's. Anything this analysis says about the high-score table's behaviour is the crack's behaviour.
Their front end is $1900–$1A60, which ends JMP $4100 into the game's cold start, with its menu text at $1A80–$1BE7 and the instruction screen copied from $1C00–$1FFF. It keeps its data at $1800–$1FFF because in VIC bank 0 the video chip sees the character ROM there, so that RAM is invisible to it and free.
Every trainer is a single-byte poke, and between them they name six variables — the cleanest confirmation in the whole analysis, because the cracker had to know what each address was:
| Trainer | Poke | What it proves |
|---|---|---|
| Unlimited lives | $417C ← $A5 | DEC $1D becomes LDA $1D, so $1D is lives |
| Unlimited gas | $555E ← $A5 | DEC $19, so $17/$18/$19 are the fuel digits |
| Unlimited AAMs | $57DB ← $A5 | DEC $1C, so $1A/$1B/$1C are the missile count |
| Bases indestructible | $5F71 ← $4D | the branch after CMP #$16 is redirected, so $16 is an intact base |
| No collision | $420F, $424C ← $AD | both JSR $4400 become LDA, so $4400 is the only way to die |
| Choosing trainers at all | $4D73 ← $AD | it disables the high-score saver, so the two features are exclusive |
What is still open: whether the NOP padding at $5470, $575E and $577C, and the AND #$00 gates at $5422, $5872 and $5980 that make their guard branches dead, are Remember's work or Steve Lee's. They look like patches. The scroll text admits to the IRQ and the high-score routine and mentions nothing else.
$22. Bits 1, 3 and 7 are used by the input gate; bit 4 survives the rewrite at $5776; bit 0 was set in the analysed snapshot and its meaning is unknown.$DC01 read they use.$12/$13 drawn into screen RAM by $58A0, so they cannot raise a sprite-to-sprite collision at all. A kill is registered when an enemy sprite reports a background collision and $4262 finds a glyph in $0C-$13 in one of the three character cells beneath it. Miss that three-cell window and the shot has no effect.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.