1990 · System 3

About this page

This minisite was contributed by air, 64kramsystem. It’s agent-generated and needs a human editor. Clone https://github.com/gamesexplained/gamesexplained and follow kit/START.md to curate games/c64/last-ninja-remix 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 16 parts, and the map is of one of them: System 3's intro. The Source tab has the listing of each part that has one.

Status

Tiersilver
Coverage100 % of the bytes the game uses have a description
Comments checkedAudited & low error rate. Every comment was audited once, then the last sample of 60 comments had 1 wrong, so between 0 and 9 % of the listing’s comments are likely wrong. How listings are checked
Build analysedThe Force's crack of the 1990 disk, with Ikari+Talent's trainer, its two options left off (archive.org; side A SHA-1 5597c4896f0a6ada501fb13ad94359063a8c1e29, side B 22f881cff073a4797580f95ca6225903a0bfaa99): all seven levels
Copyagent-draft
Toolsemulator: VICE x64sc, release v3.13.2, v3.13.2-linux-x86_64-gui.zip, disassembler: regenerator2000 0.9.20, host: Linux x86_64 (Ubuntu 24.04.5, cloud container)
Modelclaude-opus-5-5[1m]
Kit version0.0.226

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
Researchgpt-6.1-sol, claude-opus-5-5[1m]Looked the game up online (its manual, reviews or wiki pages) before reading its code.
Annotationgpt-6.1-solWrote the listing’s comments.
started from an imported analysis by 64kramsystem, made in Ghidra, models unknown
Annotationclaude-opus-5-5[1m]Wrote the listing’s comments.
22 October 2026: described the nine stretches of Central Park's typed data that no label reached, typed the NMI and IRQ vectors, and left out the reset vector and a keyboard table under the KERNAL that nothing in the load uses
Annotationclaude-opus-5-5[1m]Wrote the listing’s comments. 100 % of the program is described, in 11,319 comments.
24 October 2026: the intro, the engine, the seven title loads and the six later levels; the later levels' code shared with Central Park carries Central Park's comments to its own addresses, and each level's own code is annotated for itself
Sample 1claude-opus-5-5[1m]19 of 80 comments wrong, so between 16 and 34 % of the listing is likely wrong. All 19 were then corrected.
60 hand-written and carried-over comments and 20 generated ones; each wrong one corrected with every comment that said the same
Sample 2air, with claude-opus-5-5[1m]10 of 60 comments wrong, so between 9 and 28 % of the listing is likely wrong. All 10 were then corrected.
Audit 1air, with claude-opus-5-5[1m]Checked all 11,411 comments and corrected 2,257.
and every claim in the facts files (66 of 355 corrected); 1,942 items read, a template counted once, 382 wrong; the 1,428 comments carried unchanged to the later levels checked through the Central Park comment they copy and a comparison of each copy's calls and constants; fixed counts every comment changed since the seed 16184 sample, with the comments that said the same
Sample 3air, with claude-opus-5-5[1m]1 of 60 comments wrong, so between 0 and 9 % of the listing is likely wrong. It was then corrected.
drawn from the 9,970 comments that are not unchanged copies; the wrong one corrected with the 65 condition lists that said the same

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

What the game is documented to do, with its status against the code. Statuses: open (documented, not found yet), traced (in the code, not exercised), confirmed (in the code, consistent with the emulator), live (observed directly), differs (the code does something else).

Sources:

Features

FeatureStatusWhere
Seven levels, each one load: Central Park, The Street, The Sewers, The Basement, The Office, The Mansion, The Final Battle (the manual lists six loads, by other names)liveevery level reached and played in the emulator; each level file is unpacked in two segments by engine $1000; the Maps tab draws every area of all seven, and test_levels.js holds each play window against the emulator
Isometric areas drawn from piecesconfirmedthe scene renderer ($8A52 in Central Park); 13,297 pictures over the seven levels, each inside its box (index.html, section 05)
Movement relative to the way the ninja faces; J turns the stick's directions an eighth of a turntracedScanAndNormalizeInput ($9418 in Central Park); J steps $03F3 from 0 to 2, added to the heading at $A50D
Keys: F1 sound, F3 and F5 the items, F7 pause, Space the weapons, RUN/STOP kills the ninjatracedengine $1EEA (F1, $AA), $02B7 (pause), $0267 and $B6 (RUN/STOP); see facts.md, "Controls"
A joystick with a second button (the C64GS's pad): whichever starts the level fires, the other selects the weapon, both together the itemlivePOTX of port 2 ($D419) with $DC00 = $80; $8EE8-$8EF9, $951B, $9497 in Central Park
Picking an item up (fire with the stick down and to one side)tracedeither down-diagonal crouches (InterpretNormalizedControls, $A640); the crouch raises events 9, 10 and 11 on its three frames, and an object record (object_record_00, $C0D0 in Central Park) names the frame, the box and the heading at which its item is taken (ObjectEngine, $BFC3); index.html, section 03, draws each weapon's box
Somersaultstracedfire pressed afresh while he walks ($6C = 0, cleared at $A542 in Central Park when a stick direction is taken), with the stick at most an eighth of a turn from his heading (InterpretControls, $A5BD-$A5C9), selects action 0 ($A5F3), which SelectPlayerAnimationForAction turns into the first or second stream of the table by the way he faces; test_graphics.js runs InterpretControls for every heading and stick direction in all seven levels, and the Graphics tab plays both streams
Fighting moves, unarmed, armed and thrownconfirmedstick to move (InterpretNormalizedControls, $A640), reach (TestActorCombatOverlap, $AC7A), damage (player_attack_enemy_damage, $ABBA, a table for levels 1 to 4, one for The Office and The Mansion, one for the Final Battle), a star's 44 ($B8B9); test_index.js holds the ports in index.html, section 03, against the game's routines in all seven levels
Weapons and items: keys, map, nunchakus, shuriken, staff, bottle, sword, hamburger, credit card, terminaltraced40 item flags at $03D8; each level's object records say where an item lies and what taking it does
The player's and the enemy's energyconfirmed$0229 and $022A, 44 each, shown as two spirals (engine $1D4B, $1D78); test_index.js holds the spiral against engine $1E67
Livestraceditem 26's flag ($03F2), four at the start (engine $0EAF); LoseLife ($93C4 in Central Park)
Scoretracedengine $1183; 5,000 at the end of each level (ResolveLevelCompletion), 50,000 at the end of the game (PlayEnding, $8CA5 in The Final Battle)
Clockliveengine $1F1B, a second every 50 raster interrupts: 10 seconds in 500 PAL frames
The final problem "is always in the picture": the last door's lockconfirmedthe code is the clock's minutes and seconds as The Basement ends (CopyClockToCode, $B9B2 in The Basement); test_index.js runs it for all 3,600 times
Music for each levelconfirmedeach title load's player at $4000; test_music.js holds the page's player against all seven, 6,000 frames each

Beyond the documentation

Open questions

Each part of the game has its own symbol map and listing, parts/<id>/symbols.json and parts/<id>/listing.json; the ids are the ones in its Source pages’ addresses. Write-ups, facts and symbol maps are CC BY-SA 4.0. The game itself is not hosted here.