1988 · Blade Software

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/spectrum/laser-squad with me to Gold.

Footprint

Every byte of the Spectrum's 48 KB of RAM, one pixel each, 384 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 6 parts. The map is of The engine, which stays in memory; the band marked as varying holds whichever of the 5 parts loaded over it is there. The Source tab has the listing of each part that has one.

Status

Tierplatinum
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 10 wrong, so between 7 and 22 % of the listing’s comments are likely wrong. How listings are checked
Build analysedBlade Software's 48K tape (TOSEC: Laser Squad (1988)(Blade)[scenario 1-2].tzx and [scenario 3-5].tzx): a BASIC loader, the loading screen, the 22,521-byte engine at $5E28-$B620 and five headerless scenario blocks of 18,911 bytes each, loaded at $B621-$FFFF
Copyagent-draft
Toolsemulator: release ZEsarUX-13.0, ZEsarUX_linux-13.0-ubuntu24_x86_64.tar.gz, run as a Spectrum 48K; check-emulator 47 of 50 on 3 November 2026 (count-while-running, load-keeps-frame-phase and warp, each with a workaround in kit/skills/spectrum/tool-zesarux), disassembler: SkoolKit 10.1 (control file, sna2skool), host: Linux x86_64 (Ubuntu 24.04, no display), a hosted cloud session, python: 3.13, node: 22.23.4
Modelclaude-opus-5-5
Kit version0.0.297

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 7,482 comments.
Play tabclaude-opus-5-5Ported the whole game to JavaScript for the Play tab and corrected 0 comments it showed wrong.
the port was written first, routine by routine in lockstep with the game, and the listing's comments on code were written from it, so it found none of them wrong
Sample 1claude-opus-5-510 of 80 comments wrong, so between 7 and 22 % of the listing is likely wrong. All 10 were then corrected.
80 of the 7,482 comments: 20 of the 5,551 made from the game's tables, none wrong, and 60 of the 1,931 written by hand, 10 wrong (9 in a detail, and one dictionary word read as letters where it holds colour codes and an arrow); all 10 were corrected, with the same mistakes in other comments and in facts.md

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
Main program then a scenario loaded from tape, chosen from a menu of six (5 scenarios and a saved game)livemenu $A276; load $B15C, $B1C3
Controls: Sinclair joystick, Kempston, Protek/AGF (cursor keys), keyboard Q A O P SPACEtracedreaders $B0E8, $B0FD, $B117, $B136 through the table $B0E0
One or two players; against the computer the second side is the computer'sconfirmedchooseGame ($A211) sets $B706; the computer's half-turn is the scenario's hook at $B621 (computerSide, $5E40)
Difficulty level chosen per scenario ("WHICH LEVEL ? (PRESS 1 TO 4)"); levels vary between scenarioslivethe count at $B684: 4 in The Assassins, 7 in the others
Credits per side, depending on the levelconfirmedthe first side's by level at $B6FA, two players' at $B6F8 and $B6F9 (chooseGame, $A211)
Armour types 0-4, each with front, left, right and rear ratings, weight, carry limit and costlivearmour screen; 7 bytes a type at $B6C1 (chooseArmour, $9F5E)
Equipment: objects bought per unit, limited by credits, weight and sizeliveweapons screen; buy ($A0EE) refuses on weight (message $5C) or room ($5D)
Weapons loaded when bought; extra ammunition soldconfirmedbuy ($A0EE) loads a weapon with its kind's rounds ($10) or its clip's
Deployment on the side's coloured squares, one unit at a time, with a flashing cursorliveplaceUnits; the squares at $B65E (clearDeploy, $A474)
Options between turns: change controls, save, load, verifyliveturnMenu ($B1F7)
Turn summary: player, turn, turns left, victory points of both sideslive
Turn limit (19 turns left on turn 1 of scenario 1, level 1)livethe last turn at $B701 (checkEnd, $A4A4)
Win at 100 victory points; points for eliminating units and destroying installationsconfirmedcheckEnd ($A4A4); a death scores the unit's $27 (unitDies, $8229), damage to terrain its $05 where $B704 or $B705 says (scoreDamage, $9201)
Action points per unit per turn, less armour weight, burden and wounds; half when the unit is feebleconfirmedhalfTurn ($5EA6), updateLoad ($7E92): half under stamina $20
Cursor mode: map window, MAP / OBJECT / UNIT / OBJECT IN USE readout under the cursorlivesquareReadout
Cursor menu: SELECT, INFO, NEXT UNIT, SCANNER, END TURN, CANCELlive (NEXT UNIT, SCANNER, END TURN, CANCEL seen)
Select mode: turn 45° (1 AP), forward (4 AP + terrain; +2 diagonal), back (6 AP)differsa turn costs 1 (turnRight, $6DAF); a step costs the terrain's byte for the unit's kind (4 on open ground) plus 2 on a diagonal (stepTarget, $6E74), and a step back doubles the lot, 8 on open ground rather than 6 (stepCost, $6EBF; walkBack, $6E60)
Moving into impassable terrain attacks itconfirmedattackTerrain ($7F0B), breakTerrain ($8030)
Units may cross friendly units but not stop on one; END MOVE puts the unit back on its last empty squareconfirmedshared ($9A16), undoMove ($7042)
Close combat by moving into an enemy; accuracy from weapon, agility and the side attacked; damage from weapon, strength, 50-150 % random, armour, terrainconfirmed (the damage); the accuracy opencloseCombat ($80CD), attackStats ($7FC1), attackRoll ($8095): a random number up to the strength plus half the strength, 50 to 150 %; armour by side (armourHit, $81A2)
Hidden movement and line of sight: 90° field of view, walls and doors block itconfirmedinView ($7326), seenFrom ($7298), lineClear ($7209); the other side's units taken off the map (hideSide, $71A8)
Select menu: END MOVE, FIRE, CHANGE (25 %), PICKUP (25 % or 50 %), DROP (10 %, hiding where the terrain allows), LOAD (50 %), PRIME (20 %, timer in half-turns), OPEN and CLOSE (20 %), UNLOCK and LOCK (25 %, needs the key), SCANNER, CANCELconfirmedprices in openDoor ($79F7), lockDoor ($7A19), $7A37, $7CAC, $7C0A, $9C42, $9D01, each a share by divRound ($6B19)
Fire mode: line-of-fire map, units as blobs, cross-hair cursor; AUTO (two points, at least three shots), SNAP, AIM, THROW (range strength / weight, accuracy agility, 20 %), INFO, END FIRE, CANCELconfirmedthe second table of squares at $E79F; aimStart ($8C7D); autoFire ($9232), burst ($9360)
Ranged accuracy: weapon's by shot type plus skill bonus (half for auto, double for aimed)tracedshotHit ($9043): a hit is a number from 0 to 99 below the chance ($5DCD), a miss scattered (scatter, $8BD0); how the chance is made was not compared with the manual
Ranged damage: weapon's, 50-150 % random, less armour of the side hit and terrain protectiontracedshotPath ($90E4), armourHit ($81A2), which takes the floor's $06 and the armour of the side hit off the damage
Explosions: grenades, explosives, rockets, gas canisters; blast radius damages terrain and unitsconfirmedexplode ($9696), blastRay ($980E), cellDamage ($98AF), fuses ($9C8B); terrain with $08 = 7 catches fire (spreadFires)
Terrain and furniture can be shot and destroyedconfirmedbreakTerrain ($8030): the blow at least the terrain's $03, it becomes its $04
Opportunity fire: a unit with half its AP allowance left fires in the enemy's turn when an enemy comes into viewconfirmedstartReaction ($755D): facing the mover, more points left than half its $05 less one, once a turn
Unit characteristics: morale value, movement type, AP allowance, constitution, wounds, wound rate, stamina, morale, weapon skill, strength, agility, unarmed combat, burden, armour by side, victory pointsconfirmedthe 40-byte records at $D39F (unitPtr, $67C2)
Morale: falls when friends die or the unit is wounded, rises when enemies die; panicked units may drop objects; droids' morale never fallsdiffersa death moves both sides' morale by the dead unit's $01 (moraleShock, $829E); a wound never lowers it, the routine being cut off by a wrong test (takeDamage, $81FB, bug in facts.md); panic and droids not traced
Stamina falls when more than half the APs go on movement; rest restores itconfirmedhalfTurn ($5EF6, $5F29)
Scanner: a strategic map of the whole area, own units and spotted enemieslive
Info on any unitlive
Computer opponent; its movement hidden from the playerconfirmedeach scenario's copy from $B732; aiTurn, findRoute, chooseTarget
Scenario 1, The Assassins: kill Sterner Regnix; droids win by killing all assassinstracedcheckEnd ($A4A4) with the side's points for a wipe-out at $B65C; Sterner Regnix's $27
Scenario 2, Moonbase Assault: databanks 5 VP, analysers 2 VP; Omni wins by killing all the squadtracedterrain points by scoreDamage ($9201, $B704 set); doors that open and shut (doorOpen, $C208; doorsShut, $C249)
Scenario 3, Rescue from the Mines: free three prisoners (explosive needed) and move them into a lift; Metallix wins by killing five rebelsconfirmedwayOut ($FF88): a prisoner (units $91 to $93, the only ones whose $27 is $18) stepping onto an ELEVATOR DOOR ($1A-$1D) leaves the map, 34 points to the first side; rescueEnd ($CC09), rescueScore ($CC3C)
Scenario 4 (menu 5), The Cyber Hordes: droids must destroy five of seven stabiliser cores; against the computer the rebels need 100 VP, the computer gets reinforcementsconfirmedterminalAttack ($CA41); cyberReinforce ($FF67): twelve units sent again three turns after they die
Scenario 5 (menu 6), Paradise Valley: the security device carried to the right of the map; aliens placed at random; hidden tunnelsconfirmedparadiseStep ($CB24): object $85 carried onto column 79 wins; the lifts between the map's two halves; paradiseReinforce ($FEDF)
Saved games to tape and loaded backconfirmedtape ($B15C), flag $67; the Play tab saves and loads

Beyond the documentation

Found in the code, not in the manual. Each is in facts.md.

Open questions

Each part of the game has its own symbol map and listing: The engine, symbols.json and listing.json; The Assassins, symbols.json and listing.json; Moonbase Assault, symbols.json and listing.json; Rescue from the Mines, symbols.json and listing.json; The Cyber Hordes, symbols.json and listing.json; Paradise Valley, symbols.json and listing.json. Write-ups, facts and symbol maps are CC BY-SA 4.0. The game itself is not hosted here.