GALACTIC EMPIRE Version 3.2 Installation and Operations Guide 1.0 Overview 2.0 Installation 3.0 Game Operations 4.0 Configuration Option 5.0 Documentation 6.0 Support 1.0 Overview Congratulations on purchasing the most popular add on to the MajorBBS. Galactic Empire has been installed in MajorBBS's since 1988 and provided thousands of players an exciting and challenging game that continues to generate thousands of hours of usage. Release 3.2 represents the latest in an ever evolving game of space battle and conquest. With the increased processing power and expanded memory available in today's systems, and the standardization provided by Galacticomm's release 6.0 of the MajorBBS, we are able to include many advanced features which just a few years ago would not have been possible. Galactic Empire 3.2 is simple to install and even simpler to operate. To get your game on-line and your users playing simply follow the instructions in the following section. NOTICE: The software is distributed to you un-registered. You can begin running it prior to registration. Send in the registration documentation (attached to this guide) immediately as there is a limited number of days it will operate without a Registration ID. Upon receipt of your Registration Documentation you will be sent a unique Registration ID valid for your specific MBBS system. Simply enter this ID in the REGNO field in the configuration options. For further information refer to section 4.0 below. 2.0 Installation from a release diskette Use this procedure if you received your Galactic Empire on a release diskette. If you downloaded a .ZIP file from our support system refer to section 2.2 and 2.3. STEP 1: Copying files from install diskette to your system. In order to install Galactic Empire place the release diskette in your floppy diskette drive and type the following command; A: INSTALL A: C:\BBSV6 Note: If your floppy diskette is B: then substitute "B:" for "A:" above. Also, if your BBS is installed on another drive or in another directory, please substitute your drive and directory for the "C:\BBSV6" above. The install procedure will copy the appropriate files to your BBS directory with virgin databases ready to play. STEP 2: Adding Galactic Empire to your menu. Using the procedure outlined in your MajorBBS Guide, add Galactic Empire to your menu. STEP 3: Play the game.... and have fun. 2.1 Upgrade from a release diskette Use this procedure if you received a Galactic Empire update on a release diskette. If you downloaded a .ZIP file from our support system refer to section 2.2 and 2.3. NOTE: ALWAYS BACKUP YOUR SYSTEM PRIOR TO MAKING ANY MAJOR CHANGES! STEP 1: Copying files from install diskette to your system. In order to update Galactic Empire place the release diskette in your floppy diskette drive and type the following command; A: UPDATE A: C:\BBSV6 Note: If your floppy diskette is B: then substitute "B:" for "A:" above. Also, if your BBS is installed on another drive or in another directory, please substitute your drive and directory for the "C:\BBSV6" above. The update procedure will copy the appropriate files to your BBS directory but will not effect your existing databases. STEP 2: Play the game.... and have fun. 2.2 Installation from a downloaded ZIP file. Use this procedure if you received your first copy of Galactic Empire by downloading it from our support BBS. If you are updating a previous release please refer to section 2.3 below. STEP 1: Copy the downloaded file to your BBS directory COPY MBMGEnnn.ZIP C:\BBSV6 Note: replace nnn with the actual files version number (i.e. MBMGE30J.ZIP) Note: If your BBS is installed on another drive or in another directory, please substitute your drive and directory for the "C:\BBSV6" above. STEP 2: Unzipping the downloaded file. PKUNZIP MBMGEnnn.ZIP The install procedure will create the appropriate files to your BBS directory with virgin databases ready to play. STEP 3: Adding Galactic Empire to your menu. Using the procedure outlined in your MajorBBS Guide, add Galactic Empire to your menu. STEP 4: Play the game.... and have fun. 2.3 Upgrade from a downloaded ZIP file. Use this procedure if you downloaded an update from our support BBS. The main difference is that an update will not contain empty databases unless absolutely required. NOTE: ALWAYS BACKUP YOUR SYSTEM PRIOR TO MAKING ANY MAJOR CHANGES! STEP 1: Copy the downloaded file to your BBS directory COPY UPDGEnnn.ZIP C:\BBSV6 Note: replace nnn with the actual files version number (i.e. UPDGE30J.ZIP) Note: If your BBS is installed on another drive or in another directory, please substitute your drive and directory for the "C:\BBSV6" above. STEP 2: Unzipping the downloaded file. PKUNZIP UPDGEnnn.ZIP The update procedure will create the appropriate files to your BBS directory but will leave your existing databases in place. STEP 3: Play the game.... and have fun. 3.0 Operations Galactic Empire is designed to be simple to operate, requiring almost no intervention on your part. There are however some operational aspects which you may wish to consider. 3.1 CPU Performance Galactic Empire is a complex game and depending on how configured can consume a sizable amount of CPU time. In order to maintain acceptable performance you must insure that your system is configured appropriately. The following parameters effect CPU performance dramatically and should be configured carefully for your specific CPU. Note: The default parameters are set for performance on a 33 MHz 386 CPU. Your system's performance may vary and require changes to these settings. MAXPLRS - Controls how many "real" players can be in the game at the same time. You may wish to limit this value to decrease the load on the CPU. SHOWOPT - Controls how many "GE" informational messages are generated. Leave set to "0" for optimal performance. PLANTOCK - Controls how frequently all the sectors in a Galaxy are updated. Setting this value lower increases CPU load. WORMODDS- This option controls the odds of a newly created planet being a wormhole instead. The lower then number the higher the odds. Since when a wormhole is created the destination wormhole sector also must be created, additional disk I/O must occur. The lower you set this number the more disk I/O you will experience. Depending upon the speed of your hard disk and cache this may or may not be a problem. NUMSHIPS - Controls how many "robot" ships are in the game. Set this value as high as you can, while maintaining acceptable performance. The more ships in the game, the more enjoyable it is. This value has the most dramatic effect on the CPU as each of the additional ships requires the same CPU resources as a live player. UNIVMAX - Controls the size of the Galaxy. You can reduce this number to control the number of sectors that the game has to process in the time specified by PLANTOCK above. Reducing this number decreases the CPU load. Because the Galaxy grows as the game is played you may notice decreased CPU performance as the game progresses for some time, and the databases grow correspondingly. 3.2 Database Growth In order to insure that your game continues to operate un-interrupted, you must make sure that there is plenty of disk space available for database growth. The MBMGEUSR.DAT, MBMGESHP.DAT, MBMGEXRF.DAT, and MBMGEMAL.DAT are proportional to the number of users in the game. The MBMGEPLT.DAT database grows as more players explore the galaxy. Most sectors created will be void of planets and only take a small amount of storage. Since sectors are not created until a player actually scans it the total storage required is minimized. The average space required is 512 bytes per sector created. Reserving 32,767,000 bytes (32.7 meg) for growth allows for about 64,000 sectors. If you have less space available you may consider decreasing the MAXPLREC option in the next section. Each time the system performs the nightly cleanup it will tell you the approximate size of the planet database. Additionally the MajorBBS allows you to display how much disk remains unused. If you have a relatively limited amount of disk storage please monitor these values regularly to insure the integrity of your entire system. 3.3 Campaigns Galactic Empire is best when played in campaigns lasting 1 to 3 months. You may wish to award players some additional bonus such as credits based upon their performance at the end of the campaign. When you reset a campaign simply initialize the Galactic Empire databases by typing the following while in your BBSV6 directory. COPY MBMGE*.NEW MBMGE*.DAT You can now begin a new campaign. You may wish to "tweak" some of the configuration options such as Galaxy Size, and/or ship configurations to vary a campaign from the previous one. See the following section for more details. 3.4 System Operator Special Commands Included in Galactic Empire are several commands reserved specifically for your use. These commands are enabled with the SYSCMDS and SYSONLY options detailed in section 4.2 below. These special commands provide some assistance in debugging problems. They can however give a player a distinct advantage if discovered, and it is not recommended that they be used in the production system all the time. SYS GET xxxxx This will grant to the ship xxxxx of the items requested. Example: SYS GET 100 TOR gets you 100 torpedoes. SYS KILL Causes a player in the game to have his ship destroyed for unknown reasons. Example SYS KILL GREMLIN will kill Gremlins ship SYS CASH xxxxx This will grant to the ship xxxxx C's of cash. Example: SYS CASH 999999 will give the ship 999999 in C's SYS GOTO x y This will move the ship to the sector in the universe with the specific x and y coordinates. Example: SYS GOTO 10 10 will move the ship to the x=10, y=10 sector. SYS SHIELDTYPE n This will give the current ship a shield of type n. Valid types are 1 to 5. A special type of 20 is an ultimate sysop shield. SYS PHASERTYPE n This will give the current ship a phaser type on n. Valid types are 1 to 4. A special type of 20 is an ultimate sysop phaser. SYS CLASS n This will change the current ship to a ship class of n. Valid classes are 0 to 7 and 13. NOTE: IF you set the class to 8 or 9 (Cybertrons) problems may result. SYS MAINT This will begin a fast Maintenance Procedure on the current ship regardless of your orbit status. SYS UNJAM This clears the effects of a jammer on the current ship immediately. SYS LIST This command lists all the active ships in the game, their location, and damage status. SYS CLASSLIST will list the classes currently loaded in the game. This will tell you what class the SYSOPIAN DEATH STAR is for the SYS CLASS command. 3.5 Undocumented Commands In addition to the commands documented in the Galactic Empire Users Guide, there are a few special commands which are undocumented. There are two classes of undocumented commands; 3.5.1 System Information Commands These commands are included to assist us in determining problems when you call for Technical Support. RG# Reports the Galactic Empire Registration number, and Test Drive status. 3.5.2 Special Terminal Program Commands These commands are included specifically to support terminal programs for Galactic Empire. As we further develop this interface more commands will be added. WHO Provides the Users Name, and Systems MBBS Registration Number. This is for Terminal Programs which may be registered to a specific User, and/or System. DATA QAZWSX SCAN Provides a comma separated data format scan for the current ship. This is useful for terminal programs that display the ship information in another (i.e. Graphical) representation. DATA QAZWSX REPORT Provides a comma separated data format of all the information on the current ship. This is useful for terminal programs that display the ship information in another format. 4.0 Options All of the configurable options are contained in the MBMGEMSG.MSG file and can be modified using the Galacticomm Configuration option on the BBS menu. The options are preset to optimal values. You need not adjust any to begin using the game. You may, however, wish to modify some of these options to challenge your players more, or provide a more interesting game. Please note that some of the options are included to give you maximum configurability but modification is not recommended. These are indicated with a CAUTION note following the option description. Listed below are some of the more important options that you may wish to change. For a complete list of options please refer to the Configuration Options selection on the MajorBBS menu. 4.1 Security Options Option: REGNO Description: Registration Number Value: 00000000 Type: String Range: 8 Characters This is the Registration Number specific to your MBBS system. This number will be sent to you upon receipt of your registration document. Galactic Empire will function fine for a limited period without this number. After the trial period your system will continue to function properly, although GE will be temporarily suspended. When you place the valid number in this field the game will continue where it left off. Option: PLAYKEY Description: Key required to play GE Value: NORMAL Type: S Range: 15 This option defines the KEY the player must have to play GE. Refer to your MajorBBS Users Guide for a detailed explanation on Locks & Keys. Option: SYSKEY Description: Key required for sysop powers Value: SYSOP Type: S Range: 15 This defines the key required to use the special sysop commands. You can set this to something other than SYSOP and then assign that key to specific GAMEOP's or players as needed. 4.2 Configuration Options Option: MAXPLRS Description: The maximum players in the game at once Value: 30 Type: Numeric Range: 1 to 256 You can limit the number of players who can simultaneously play the game. You may wish to set this value in order to keep your systems performance within an acceptable response. The more players in the game the more CPU resources the game consumes. Option: TRANSOPT Description: Allow goods transfers to planets not owned? Value: NO Type: Boolean Range: YES/NO This option controls if a player is allowed to transfer goods to a planet which they do not own. If YES a player can transfer goods to another players planets. This could give players with multiple USERID's an unfair advantage as they could transfer goods from multiple accounts to a single account giving that account an initial boost in the game. Note: If you only permit paying accounts to play the game this is of less concern. Option: SYSCMDS Description: Allow sysop commands? Value: YES Type: Boolean Range: YES/NO This option enables the special SYSOP commands. These commands are documented in the SYSOP.DOC file included on the release diskette. Caution: This option WILL give an unfair advantage to players who use it. It is strongly recommended that it remain set to NO during normal operation or the SYSONLY option be set to YES. Option: SYSONLY Description: Allow sysop only to use sysop commands? Value: YES Type: Boolean Range: YES/NO If sysop commands are enabled are they restricted to players with SYSOP class only. Caution: It is strongly recommended that this option remain set to YES. Option: PLANTOCK Description: How long to take to update all planets (seconds)? Value: 21600 Type: Numeric Range: 1 to 32767 This option controls the Dynamic Planet Update Feature. The system will monitor how long it takes to process through all the planets in the galaxy and dynamically adjust the update frequency to keep the total cycle time as close to the time below as it can. Caution: Setting this value too small will cause the system to consume more CPU time than may be available. It is recommended that this value be set to 6 hours (21600 seconds) which will cause four updates a day. After you have run a campaign you can reduce the value if CPU performance remained acceptable throughout the campaign. Option: PLODDS Description: Frequency factor for planets Value: 8 Type: Numeric Range: 1 to 20 This value controls the odds of a sector having planets. The lower the number the more likely a sector will have planets. Option: WORMODDS Description: Frequency factor for wormholes Value: 20 Type: Numeric Range: 1 to 100 This value controls the odds of a sector having a wormhole. The lower the number the more likely a sector will have a wormhole Option: NUMSHIPS Description: The number of additional ships (robots) in game? Value: 20 Type: Numeric Range: 0 to 256 Depending upon your CPU's performance you can have up to 256 additional Robotic Ships (Automatons) in the game. The system will randomly generate ships to give your players automated combatants. Caution: This value can DRAMATICALLY effect CPU performance. If you are not confident about your specific system please set to a lower value at first and experiment with increased values as you evaluate your CPU's performance. Option: MAXDROID Description: Max Droid class ships in game. Value: 10 Type: Numeric Range: 1 to 500 This value limits the number of DROID class ships in the game at the same time. This insures that there are plenty of Cybertrons for players to fight. The recommended setting is half of NUMSHIPS. Option: UNIVMAX Description: The radius of the Virtual Galaxy Value: 32000 Type: Numeric Range: 10 to 32767 This value controls how far from the center (sector 0 0) the galaxy extends. The Galaxy is square and UNIVMAX sectors in each direction (N,S,E,W). NOTE: The size of the galaxy has some pretty dramatic effects on the game. You may with to try various values in each of your campaigns to determine which works best for you. CAUTION: Do not change this value without resetting all the Galactic Empire Databases as explained in Chapter 3.0. Failure to do so will result in unexpected problems. Option: MAXPLREC Description: The size of the GEPLANET.DAT in Kbytes Value: 32767 Type: Numeric Range: 0 to 32767 This value controls how large the MBMGEPLT.DAT data file will grow to. Each time a sector is "teraformed" the MBMGEPLT.DAT database grows by the following formula; space added = (number planets * 512) + 512 In order to prevent your disk from filling up you can specify the maximum size that the database will grow to in Kbytes. When the maximum is reached no more planets will be created. Note: a 32,767K database will hold 65,535 planets and sectors. That should keep most players busy for awhile. 4.3 Configuration Tables The following options concern two key tables that are provided to give you maximum flexibility over your systems "look and Feel". 4.3.1 Sector 0 0 Planet Table This table configures the number of planets and the planet details for the neutral zone (sector 0 0). Some SYSOPS expressed an interest in being able to make this sector look like the SOL System (our Solar System). You can modify the following table and add additional planets as required. The only constraint is that the game requires a Trading Planet, and a Population Planet. You can designate any planet you like to be each, but MUST have one and only one of each. Additionally, you can "give" the planet to a specific USERID, such as SYSOP. To do this change the owner option for the planet. This has the effect of allowing the owner to administer the planet as they would any other planet they own. The table is organized into sets of the following options. Each set is numbered as S00Pnxxx where Pn is the table entry, and xxx is the specific option. If you elect to add additional planets to the table, simply copy the entire set (S00P1NM to S00P1RES) after the last option in the third table entry (S00P3RES). Change the P1 to P4 (or P5, P6, etc.) in the newly copied entries, and update the S00PLNUM option to reflect the new number of planets. Option: S00PLNUM Description: Number of Planets in Sector 0 0 Value: 3 Type: Numeric Range: 3 to 9 This option specifies the number of planets in the neutral zone (sector 0 0). Note: You need not change this unless you want more than 3 planets in the Neutral Zone. Option: S00P1NM Description: Zygor Value: Type: String Range: 19 Characters This is the name of planet # 1 in the Neutral Zone. Option: S00P1OWN Description: Owner of Planet #1 Value: "*EMPIRE*" Type: String Range: 30 Characters This field specifies the Owner of this planet. If desired you can specify a specific USERID and that user will be able to administer this planet. Option: S00P1TYP Description: Planet Type Value: 1 Type: Numeric Range: 0 to 2 Type of planet indicator. One planet in Sector 0 0 -MUST- be each of the following types; 0 = Nothing Special 1 = Base trading planet (Zygor) 2 = Population Planet (Tahanian Station) Option: S00P1X Description: X Coordinate of Planet Value: 5000 Type: Numeric Range: 100 to 9900 This value specifies the X coordinate of this planet. Option: S00P1Y Description: Y Coordinate of Planet Value: 5000 Type: Numeric Range: 100 to 9900 This value specifies the Y coordinate of this planet. Option: S00P1ENV Description: Environment for planet Value: 3 Type: Numeric Range: 0 to 3 This value specifies the Environment for this Planet. 0 = Poor 1 = Marginal 2 = Good 3 = Very Good Option: S00P1RES Description: Resources for planet Value: 3 Type: Numeric Range: 0 to 3 This value specifies the Resources for this Planet. 0 = Poor 1 = Marginal 2 = Good 3 = Very Good 4.3.2 Ship Class Description Table The message file MBMGESHP.MSG controls the ships available in the game. You can modify the names, performance, weapons, and cargo weight. You can also add additional ships to the table. When adding additional ships simply use one of the unused entries between 1 and 41 in the table. Note: The rules concerning the addition of ships must be followed carefully. Add USER ships before the CYBORG ships. Add DROID ships after the CYBORG ships. Add any special sysop ships after the DROID ships. Set the NUMSHIPS option in the MBMGEMSG.MSG file to the sum of all the active SnnMAKE options in the MBMGESHP.MSG file. If you have changed the Cyborgs or Droids mid-game, use the SYS KILL @ option after the board is loaded to kill existing Cybs and cause them to "re-generate" according to your new rules. There are blank entries in the .MSG file already for your use. Please use these and do not add any additional items as this WILL cause program failures. The Following options are repeated for each of the 12 classes of ships. The first 8 classes are user ships, the next 2 are Cybertron ships, and the final 3 are droid ships. Caution: You are free to adjust the values of these parameters, however, removing or adding parameters may cause unexpected problems. Option: S01TYPE Description: Type of Ship? Value: USER Type: Enumerated Range: USER CYBORG DROID This option specifies the TYPE of ship. USER = A ship a user can purchase and fly. CYBORG = A Cybertron ship controlled by the automated battle logic in the game. DROID = A non-combatant ship (sometimes) controlled by much simpler navigation logic. Option: S01NAME Description: Ship Class-01 Name Value: Interceptor Type: String Range: 30 Characters This option is the Class Name of class 01 ships. Option: S01SHLD Description: Maximum Shield Type Value: 2 Type: Numeric Range: 1 to 5 This option specifies the MAXIMUM shield type for this class of ship. Option: S01PHSR Description: Maximum Phaser Type Value: 2 Type: Numeric Range: 1 to 4 This option specifies the MAXIMUM Phaser type for this class of ship. Option: S01TORP Description: Has Torpedo Capability? Value: YES Type: Boolean Range: YES/NO This option specifies if this ship class has torpedo capability. Option: S01MISL Description: Has Missile Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has missile capability. Option: S01DECY Description: Has decoy capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has the ability to launch decoys. Option: S01JAMMR Description: Has Jammer Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has the ability to launch jammers. Option: S01ZIPPR Description: Has Zipper Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has the ability to launch Zippers. Option: S01MINE Description: Has Mine Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has the ability to launch mines. Option: S01ATTK Description: Has Attack Planet Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has planetary attack capability. Option: S01CLOK Description: Has Cloaking Capability? Value: NO Type: Boolean Range: YES/NO This option specifies if this ship class has cloaking capability. Option: S01ACCL Description: Acceleration Rate Value: 1000 Type: Numeric Range: 20 to 20000 This option controls the acceleration rate for this class of ship. Option: S01WARP Description: Maximum Warp Value: 4 Type: Numeric Range: 1 to 100 This option specifies the maximum warp for this class of ship. Option: S01TONS Description: Maximum Tonnage (in 100's) Value: 5 Type: Numeric Range: 1 to 5000 This option specifies the maximum weight in tons for this class of ship. Option: S01PRIC Description: Price for each ship (in 1000's) Value: 60 Type: Numeric Range: 1 to 32000 This option specifies the price for each ship in this class. Option: S01PNTS Description: Points awarded for kill Value: 10 Type: Numeric Range: 1 to 1000 This option specifies the points awarded to another player for killing this class of ship. Option: S01SRNG Description: Scan Range (in 1000's) Value: 25 Type: Numeric Range: 1 32767 This option specifies the maximum range in thousands for the range scanners in this class of ship. Option: S01CATK Description: Cyb's can attack this class ship? Value: NO Type: Boolean Range: YES/NO This option determines if this class of ship is "attackable" by cybertrons. If NO then Cyb's will only attack it if provoked. If YES then they will attack on sight. Option: S01NATK Description: Number of Cyb's to attack this class? Value: NO Type: Numeric Range: 0 to 255 This option determines the number of Cybs that will come after this class of ship at the same time. Set to 0 to have Cyb's leave it alone. Set to higher numbers to have this class massed by Cybertrons. 5.0 Documentation Included with the files on your release diskette is the file MBMGEMP.DOC. This is a complete users guide to Galactic Empire specifically written for your users. Upon installation the MajorBBS will attach this document to the NEWUSER.DOC file automatically. You may wish to make this document available for download in your Library also. 6.0 Support In order to receive update notification and on-line support for this product you MUST send in the attached Software Registration Document. Please complete and mail within 10 days of purchase. NOTICE: With your registration you will be given access to a special Forum on NETWORX and permitted to download any enhancements to release 3.2 for a period of one year from purchase. Future releases will also be available at reduced prices to registered customers. For Technical Support dial our on-line system; NETWORX (813) 541-5876 2400 to 9600 Baud Supported Our mailing address is; M.B. Murdock & Associates P.O. Box 2194 Pinellas Park, Fl. 34665-2194 (813) 545-8050 =================================================================== Galactic Empire Software Registration Document Name_________________________________________________ Company______________________________________________ Address______________________________________________ Phone No.____________________________________________ BBS Name_____________________________________________ BBS Phone No.________________________________________ No. Ports____________________________________________ MBBS Reg. No.________________________________________ Place of Purchase____________________________________ Comments_____________________________________________ _____________________________________________________ _____________________________________________________ Mail to: M.B. Murdock & Associates P.O. Box 2194 Pinellas Park, Fl. 34665-2194 ===================================================================