1983 · Virgin 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/falcon-patrol 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

Tiersilver
Coverage100 % of the bytes the game uses have a description
Comments checkedNot measured. No sample of the listing’s comments has been checked. How listings are checked
Build analysedRemember crack, 'Falcon Patrol +5 and Highscoresaver 100%', highscore-saver only (no trainers)
Copyagent-draft
Toolsemulator: 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
Modelclaude-opus-5[1m]
Kit version0.0.6

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[1m]Looked the game up online (its manual, reviews or wiki pages) before reading its code.
Annotationclaude-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

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
Player flies a jet; horizontal two-way scrolling worldlivePlayer is hardware sprite 0, fixed at screen X = 172; the world moves around it
Joystick in control port 1liveRead 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 fireopenDocumented 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 divesliveBit 0 = climb, bit 1 = dive, held in $0C after $5700
Left/right turns and accelerateslive$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")liveBit 4. Pressing it moves eight zero-page bytes at once ($07, $08, $10, $1D, $1E–$21)
Ceiling and floor on the player's altitudelive$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 altitudeconfirmed$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 climblive$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 deadconfirmed$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 baseconfirmed$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 landinglive$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 fuelconfirmedThree decimal digits at $17/$18/$19, drawn as a nine-cell bar at row 22 by $4EA0
Low fuel warns you, visibly and audiblyconfirmedNot 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 missilesliveThe count at $1A/$1B/$1C fills alongside the fuel and stops dead at [1,0,0]
Radar showing enemies and surviving basesliveThe black panel in the centre of the status area; blips appear and move during play
Six basesconfirmedSix, 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 lostconfirmedA 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 wavesconfirmed$4540 drip-feeds four slots at spacing $62; $4730 places them as sprites 1-4
Wave size grows with progressdiffersThe 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 attitudesconfirmedBlocks $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 frameconfirmed$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 hardwareconfirmed$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 basesconfirmed$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 playerconfirmed$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 landedopenWiki and the instruction screen
Enemies veer off if not shot down in timeconfirmed$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 waveconfirmed$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, onceconfirmed$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 livesopenWiki. This release is "+5" when trainers are chosen; we chose H, no trainers
High-score table with name entryliveTitle 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 diskconfirmedThe 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 effectsliveSID voice control registers written from $4BD3–$4BE1 in the title loop; a filter sweep at $4D4B during name entry

Beyond the documentation

Found in the code, not in the manual.

What belongs to the crack, and what to Steve Lee

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:

TrainerPokeWhat it proves
Unlimited lives$417C ← $A5DEC $1D becomes LDA $1D, so $1D is lives
Unlimited gas$555E ← $A5DEC $19, so $17/$18/$19 are the fuel digits
Unlimited AAMs$57DB ← $A5DEC $1C, so $1A/$1B/$1C are the missile count
Bases indestructible$5F71 ← $4Dthe branch after CMP #$16 is redirected, so $16 is an intact base
No collision$420F, $424C ← $ADboth JSR $4400 become LDA, so $4400 is the only way to die
Choosing trainers at all$4D73 ← $ADit 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.

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.