Rebelstar Map Editor V1.3 --------------------------- Written by Matthew Carrier, 28th July 2005 In good old Sinclair Basic using X128(PC DOS) V0.93 by James McKay Part of this program has been compiled using Colt ZX Basic Compiler. Initial release 10th August 2005. V1.3 This release 23rd August 2005 ---------- New Update ---------- Let`s take the written rules, screw them up and throw them away! Yup, the Isaac Computer and the Defense Laser can now be placed anywhere on the map. Upto 4 Isaac Computers can be placed on the map, 3 are decoy! Game length (turns) can now be altered. If you want a full day, then the choice is yours. And it is still 1 and 2 player compatible. Woo! The Rebelstar Map Editor already contains an edited map based upon the original game. It has been altered to show 4 Isaac computer systems and relocated Defense Lasers. Try and play this version of the game on level 8 to get a feel as to how the computer deals with everything. And how you change your winning strategy.... ----------- What is it? ----------- This is a map editor for the Firebird game Rebelstar that was written by Julian Gollop. ------------- Requirements. ------------- 1. ZX Spectrum emulator that supports SAVING and LOADING in the common TAP file format - you must know how to LOAD and SAVE using TAP files in your preferred emulator. 2. This map editor program. 3. A copy of Rebelstar (1 or 2 players) in TZX or TAP format. 4. Knowledge of the game, how a ZX Spectrum works and some BASIC programming skills. ------------- Distribution. ------------- 1. As this map editor is still `work in progress` please do not upload to WOS. I will upload when everything has been done. 2. Any publication/distribution on newspaper/magazine coverdiscs must contact me first. ------------------ With thanks to.... ------------------ 1. Jame McKay - for the best ZX Spectrum emulator on the PC. Any LOADING/SAVING hints and tips that are included with this editor program are based only on X128 (PC DOS) v0.93 by James McKay. 2. Vladimir Kladov for EmuZWin. The best debugger/assembler routines ever found on a ZX Spectrum emulator - and the 256 Colour routine too. 3. Threlfal & Hodgson and Hisoft for Colt ZX Basic Compiler Used For speeding up the solving each Soduko. 4. Julian Gollop for Rebelstar - Excellent game. --------- Warranty. --------- This program is supplied `as is`. It won`t screw up your hard drive, computer or dump things where it shouldn`t do. If things go wrong and you do make a complete balls up, then don`t come running to me about it. ------------------------------------------------ What the Rebelstar Map Editor can and cannot do. ------------------------------------------------ The game Rebelstar contains data tables (as yet unfound/decoded) that store the locations of any objects that can be carried (weapons, ammo, keys, coffee tokens, medi probes, droid key etc) This means that this map editor cannot place a weapon/ammo pack onto the map and expect the game to find it when the game starts. So, YOU CANNOT PUT EXTRA WEAPONS, AMMO, KEYS ETC ONTO THE MAP. If you want to try, then load the game, POKE 50000,154 and try to pick up that Photon. The game Rebelstar will shows the item clearly in the map area, (Top left corner) but as there is no data table regarding that particular Photon, the location, how it got there (etc) then it means that you can`t pick it up. Got that? Good. So, having read and understood the above, this is a list of what this map editor can and cannot do (so far). Can do. ------- a) Edit most static items within the map to create a brand new moonbase. This includes all types doors. b) Edit the location of the ISAAC computer and the 3 Defense Laser systems. c) Change the length of game (alter turns). d) Show the start locations of the Raiders (yellow) and most of the start locations of the Operatives (green). Cannot do. ---------- a) Change the start location of the Raiders or the Opperatives. b) Edit stats/name/inventory for each character. c) Edit graphics d) Add weapons, ammo keys etc on the map. Just incase the important information didn`t sink into your head the first time. Remember - this is a map editor and NOT a game editor. ------------------------------ Using the Rebelstar Map Editor ------------------------------ LOADING and SAVING the map data within the editor should be straight forward. Just select your TAP file to load from. The Editor Screen ----------------- At the very top of the editor screen it will show the description of the item at the cursor. Next to that it will show if the item can or cannot be edited or deleted - also know as Denied pickups. If edit states NO then you CANNOT change or delete that object as it is required for the game to operate correctly. Next to that is either 1,2 or X which shows what pick up items are currently displayed. (1 shows the pickups from the 1 player game, 2 from the 2 player game and X will display the locations of both 1 and 2 player games as X) Main Cursor ----------- The main editor cursor can be moved with the following keys:- W - Up X - Down A - Left D - Right with Q,E,Z,C as the diagonals will move the cursor around the screen. Space or M will place the selected item in the highlighted square. 0 will delete the item. Selecting another part of the map --------------------------------- G - Choose another part of the map (using WXAD keys) Space or M to select 9 - abort map selection Item grouping / Item selection ------------------------------ R and F - Choose item grouping. O and P - Select item Denied Pickup items ------------------- Pressing the following number keys will.... 1 - Display all items from the 1 player version and an X for where items from the 2 player version belong. 2 - Display all items from the 2 player version and an X for where items from the 1 player version belong. 3 - Display an X in the pickup location for both the 1 and 2 player versions. Coloured Areas -------------- Yellow areas on the map show the start location of the Raiders. Do not build on the yellow areas - except for craters. Green Areas show the starting area for the Operatives. If the game hangs/freezes then the computer is demanding that an operative must be placed in an area that has been built upon. To Exit the map editor ---------------------- Symbol Shift + H Will now compile the locations of the Isaac Computer and Defense Laser (will take a few seconds). It will then ask for the length of game required. (Default is 80) If any errors are found then you will be taken back into the map editor to make the alterations. Editing Limits etc. ------------------- Isaac Computer You can place upto 4 on the map. Only one will be chosen to be the master computer, the others will be decoys. This is randomly decided when the map data is loaded. Defense Lasers Up to 3 can be placed on the map. If only 1 is placed then you will still get the reinforcements when it is destroyed. If more than 4 Isaac computers or 3 Defense Lasers are found then you will taken back into the map editor to make the alterations. As mentioned before, weapons, ammo, pickup items cannot be placed. --------------- Known Problems. --------------- In the 1 player game (vs computer) the Opperatives are pre-programmed to set paths and do things when the condition arises (ie. defend a pre-defined area when it is invaded or rush to defend a door when it has been opened) there may be times when the game will throw robots at walls or even shoot at a new wall that should not be there. Some computer controlled Operatives will not move/shoot/defend until the Raider enters a pre-defined area/zone. This does look strange but this is again all because of the way the game has been programmed. Any problems regarding the game crashing/freezing at the very start are due to there being building on the Raiders or Operative starting location - Remove that data and try again. ---------------------------------- Extracting Map Data From Rebelstar ---------------------------------- The following information to extract the map data can be used on both the 1 and 2 player editions of the game. Knowledge of Loading, saving and selecting TZX, TAP files, autostarts and pausing is required for your choice of ZX Spectrum emulator. This will be different for each emulator. Read the manual. Select your REBELSTAR TAP/TZX file type in lines 10 to 30, pressing Enter after each line. 10 CLEAR 24699 20 LOAD "" SCREEN$ 30 LOAD "" CODE type RUN (Enter) and play the TZX/TAP file This will load the screen and then the main code. It will then stop with an OK message OPEN a TAP file (give it a filename) and then type in SAVE "map" CODE 50000,4000 (Enter) Press any key to save Once the OK message appears then CLOSE the TAP file. You have now extracted the map data from the game. ------------------------------------------ Inserting Your New Map Data Into Rebelstar ------------------------------------------ NOTE: Spectrum emulators deal with TAP files and how they load in slightly different ways. Read the manual. Reset the Spectrum. type in the following lines (pressing Enter after each line) CLEAR 24699 BORDER 0: PAPER 0: INK 7: CLS 1 LOAD "" SCREEN$ 2 LOAD "" CODE Select your Rebelstar TAP/TZX 1 player or 2 player file. RUN the program Start you TAP/TZX file and the game will load but not start. Type in 1 LOAD "" CODE 16384 2 RANDOMIZE USR 20384 Select your new map data TAP/TZX Run the program Start your TAP/TZX file and the screen will fill with garbage and then an OK message. This random garbage is the map data and a short code routine that detects if the 1 or 2 player version has been loaded. It also copies the pick up items into the correct place depending on what version has been loaded. It will sort out the Isaac Computer decoy routine and Defense Laser situation. Nice. Now type in (for 1 player game) 1 RANDOMIZE USR 24700 2 RANDOMIZE USR 24900 : GOTO 2 (for the 2 player version) 1 RANDOMIZE USR 25000 : GOTO 1 type RUN and Enter The game will now start with your map in the game. --------------- Future updates. --------------- The map is loaded into the screen area and copied to the main map area to allow for future updates. I have decided that loading the map data this way will (in theroy) make things easier to alter those pesky data table (once they have been decoded) without having multiple and incompatible map loading strategies. Current map editor routines in development are:- > Show player 1 and 2 start locations. - DONE > 1 -2 Player compatability mode checking - DONE > Altering Isaac Computer and Defense Laser placements - DONE > Clear screen, randomly place craters. Memory is now very tight - approx 1k left. Suggestions, improvements bugs/mistakes are welcome. Have fun and enjoy. Mat email: kindawitch@hotmail.com