Coin Rush - ZX Spectrum extended expansion of the Speed Coin arcade prototype by Stern(c)1984, by oblo@2026 ----------------------------------------------------------------------------------------------------------- This is a free game, made for fun and for the love of it (Speed Coin was a prototype that was never finished nor released, so this game is my homage to it). You may use both the compiled program and the source code for personal use, or any other non-profit reason. It may not be sold, rented or used in commercial and/or profit-making activities. You are free to improve and modify it. If you reuse part of the code, a mention of the original author would be appreciated. Created with Boriel ZX Basic v1.19 and ZX Basic Studio v1.7.0, plus my own Sanra Toolkit: Sanra AY System (music and sound effects), Sanra Turbo Loader (turbo tape) and Sanra 3Disk (+3 disk). AI used (Claude Opus 5.5) for ASM routines, testing, finding and fixing bugs, and improving the overall structure of the code. Tested with the Fuse emulator, Spectaculator, and The Spectrum. All rights reserved to their respective owners (mainly Stern Electronics and/or anyone else they may apply to). Versions: - v1.0 48K (tape): beeper sound. - v2.0 128K (tape): AY music and sound effects, bonus stages, stage editor (stages saved to and loaded from tape) and HOW TO PLAY/CREDITS pages. All 128K models: 128K, +2, +2A, +2B and +3. Two tapes with the same game: * CoinRush_v2.0_turbo.tzx -> fast loader (about 3.5 minutes) * CoinRush_v2.0_std.tzx -> standard ROM loader (about 8 minutes), for real tapes or if the turbo tape fails - v3.0 +3 (disk): the 128K version on disk (CoinRush_v3.0_Plus3.dsk). The stage editor saves and loads stages on drive A:. The 128K and +3 versions must be loaded in 128K mode (Tape Loader / Loader); in 48K mode they only show a message and stop. Instructions: - In the main menu: * Q key -> moves the cursor up * A key -> moves the cursor down * O / P keys -> change the value of the option * ENTER key (or SPACE) -> selects the option * A Kempston or Sinclair joystick also works in the menus * If no key is pressed for a while, the BEST TIMES tables are shown (any key goes back to the menu) - Menu options: * START GAME -> starts a game * MODE -> NORMAL, RACE or ACROBAT * CPU -> skill of the CPU coin in RACE (EASY -> NORMAL -> HARD) * START LAYOUT -> first stage (1 to 14) * PRACTICE -> OFF / ON: the clock stops and no coins are lost (not in RACE) * COIN -> AUREL, TERRA, CREDIT or MOMENT (only the look of the coin) * CONTROLS -> keyboard, Kempston joystick, Sinclair joystick (keys 6 and 7) or Cursor joystick (keys 5 and 8) * MUSIC -> ON / OFF (128K and +3) * REDEFINE KEYS -> redefines the game keys (left, right, pause, quit and, in 128K and +3, music). In 128K and +3 it then asks whether to redefine the stage editor keys too (Y / N). ENTER keeps the current key; a repeated key is refused. * STAGE EDITOR -> opens the stage editor (128K and +3) * HOW TO PLAY/CREDITS -> 10 pages of instructions and credits; O / P turn the pages, ENTER or SPACE goes back (128K and +3) * DEMO -> the CPU plays one lap of the chosen MODE; any key ends it - During the game (default keys): * O key -> tilts the platform to the left * P key -> tilts the platform to the right * H key -> pause * Q key -> quits the game (asks Y / N) * M key -> turns the music on or off (128K and +3) * With a joystick, left and right tilt the platform; pause, quit and music always use the keyboard - During the pause: * H key -> resumes the game * Q key -> quits the game (asks Y / N) - When you set a new best time (at the end of the game): * Letters, numbers or space -> type your initials (3 characters) * ENTER key -> keeps the letter shown * DELETE key -> goes back one letter How to play: - Tilt the platforms to roll the coin down, one platform after another, into the pit in the floor before the clock runs out. - Only the coin's platform tilts: hold left or right to lower that end and the coin rolls that way. Let go and the platform goes flat. When the coin drops off, the next platform down tilts at once. - Missing the pit, hitting the floor, leaving the screen by one side or running out of time breaks the coin, and the stage starts again. With no coins left, the game is over. - You start with 3 coins and win one more after stages 8, 24, 40 and so on (9 at most). From stage 9 every clock starts 2 seconds lower, and from stage 17, 4 seconds lower; in NORMAL the coin also rolls faster every 16 stages. - There are no points, only times: each stage counts the time you take, and TOTAL TIME adds up the stages of the game. The clock colour rates your speed: FAST (white), GOOD (cyan) and SLOW (red); it flashes 3 seconds before it changes. - Modes: * NORMAL -> 14 stages in order from the START LAYOUT (stage 14 is followed by stage 1). * RACE -> beat the CPU coin (its lane is on the right) to the pit. A CPU win costs a coin; a draw is yours. * ACROBAT -> 14 stages of their own. Every landing bounces, each bounce lower than the last, until the coin rolls; the tilt when the coin takes off aims the bounce. Catch the stars in the air: each one takes 1.0 second off the stage time. Going up, the coin cannot pass through a platform: it hits it and falls back. * PRACTICE -> the clock stops and no coins are lost; a cleared stage moves on to the next one. * DEMO -> the CPU plays one lap of the chosen mode. - BEST TIMES: the best time of each stage, with its rating colour and initials, in two tables: NORMAL (RACE counts too) and ACROBAT. PRACTICE and DEMO do not count. The tables are kept until the computer is switched off. Bonus stages (128K and +3): - After every 4th cleared stage in NORMAL and ACROBAT (not in RACE, PRACTICE or DEMO). No coin can be lost and the bonus time does not count; the clock ends it. - The ball bounces on the rows of bars and never loses height. Hold left or right to slide the row under it and open a gap. - The bin the ball drops into lights its letter for the rest of the game. Spell SPEED for an extra coin; the COIN bin gives one more (once per game). Stage editor (128K and +3): - Make your own NORMAL or ACROBAT stages: up to 7 platforms (2 to 20 tiles long), the pit and, in ACROBAT, up to 4 stars. The editor refuses any change that breaks the rules (for example, platforms too close together) and shows why. - Editor keys (default keys; they can be changed in REDEFINE KEYS): * Q / A keys -> move the selected item up / down * O / P keys -> move the selected item left / right * Z / X keys -> make the selected platform shorter / longer * SPACE key -> selects the next item (platforms, pit, stars) * N key -> adds a platform or a star * D key -> deletes the selected platform or star * T key -> test play (the clock stops and no coins are lost), then back to the editor * ENTER key -> editor menu * M key -> turns the music on or off - Editor menu: CONTINUE, PLAY STAGE (real rules and its own best time), NEW NORMAL, NEW ACROBAT, COPY (starts from any of the 28 built-in stages), SAVE STAGE, LOAD STAGE and EXIT. - A stage must be cleared once (with the test play or PLAY STAGE) after its last change before it can be saved. - 128K tape: SAVE STAGE asks for a name and saves the stage to tape; LOAD STAGE asks before replacing the current stage and loads the next stage file found on the tape (BREAK cancels). - +3 disk: SAVE STAGE asks for a name (up to 8 characters) and writes NAME.CRS to drive A: (it asks before replacing a file with the same name); LOAD STAGE lists the .CRS files on the disk (Q / A / O / P move, ENTER loads, DELETE goes back). Music (128K and +3): rags and waltzes by Scott Joplin (public domain), arranged for the AY chip by oblo. * Menu -> A Breeze From Alabama * NORMAL -> Antoinette and Swipesy Cake Walk (with Arthur Marshall) * RACE -> Lily Queen (with Arthur Marshall) and Silver Swan Rag * ACROBAT -> Augustan Club Waltz and Binks' Waltz Acknowledgements: - To Sir Clive Sinclair, for creating this wonderful machine that opened up a world of possibilities for us. - To Stern Electronics, for Speed Coin, and to the MAME team, for preserving this unreleased prototype. - To Scott Joplin, for his catchy, timeless rags which have been entertaining us for more than 100 years. - To Boriel for his ZX Basic compiler (https://zxbasic.readthedocs.io/en/latest/) - To Dr.Gusman and the rest of the team who developed ZX Basic Studio (https://github.com/boriel-basic/ZXBasicStudio). - To Duefectu for his "Boriel Basic Manual para torpes" (https://github.com/Duefectu). - To the creators of emulators, the ZX Spectrum forums that keep it alive, and all the cross-development tools for the ZX Spectrum in general, without which this would not have been possible.