An unofficial disassembly of JETPAC, the classic 8-bit computer game released in 1983 for the 16K ZX Spectrum home computer.

This disassembly has been created from the raw binary data of the original ZX Spectrum JETPAC cartridge ROM, using the SkoolKit disassembly toolkit.

A fast-paced shooter video game for 8-bit home computer systems.

Jetpac is the first instalment in the Jetman series, followed by Lunar Jetman (1983) and Solar Jetman: Hunt for the Golden Warpship (1990).

The 'Acme Interstellar Transport Company' is delivering SPACESHIP KITS to various planets in the solar systems throughout the Galaxy; and as chief test pilot, all you have to do is assemble the Rockets, and thrust onto your next destination.

But! as you don't often get the chance of a free trip across the Galaxy, and space travel is, oh, so expensive, now is your chance to get rich! You might just as well stop off on several planets on your journey, collect the odd sack of precious gems, elements or gold, and take them back with you.

Sounds simple doesn't it!

But! before you go and make yourself the richest person in the whole Universe, you must remember to refuel your Spaceship, every time you land on a planet, with 6 fuel pods. Any other goodies you collect, are yours to keep. Upon landing, you will find yourself equipped with the very latest Hydrovac JET PAC, which can automatically airlift almost any rocket stage, fuel pod or valuables, you care to land upon, and release them over the rocket ship base, plus mega powerful, Quad Photon Laser Phasers, to blast any nasty, mean, little aliens who might object to your visit.

And my! do those aliens get upset, when you collect all of their valuables, and sneak off, without so much as a by-your-leave.

JETPAC was designed and developed by Chris Stamper and Tim Stamper in 1983 for the 16K and 48K Sinclair ZX Spectrum.

This disassembly might be considered done.

• All code blocks have been labelled and annotated.
• All variables have been labelled and annotated.
• All data has been isolated and annotated.
• All text data has been annotated.
• All graphics have been annotated (tiles, sprites).
• All game buffers (baddie/collectible) are annotated.

However, there are still a few sections of code and variables that would benefit from a deeper analysis.

Feedback and submissions are welcome!

When the ZX Spectrum boots from a cartridge the loader routine located at address 0000ドル is executed. This routine copies the loading screen to the Spectrum display file, and waits for the player to press a key. The game code and data is then copied to the computer RAM at address 6000ドル (24499 in decimal).

So that the disassembly is placed at the correct address, Skoolkit needs to be given an address to start writing the bytes. The following command will extract the game from the .rom image (not included in this repository), apply the disassembly annotations and write the resulting source code to a .skool file:

$ sna2skool.py -c jetpac.ctl -Hl -o 24499 jetpac.rom > jetpac.skool

Skoolkit can generate valid Z80 ASM code with the following command:

$ skool2asm.py -H -crs jetpac.skool > jetpac.asm

The generated asm won't be able to start the game without a loader routine. A basic example is provided in the file loader.asm.

The Pasmo Assembler can be used to assemble the source into a working ZX Spectrum tape image.

$ pasmo --tzxbas loader.asm jetpac.tzx

This section contains some notes on how the cartridge and cassette versions of Jetpac differ.

The code in the two versions is identical except for a slight difference on where it's loaded in memory, and that the cassette version supports the Kempston joystick instead of the Interface 2. There is also a code mover routine used during tape loading.

The BASIC tape loader is one long line of instructions, which has been reformatted to fit here.

1 CLEAR 24575:
 BEEP .1,1: BEEP .1,2: BEEP .1,3: BEEP .1,4: BEEP .1,5:
 PAPER 0: INK 7: BRIGHT 1: CLS : PRINT BRIGHT 1;INK 7;
 AT 9,7;"JETPAC IS LOADING";
 AT 12,10;"PLEASE WAIT":
 PRINT AT 0,0: LOAD ""SCREEN$ :
 INK 0: PAPER 0:
 PRINT AT 5,0: LOAD ""CODE :
 PRINT AT 5,0: LOAD ""CODE :
 PRINT AT 5,0: LOAD ""CODE :
 PRINT AT 5,0: LOAD ""CODE :
 PRINT USR 24576

Below is the skoolkit t2s config file, which can be used as a starting point for disassembling a TZX image file.

; tap2sna.py file for Jetpac cassette version. Run
;
; $ tap2sna.py @jetpac.t2s
;
; to create a Z80 snapshot.
jetpac.tzx
jetpac.z80
; Skoolkit handles these automatically,
; but listing here for reference.
; ram load: 4,16384 # load screen (JPSP)
; ram load: 6,24576 # load game code/data
; ram load: 8,23424 # load `mover` routine
; ram load: 10,23728 # load `JP (HL)` opcode
; ram load: 12,23672 # load game start check variables
; After the game loads the PC starts at 6000ドル:
;
; c6000ドル DI
; 6001ドル JP 5ドルB80
;
; The `mover` routine at 5ドルB80 moves bytes 24580-32772 down to 24576-32768.
; This routine is loaded from tape block #8 (see above).
--ram move=6004,ドル2000,ドル6000ドル
; Initialize all game variables and data so the source code is clean.
--ram poke=5ドルCCB-5ドルFFF,00ドル
--reg sp=5ドルCF0
--reg pc=61ドルE5

As you can see, --ram move=6004,ドル2000,ドル6000ドル emulates the mover routine found on the tape. For those interested, that routine is as follows:

; Skoolkit code mover disassembly for Jetpac
; Disassembly of the code mover routine, which copies 8192 bytes from address
; 6004ドル down to 6000,ドル before then jumping to the game start routine.
c5ドルb80 ld hl,6004ドル ;
 5ドルb83 ld de,6000ドル ;
 5ドルb86 ld bc,2000ドル ;
 5ドルb89 ldir ;
 5ドルb8b jp 61ドルe5 ;
; Tape block #6 ("The Game") is loaded at this address, starts running, then
; calls the above routine, which then overwrites these instructions.
c6000ドル di ;
 6001ドル jp 5ドルb80 ;

The Kempston joystick menu entry:

 62ドルdc defm "4 KEMPSTON JOYSTIC"
 62ドルf0 defb $cb ; ASCII "K" (4ドルB) + EOL control bit

The joystick reading routine and how the values are used in the code do have some small differences. Here is the main read routine itself:

; Joystick Input (Kempston)
;
; Output:A Joystick direction/button state.
@label=ReadKempstonJoystick
c733ドルa in a,(1ドルf) ; Joystick port
 733ドルc cpl ; Invert all bits in #REGa
 733ドルd ret ;

In the keyboard read code there is an out ($fd),a instruction, which seems to cause issues on the 128K Spectrums and therefore will need changing to NOP instructions.

; jetpac.skool
- 7326ドル out ($fd),a ; Set port for reading keyboard
+ 7326ドル nop
+ 7327ドル nop

This disassembly, comments and support files, Copyright © 2020 Michael R. Cook.

JETPAC Copyright, ULTIMATE PLAY THE GAME. Copyright & Trade Name, 1983 Ashby Computers & Graphics Ltd. All rights reserved Worldwide.