1990 · Rainbow Arts

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/turrican 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. The map is of The engine, which stays in memory; the band marked as varying holds whichever of the 15 parts loaded over it is there. 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 checkedNot audited. No audit has checked every comment, and the last sample of 80 comments had 8 wrong, so between 5 and 19 % of the listing’s comments are likely wrong. How listings are checked
MediaThe 2 disk sides hold 23 files and 31 runs of sectors no file holds. Of those, 17 are in the listings, 27 are data the game loads, 9 load the game and 1 was saved by the game.
Build analysedCommodore 64 original, PAL, two disk sides from the C64 Preservation Project's 10th Anniversary Collection: turrican_s1 and turrican_s2 [rainbow_arts_1990](pal)(!)
Copyagent-draft
Toolshost: Linux 6.18 x86_64, cloud container with no display, emulator: release v4.0.0, v4.0.0-linux-x86_64-gui.zip (tools/vice-mcp), run under Xvfb; driven through kit/c64/vice.py; check-emulator 54 of 54, disassembler: regenerator2000 0.9.20, python: 3.13.18, node: 22.23.5
Modelclaude-opus-5-5
Kit version0.0.354

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 8,066 comments.
Sample 1claude-fable-5-28 of 80 comments wrong, so between 5 and 19 % of the listing is likely wrong. All 8 were then corrected.
nine more comments that read a sprite's mode backwards, or the shield's colours, found while building the Graphics tab and corrected with them

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
13 levels in 5 worlds (three worlds of three levels, two of two)livethirteen level files on side 2, each loaded by the route in orientation.md; the loading text's world and stage digits, engine level_text_codes ($67D9): 1-1 to 1-3, 2-1, 2-2, 3-1 to 3-3, 4-1 to 4-3, 5-1, 5-2
Each level is loaded from side 2 when the one before it endsliveengine state_next_level ($096D), the next file named in the level's header at $8CA7
Loading picture with "PRESS SPACE", then the title with credit pagesliveboot; title title_start ($6C00)
"TURN THE DISK ! THEN PRESS SPACE" before the first levellivetitle $6C7D: loads CD until it reads side 2
Speech at start-up ("Welcome to Turrican...")confirmedthe boot program's own code at $C330 plays a 4-bit sample from $0B30-$C1FF through the volume register ($D418), about 6,400 samples a second for about fifteen seconds, with the screen off, before the loading picture (orientation.md); nothing in the engine, title, levels or ending plays samples
Run left and right with the stickconfirmedengine hero_move ($0E94), hero_walk_right ($10E4)
Stick up jumps; up again while rolled up turns back to normalconfirmedengine hero_jump_start ($107B): up as the wheel unrolls him, only when he faces the way he rolls
Stick down ducksconfirmedengine hero_move ($0E94)
Down and fire lays a mine that explodes after a short timeconfirmedengine weapon_buttons ($2CAA): fire held 35 frames while crouching; a 50-frame fuse, mine_update ($2DB2)
Down and SPACE turns the hero into a rolling wheel (three times a life): invulnerable, rolls by itself, steered left and rightconfirmedengine hero_move ($0E94), three wheels a life in life_start ($567C), the panel's icons draw_wheels ($3F3E)
Holding fire brings out the lightning whip, swung by left and right; its length grows with blue symbolsconfirmedengine whip_update ($391B): fire held 20 frames, standing, the view still; 16 long at the start, two longer for each blue symbol
A short press of fire shoots: normal shot, scatter shot (red symbol, three levels) or laser (green symbol, grows longer)confirmedengine fire_shot ($3251), shot_level ($3595): one shot, three, three with a wider volley every other press; fire_laser ($3596)
SPACE fires the energy lines: two lines that run up and down the screen and destroy what they reach, stopped by wallsconfirmedengine energy_lines_start ($302B): two upright lines, each as tall as the space between the walls above and below the hero, that move apart to the left and the right
F7 throws a grenade: a smart bomb on walls and end bosses, a strong shot on other enemiesdiffersengine grenade_update ($2E6C): it flies forward until a wall or an enemy, then every object on the screen explodes with it, except in a boss's level; there it does 99 damage (weapon_damage, $0720)
CTRL pauses; fire continuesconfirmedengine main_loop ($08EA), frame_logic ($0B48), irq_bottom ($0C65)
Extra symbols: red scatter, green laser, blue whip, light blue shield, yellow P energy, white G grenade, white M mine, white L energy line, grey 1UP lifeconfirmedengine bonus_symbol ($5D6C), symbol_colours ($5EFD)
Diamonds: 300 give a continueconfirmedengine irq_bottom ($0C65): 50 points a diamond, a continue for every 300
A time limit for each levelconfirmedengine frame_logic ($0B48), the time from the level's header ($AE07-$AE09), TIME OUT (message_sprites, $6006)
Panel: lives, wheels, continues, time, diamonds, grenades, mines, energy lines, score, energy barliveengine panel_layout ($0748)
Secret rooms with extras, extra lives and diamondsconfirmed101 hidden blocks in eleven levels that show only when shot and give a stream of symbols, each level's with its own rules (facts.md, Mechanics; How it works, hidden blocks)
End bosses and mid-level bossesconfirmedthe fish (2-1), the machine (2-2), the tower (3-1), the gunship (3-3), the falling block (4-1), the creature (4-3), the Machine (5-2), each in its level's listing
A shoot'em-up stage (level 3-1) with music; the walking levels have no musicdifferslevel 3-1's flight and level 3-3's dive both play a tune with sound effects off; the other levels play effects only
High-score list: enter a name with RETURN; fire saves it to the disk, S asks for side 1, RUN/STOP returnslivetitle $7272, $7285, $729D: S shows INSERT SIDE 1 OF YOUR GAMEDISK, fire then saves and RUN/STOP goes back to the title; fire without S goes back to the title. A save that fails shows DANN EBEN NICHT !! (title_save, $74C3)
Continue screenconfirmedengine continue_choice ($60DF): YES or NO with left and right, fire to take it
Pause and fire held together: the hero walks and no enemies appear (C64-Wiki, cheats)liveengine main_loop ($08EA) sets the pause flag $0203 again every time round while CTRL is held; fire clears it in frame_logic ($0B48), so the hero, the time and the scroll run, but by irq_bottom ($0CAB) it is set again and the objects are neither made nor moved. In level 1-1, six seconds of CTRL, fire and right scroll the view exactly as walking right does, with no object made; walking right alone fills ten slots

Beyond the documentation

Found in the code, not in the manual.

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.