----------CivEdit Instruction Manual---------- 1. Introduction 2. Getting Started 3. Scenario Editor 3.1. Updating a Scenario 3.2. Editing a Scenario 3.3. Editing a Technology 3.4. Editing a Unit 3.5. Saving a Scenario File 4. Map Editor 5. Game Editor ----------1. Introduction:---------- Civ89 is a turn-based strategy game for the TI-89, TI-89 Titanium, TI-92 plus, and Voyage 200 calculators that is based on the Civilization series. It is playable by two human competitors on the same calculator. The two players are designated by color into the black player and the gray player. It is no-stub, meaning that no additional software is required to run the program. CivEdit is an editor program for Civ89. It allows you to edit and create map, scenario, and game files. Note that the only way to delete these files is through the operating system. You can do this by pressing 2nd + “–” (var-link), finding the desired file in the variable list, pressing F1 (manage), and pressing ENTER (delete). Be warned that deleting a scenario file will make all saved games that use that file unable to function. ----------2. Getting Started:----------- Before using CivEdit, it is important that you back up all important data to a computer. While I have done my best to ensure that this program will not harm your calculator, it is possible that your calculator will crash while running CivEdit, as with all games of such complexity. All game files (civgame*, map*, scen*) must be in the main folder, but they may not be archived if you intend to edit them. In particular, the saved games (civgame*) will be modified after each turn (unless autosave is turned off). The actual program files (civ89, civzip) may be placed in any folder, as long as they are in the same folder, and they may be archived. There are three options at the title screen: edit a scenario, map, or game. ----------3. Scenario Editor:----------- The scenario editor allows you to create and edit custom unit and technology sets. Civ89 is designed to handle a number of custom scenario settings. After selecting “Scenario” from the title screen, three options will appear. You can start a new scenario, load an existing scenario, or update an existing scenario. 3.1. Updating a Scenario: There is a subtle but important difference between loading a scenario and updating a scenario. If you load a scenario and then save it, any saved games that use the scenario file you loaded will be unable to use the new scenario file. By contrast, if you update a scenario, saved games will be able to use the updated scenario file. The drawback to the update option is the removal of certain options, since this would make saved games that use the file unable to function properly. You cannot add new units or technologies. You will be unable to edit existing technologies. You cannot change a unit’s name, defense rating, movement points, prerequisite, type, number of units it can transport, whether it can build canals, or build speed. If you wish, you can save an updated scenario file in a different file than the old scenario. This may make saved games compatible with multiple scenario files. Any saved game that could load from more than one scenario file will choose the lowest file number from which to load. 3.2. Editing a Scenario: Each scenario has two aspects that you can edit: technologies and units. To view all technologies, press F2, as indicated at the bottom of the screen. To view all units, press F3. There is also a screen that allows you to view all of the sprites, or pictures, of all of the units. To access it, simply press F4. 3.3. Editing a Technology: After pressing F2 to view all of the technologies, scroll through the technologies using up and down. To view information about a technology, press F1. To delete an existing technology, select the desired technology and press backspace. To edit a technology, select it and press ENTER. To create a new technology, select “(new technology)” and press ENTER. Note that there is a limit of 63 total technologies. From the technology edit screen, you have access to all of the details of a particular technology: its name, prerequisites, age, and benefits. Use up, down, left, and right to scroll through available options. To change the name, select it and use the letter keys, backspace, and clear to edit it. Note: As in Civ89, you never need to press the ALPHA key! Simply pressing a key is the same as pressing the corresponding letter. To change the prerequisites, highlight one of them and use +, –, backspace, or the letter keys. To change the age, select it and use +, –, or ENTER. To change whether a technology imparts an empire with the ability to build bridges, allowing settler units to build roads on spaces with rivers, highlight next to where it says “Bridges:” and press +, –, or ENTER. To change any of the other benefits, you must set one digit at a time. Select a digit and use +, –, or the number keys to change it. Note that all of the percentages must be multiples of 5, and no two technologies can have the same name. Also, the limit for the total production or science benefit an empire can have is 1000%, and the limit for city revenue is 200 gold. Once you have finished editing a technology, highlight “Done” and press ENTER. If you decide not to use the changes you have just made, go to “Cancel” instead and press ENTER. Each technology must meet two requirements before a scenario can be saved. It must not be its own prerequisite. For example, the editor will not allow you to save a scenario in which “Horsemen” is the prerequisite of “The Wheel” and “The Wheel” is also the prerequisite of “Horsemen”. Secondly, each technology must have some benefit, whether this benefit is a unit or an empire benefit or the technology allows research of another technology. 3.4. Editing a Unit: After pressing F3 to view all of the units, scroll through the units using up and down. To see information about a unit, press F1. To delete a unit, highlight it and press backspace. To edit a unit, choose it and press ENTER. To create a new unit, select “(new unit)” and press ENTER. Note that there is a limit of 84 total units. From the unit edit screen, you can change anything about the unit: its name, its attack rating, its movement points, its sprite (picture), its prerequisite, its type, the number of turns it takes to produce, its cost, the number of units it transports, whether it can build canals, its build speed, how much gold it mines per turn, by how much it assists a city’s production, its blast radius, for how much it can attack air and high air units, and whether it is destroyed after attacking. Use up, down, left, and right to scroll through available options. To change the name, select it and use the letter keys, backspace, and clear to edit it. To change any of the digits in any of the details, select the desired digit and use +, –, or the number keys to change it. Setting the build speed to 0.0 makes a unit unable to build roads or rivers, and setting “Mines” to 0 makes a unit unable to mine. To change the unit’s sprite, select the box in the upper-right hand corner and press ENTER to activate the sprite editor screen. To set a unit’s prerequisite, select it and use +, –, backspace, or the letter keys to change it. To change the unit type, use select it and use +, –, or ENTER. To change whether the unit it destroyed after attacking, highlight next to where it says “Destroyed After Use:” and press +, –, or ENTER. There are a few limits to editing a unit. Bomber units must have 0 movement points. “Turns to Produce” must be at lease 0.1. The limit for the number of “Turns to Produce” is 24.9. Units that can build canals must have a build speed of at least 0.1. “Assists City”, “Vs. Air”, and “Vs. High Air” need to be percentages in multiples of 5. A unit’s cost must be a nonzero multiple of 10. The limit for “Assists City” is 295%. When you have finished editing a unit, select “Done” and press ENTER. If you want to cancel all of the changes you have just made, select “Cancel” instead and press ENTER. Pressing F4 will let you see all of the sprites, which are pictures used to represent each unit. You can even change the sprites for water, road, river, mine, and city spaces. Use up, down, left, and right to scroll though available sprites. You can also use + and – to move sprites forward and backward. A unit’s position has a special significance in the game. It is used to break ties in hit points in displaying a unit. For example, a “Chariots” and a “Horsemen” unit with full health have the same HP, so if they are on the same space, the game will show to “Chariots” unit, since it is earlier in the list. Also, when a construction project is finished, movement points will be deducted from the later units first. Finally, when the game asks you to input starting units at the beginning of a new game, it does this in order from earliest to latest unit, using only units with no prerequisite. Note that it will only show a maximum of 9 units. To edit a sprite, use up, down, left, and right to change the selected pixel, or square, and press ENTER to change it from white to black or from black to white. Note that an actual-size image of the sprite appears in the lower-right hand corner. When you have finished, press F1 to save the new sprite or press F2 to stay with the old sprite. 3.5. Saving a Scenario File: To access the scenario menu from the list of technologies, units, or sprites, simply press ESC. Use up and down to scroll through available options, then press ENTER. If you select “Continue Editing”, you will return to the editor. Selecting “Exit Scenario Editor” will display the title screen. If you select “Save”, it will first show the scenario name entry screen. Use the letter keys, backspace, and clear to type in a name for your scenario, then press ENTER. Next, it will show a list of scenario files. Choose one using up and down, then press ENTER. If you replace an existing file, it will ask you if you want to overwrite it, or, if the two are compatible, update it. Press F1 to confirm and F2 to cancel. The game will then tell you “Scenario has been saved.” ----------4. Map Editor:---------- In the map editor, there are two options, make a new map and load an old map. Choose one and press ENTER. The map screen looks very similar to the Civ89 play screen, and it operates very similarly. Use up, down, left, and right to scroll through the map. The controls are indicated on the right side of the screen. Press “1”, “2”, or “3” to set the draw size. This will allow you to change 1, 9, or even 25 spaces at the same time with a single button. Press F1 to change the selection to a water space. Press F2 to change it to a land space. Press F3 to toggle the presence of mines, F4 to toggle rivers, and F5 to toggle roads. Press “x” to add a black city to the highlighted space and “y” to add a gray city. Press backspace to delete the city at the current space. Use + and – to change a city’s number. Note that starting units will appear at the city numbered 1. Press ESC to activate the menu. There are 4 options: “Continue Editing”, which will return you to the map screen, “Save”, “Change Size”, which allows you to change the map size, and “Exit Map Editor”, which returns it to the title screen. If you select “Save”, a list of map files will appear. Select one using up and down, then press ENTER. To change the map size, use left and right to highlight a digit to change, and press +, –, or the number keys to change it. Note that the minimum for both width and height is 11. ----------5. Game Editor:---------- There are only a few game options that you can edit in saved games. After selecting a saved game, these options will appear. Use up, down, left, and right to scroll. To change the handicap, use + and –. To change the player names, use the letter keys, backspace, and clear to enter a name. To change the save file and turn limit digits, highlight the appropriate digit and use +, –, or the number keys. After you finish, you can choose either to save the changes or to cancel. To do this, select either “Save” or “Cancel” and press ENTER. That’s it! Have fun creating unique scenarios and maps for Civ89, and feel free to distribute them online or to your friends. There is even a place for custom-made files on my website if you should choose to donate any.