See DrawRoom, PopulateRoomData and Handler_KeysAndLockedDoors.

See DrawRoomKeysAndLockedDoors_SetDoorBodyInk.

See DrawRoom_SetScaffoldingInk, DrawRoomKeysAndLockedDoors_SetInk and DrawRoomKeysAndLockedDoors_SetDoorNumberInk.

See DrawRoom.

See DrawRoomLadders.

Populated by PopulateRoomData. See DrawRoom and Handler_Doors for usage.

Populated by PopulateRoomData. See DrawRoom, Handler_LaddersDescending and Handler_LaddersAscending for usage.

Populated by PopulateRoomData. See DrawRoom, AnimalsEventTiming, Handler_KeysAndLockedDoors, FindKeyAtPosition and FindMatchingKey for usage.

Populated by PopulateRoomData. See Handler_PortHole for usage.

Populated by PopulateRoomData. See Handler_Pirates for usage.

Populated by PopulateRoomData. See DrawRoom and Handler_Items for usage.

Populated by PopulateRoomData. See DrawRoom for usage.

Populated by PopulateRoomData. See Handler_LiftMasks and Handler_Lifts for usage.

Populated by PopulateRoomData. See Handler_DisappearingFloors for usage.

Initialised at PopulateRoomData. Always set to BufferCurrentRoomData once populated by UnpackRoom. Used by the routine at DrawRoom.

Byte	Control Method
0C	Kempston Joystick
14	Cursor Joystick
1C	Interface 2 Joystick
24	Keyboard

Byte	Meaning
01	Normal Game
02	Game Looped Mode
03	Demo Mode

The count of how much booty the player has collected in the current game.

Initialised to 0000 in InitialiseGame at the start of a new game, unless GameState is set to "Game Looped Mode" (02) in which case the game begins with the previous games value continued (but all the booty is respawned).

Used by the routines at InitialiseGame, PrintStatusBar, AnimalsEventTiming and Handler_Items.

Frames to skip before decreasing the golden key timer at TimerGoldenKey.

Pixel-shift workspace. GoldfishGame_PrintShiftedSprite and PrintShiftedSprite copy the blank tiles from Graphics_MaskSprite here before shifting a sprite.

The sprite ID being written by WriteSpriteBuffer. Starts as one less than the real ID; the print loop increments it.

The width of the sprite being written by WriteSpriteBuffer.

Used to assist with populating TableRoomData, as this table is blank when the game is first loaded.

Note that room ID 22 is never used, and hence is 0000. Room ID 21 is a valid reference (and does have data), but also is not used in the game.

See PopulateRoomBuffer for usage.

PointerCurrentRoomBuffer will point here. Populated by UnpackRoom. Used by DrawRoom.

Note; although this room is present in code, it's unreachable and fairly "broken". See Room #21.

See Room #20.

See Room #19.

See Room #18.

See Room #17.

See Room #16.

See Room #15.

See Room #14.

See Room #13.

See Room #12.

See Room #11.

See Room #10.

See Room #09.

See Room #08.

See Room #07.

See Room #06.

See Room #05.

See Room #04.

See Room #03.

See Room #02.

See Room #01.

Contains the currently in-focus key position; used for highlighting.

See SetDefaultKeyboardInputs for an example of how this is used. Each key is stored as an offset. So a stored value of 05 equates to the "T" key.

This value is incremented every frame, and every 4th frame will cause the player to rise.

Byte width of the source sprite, used when GoldfishGame_PrintShiftedSprite advances to the next pixel row.

First holds the bit-rotate count while shifting, then the tile step when printing.

The number of fish needed to complete the game; see GoldfishGame_InitialiseFishNeeded.

Populated by PopulateSandBuffer.

Set to 02 when a lift overlaps the player. See Handler_Lifts and Handler_Player.

See TablePlayerAttributes.

This value is incremented every frame, and every 4th frame will animate the port holes (if there are any). See Handler_PortHole.

Used by the routines at Handler_Bomb (for creation) and Handler_Explosion for animation.

Initial values are populated from TableDefaultBombSparks.

Used by the routine at Handler_Bomb.

These default values are copied to TableBombSparks.

Used by the routine at AnimalsEventTiming.

Five vertical character positions. AnimalsEventTiming picks a random index 00-03 uses that byte as the spawn row, and the next byte when matching a ReferenceKeysAndLockedDoors entry.

Used by the routines at AbortAnimalEvent, AnimalsEventTiming and Handler_Animals.

Live animal sprite slot. Cleared by AbortAnimalEvent; populated by AnimalsEventTiming.

Three screen-byte masks copied from WalkMaskSources / WalkMaskSources_Middle / WalkMaskSources_Right while the player is walking. Handler_Player ANDs these with the pixels under the player's feet.

Used by the routine at Handler_Player.

Set to 01 when a walk step is ready to reprint.

Keeps track of the current position in the room buffer being processed.

Used by the routines at ConvertCoordinateToBufferOffset, PrintSpriteUpdateBuffer, PopulateGameRoomBuffer and Handler_Pirates.

Working shift count used by PrintShiftedSprite when bit-rotating a sprite.

See Handler_Lifts and Handler_Pirates.

The width of the sprite actively being printed.

The ID of the sprite actively being printed. Note; this starts off as -1 of the real value as it increments to the base sprite ID in the printing loop.

Incremented while walking; Handler_Player treats a count higher than 08 as a fall.

Pixel width working value used by PrintShiftedSprite.

Working row offset used by PrintShiftedSprite.

Set when the player has fallen; written to SoundFlag_PlayerCollision.

Counts down while demo mode is active. Used by the routine at InitialiseGame.

See Handler_Bomb_FrameSkip.

Used by the routine at GetRandomNumber. Not random at all!

Incremented address which points to ZX Spectrum ROM for the purposes of creating the screeching noice you hear when the bomb is counting down.

Increments by one on every generated interrupt.

Used by the routines at GameEntryPoint and MusicThemeTune.

MusicThemeTune ANDs this with *InterruptCounter; the theme tune plays only when the result is zero.

Keep track of the current position of the music data. This is important as the theme tune uses interrupts to play, so it needs to know where to resume playing from.

Used by the routines at GameEntryPoint, ResetSoundFlags, LoseLife and SoundHandler_LoseLife.

Set to 01 by LoseLife. SoundHandler_LoseLife plays when this and SoundFlag_PlayerCollision are both set.

Used by the routines at GameEntryPoint, Handler_Player and SoundHandler_LoseLife.

Written by Handler_Player. SoundHandler_LoseLife plays when this and SoundFlag_LoseLife are both set.

Used by the routines at Handler_BadDoor, Handler_Explosion, Handler_Bomb and Controller_BombSounds.

Byte	Sound
00	Off
01	Fuse
02	Sparks

Used by the routines at GameEntryPoint, Handler_Animals, Handler_BadDoor, Handler_Explosion, Handler_Items, Handler_UnlockDoor, Handler_Pirates, Handler_KeysAndLockedDoors, SoundHandler_CollectedKey, SoundHandler_UnlockedDoor, SoundHandler_CaughtByPirate, SoundHandler_BombExplosion, SoundHandler_CollectedItem, SoundHandler_TouchedAnimal and Controller_GeneralSounds.

Byte	Sound
00	Off
01	Touched By Animal
02	Caught By Pirate
03	Bomb Explosion
04	Collected Item
05	Unlocked Door
06	Collected Key
07	No sound

Used by the routines at AnimalsEventTiming, Handler_Animals and Controller_AnimalSounds.

Byte	Sound
00	Off
01	Rat
02	Bird