`Duke It Out In D.C.' developed by Sunstorm Interactive Inc. (1997) ----------------------------------------------------------------------------- Thank you very much for purchasing `Duke It Out In D.C.' for Duke Nukem 3D. This help file will aid you through the installation process of the `Duke It Out In D.C.' add-on pack and the GAMER (Game Add-on Manager) program. GAMER was written specifically to install add-on packs (.SSI files) developed by Sunstorm Interactive for many current games on the market. The `Duke It Out In D.C.' add-on pack will replace Episode 3 in Duke Nukem 3D. Quick note: We have included a new ending animation which will play when you complete the entire `Duke It Out In D.C.' episode. When this new animation starts, don't press any keys or you will skip right past the exciting conclusion! ----------------------------------------------------------------------------- Installing `Duke It Out In D.C.' ----------------------------------------------------------------------------- Please note that the `Duke It Out In D.C.' add-on is only tested and designed for Duke 3D version 1.3d, 1.4 and 1.5. Any other updates made to Duke after the release of this are not tested or supported for this add-on. To run the install program, make sure the `Duke It Out In D.C.' CD is in your CDROM drive and type #:\INSTALL. Replace # with whatever the letter of your CDROM drive is. The install program will begin with a title screen explaining a little information about this product. Press after reading this and the program will then begin collecting information needed to install the add-on pack. One thing to remember, you can hit at anytime during the installation process and exit without any changes being made to your computer. The only time this is not true, is when the files are actually being copied over and the GAMER software is being setup. Another thing to remember, you can install GAMER on one drive, say the E: drive... and still have Duke Nukem 3D on a different drive, say the C: drive. This is, assuming both of those drive letters are valid. The first step is to either locate the GAMER software, or create a new location for it. GAMER is designed to work with any add-on pack developed by Sunstorm Interactive for any game. Thus, it is best to keep it in a directory by itself, rather than with Duke Nukem 3D. The suggested directory location is C:\GAMER or C:\GAMES\GAMER The installer will attempt to detect the GAMER software automatically. If it is unable to locate it, then you will be prompted to type in a directory where the GAMER software is located or you would like to install it into. Type in the appropriate directory (including the DRIVE letter) and press . If the directory is acceptable, then a window will appear stating that everything is valid, and if you wish to accept the directory. Select yes to move on in the installation process or no to enter a new directory. The installer will attempt to locate a copy of Duke Nukem 3D. If it does, a window will appear asking if you wish to accept this. If this is the copy/version of Duke you play then select yes. If you select no, or the installer cannot find a copy of Duke a window will appear asking you to type the path where Duke Nukem 3D is located on your hard drive. Duke Nukem 3D MUST be installed, otherwise the install program will not accept a directory and the GAMER software will not be installed. This is to prevent future problems that could be caused by Duke not being installed. Note: If you have more than one version of Duke installed, and it detects a different version than you want to install the add-on for, then simply enter the correct directory for the other version. This allows you to install Duke it out in D.C. for both the regular version and the Atomic editions of Duke. You will then be told installation is about to begin. Hit to continue or to exit the install process. The new `Duke It Out In D.C.' add-on pack will then be copied over. If you already have a copy of the GAMER software on your computer, the installer will detect if it is older or newer than the one on the installation disk. If it is older, the new version will be copied over, otherwise the one on your computer will be left alone. When the files are finished copying over, the installation process is complete. Be sure to read the readme.txt that was copied into the GAMER software directory during installation. It will give detailed instructions on installing, un-installing and removing add-on packs for your games. We at Sunstorm hope you enjoy `Duke It Out In D.C.' Be sure to look for other products by us for your favorite games. ----------------------------------------------------------------------------- How to install `Duke It Out In D.C.' and GAMER if the install program fails ----------------------------------------------------------------------------- If you take this a step at a time, it is pretty long, but fairly straight forward. Please don't try to skip sections, as you might miss something that seems minor, but winds up causing things to get crazy. This assumes that you already know the basics about DOS, switching drives, making directories, copying files, etc. If a version of GAMER is already installed, skip this part and go to the next portion about "IF A VERSION OF GAMER IS ALREADY INSTALLED ON YOUR COMPUTER". *************************************************************** IF A VERSION OF GAMER IS *NOT* INSTALLED ON YOUR COMPUTER YET *************************************************************** 1) At the DOS prompt, or in Windows DOS box, go to the drive you wish to install the GAMER software and `Duke It Out In D.C.'. This is usually the same drive as where Duke Nukem 3D and your other games are installed. 2) Make a new directory to put the GAMER software into. Preferably #:\GAMER or #:\GAMES\GAMER where # is the letter of the drive to install to. 3) Go to the `Duke It Out In D.C.' CD, and change directories into the DUKEDC directory. You should see five files: DUKEDC13.SSI DUKEDCPP.SSI GAMER.EXE README.TXT GAMER.INI 4) Copy GAMER.EXE, README.TXT, and GAMER.INI files into the new directory you made on your hard drive, and then go to your hard drive and the directory that you just copied those files into. 5) Using DOS Edit, (type EDIT GAMER.INI at the DOS prompt), you will make changes to the GAMER.INI file that will allow it to have access to Duke 3D. When you open up the GAMER.INI file in Edit, you will see this: A whole bunch of lines starting with //. Look for the line that looks like: // End of text header The section you will need to work with follows that line, and looks like this: 1.0 1 DUKE NUKEM 3D DUKE3D NONE Leave the first and second lines alone. Line one is the version of GAMER, and line two tells GAMER how many games you have add-ons installed for. On the third line, change the to 1.3D if your Duke Nukem 3D is version 1.3D (the original before the Plutonium Pack was created) or ATOMIC if you have the Plutonium Pack/Atomic edition of Duke (versions 1.4 and 1.5). Be sure you type exactly 1.3D or ATOMIC... in all caps. Example: Change DUKE NUKEM 3D to DUKE NUKEM 3D ATOMIC On the 4th line, change the to 1.3D for Duke version 1.3D, or PP if you have the Plutonium Pack. Example: Change DUKE3D to DUKE3DPP Leave the 5th line alone... this denotes what add-on is currently installed for that game. On the 6th line, change to the directory path where you have Duke Nukem 3D installed. Be sure to put the drive letter, and a final \ when typing the directory. Example: C:\GAMES\DUKE3D\ Although it doesn't _have_ to be in all caps, it is advisable. 6) Save GAMER.INI and exit DOS Edit. 7) Now, you need to make a new directory to put your new Duke Nukem 3D add-on packs into. If you have version 1.3D of Duke, then make a directory named DUKE3D13. If you have Atomic Edition/Plutonium Pack (version 1.4 or 1.5) then make a directory named DUKE3DPP. Please note, these should be subdirectories of your GAMER directory. So, the structure of the directory would be, for example, something similar to: C:\GAMER\DUKE3DPP or C:\GAMER\DUKE3D13 8) Move on to the section titled "INSTALLING `Duke It Out In D.C.' FOR GAMER". ************************************************************* IF A VERSION OF GAMER IS ALREADY INSTALLED ON YOUR COMPUTER ************************************************************* 1) Go into your GAMER directory, and open up the GAMER.INI file in DOS Edit (type EDIT GAMER.INI at the DOS prompt). Now, look for some text similar to this: DUKE NUKEM 3D DUKE3D NONE If it doesn't exist, then you will need to make modifications. If it does exist, then there is nothing you will need to change. Skip these next few steps and move on to the section titled "INSTALLING `Duke It Out In D.C.' FOR GAMER". 2) On the second line, you should see a number. Just add one to this number, and change it. Example: Change 4 to 5 3) Now, you need to insert this text on the line after the one you just modified. DUKE NUKEM 3D DUKE3D NONE On the first line, change the to 1.3D if your Duke Nukem 3D is version 1.3D (the original before the Plutonium Pack was created) or ATOMIC if you have the Plutonium Pack/Atomic edition of Duke (versions 1.4 and 1.5). Be sure you type exactly 1.3D or ATOMIC... in all caps. Example: Change DUKE NUKEM 3D to DUKE NUKEM 3D ATOMIC On the second line, change the to 13 for Duke version 1.3D, or PP if you have the Plutonium Pack. Example: Change DUKE3D to DUKE3DPP Leave the 3rd line alone... this denotes what add-on is currently installed for that game. On the 4th line, change to the directory path where you have Duke Nukem 3D installed. Be sure to put the drive letter, and a final \ when typing the directory. Example: C:\GAMES\DUKE3D\ Although it doesn't _have_ to be in all caps, it is advisable. Now, you should have something that looks similar to this in the file: 1.0 2 DUKE NUKEM 3D ATOMIC DUKE3DPP NONE C:\GAMES\DUKE3D If not, please go back and double check that you did every step as instructed. Since this is version 1.0 of the GAMER software, you don't need to worry about updating that. Aren't you lucky! ;^) 4) Save the GAMER.INI file, and exit DOS Edit. 5) Now, you need to make a new directory to put your new Duke Nukem 3D add-on packs into. If you have version 1.3D of Duke, then make a directory named DUKE3D13. If you have Atomic Edition/Plutonium Pack (version 1.4 or 1.5) then make a directory named DUKE3DPP. Please note, these should be subdirectories of your GAMER directory. So, the structure of the directory would be, for example, something similar to: C:\GAMER\DUKE3DPP or C:\GAMER\DUKE3D13 6) Move on to the section titled "INSTALLING `Duke It Out In D.C.' FOR GAMER". ******************************************** INSTALLING `Duke It Out In D.C.' FOR GAMER ******************************************** 1) This assumes that you have already installed the GAMER software, and that that portion of the installation is correct. Now, go into the `Duke It Out In D.C.' CD, and into the DUKEDC directory. You should see two .SSI files named: DUKEDC13.SSI and DUKEDCPP.SSI If you have Duke Nukem 3D version 1.3D, then the file you will work with is DUKEDC13.SSi. If you have Duke Nukem 3D Atomic edition (1.4,1.5) then you will be working with DUKEDCPP.SSI. Please remember that, as I will only refer to them as "your SSI file". 2) Now, this part is _really_ easy. Simply copy your SSI file into the directory where your Duke Nukem 3D SSI files are stored for GAMER to access. So, say your GAMER software is located in C:\GAMER, then you would copy your SSI file into: C:\GAMER\DUKE3D13 if you have Duke Nukem 3D version 1.3d or C:\GAMER\DUKE3DPP if you have the Atomic Edition/Plutonium Pack (1.4 and 1.5) 3) GAMER will automatically detect the new add-on and display it in the activation menu screen. Well... that's it! Now this is a perfect example of why we write programs to install things for us. ;^) ----------------------------------------------------------------------------- Problems, fixes, workarounds ----------------------------------------------------------------------------- If you experience any problems installing `Duke It Out In D.C.', read below for possible solutions and workarounds. -Q I can't get the installer to recognize my Duke Nukem 3D directory! What do I do now? -A First, make sure that Duke Nukem 3D is currently INSTALLED on your computer. Secondly, the installer looks for a .CFG file to verify the existence of Duke on your computer, and to detect which version of Duke you have. Since you cannot run Duke without a .CFG file, the installer assumes you will have one. -Q I can't get the installer to recognize my GAMER directory! What do I do? -A The installer looks for a file name GAMER.INI to verify the existence of the GAMER software. You can't run the GAMER software without it, so just make sure it is in the directory when installing. If you still cannot get it to work, you will most likely need to install it in a new place. -Q I keep trying to make a directory to install the GAMER software into, but the installer won't accept it. Why? -or- I can't type enough characters for the directory I want to install the GAMER software into. How do I fix this? -A First of all, the maximum number of characters the installer allows you to type is 60. The Duke Nukem 3D installer did this, as do many other installers. If you really need more characters, then read the section below on manually installing the GAMER Software. Secondly, the installer only allows you to create one new subdirectory from the one you are installing. So, in other words... if you have a directory called C:\GAMES This is an example of a valid directory to install to: C:\GAMES\GAMER This is an example of an invalid directory to install to: C:\GAMES\ADDONS\GAMER Unless of course, you already have a directory called ADDONS as a subdirectory of GAMES. -Q I've done all this stuff, and I still can't get the dang thing to install correctly. Can I manually install the add-on? -A Yes, you can manually install it, but will take a little bit of work on your part. Please read the section above about installing should the install program fail. Should you continue to experience problems, feel free to contact us and we will attempt to help you out. Read below to find out how to get support. ----------------------------------------------------------------------------- How to get technical support for `Duke It Out In D.C.' ----------------------------------------------------------------------------- For technical support on `Duke It Out In D.C.', please contact: WizardWorks Technical Support 2300 Berkshire Lane North Plymouth, MN 55441 (612) 559-5301 9am - 5pm Monday-Friday E-mail support@wizworks.com http://www.wizworks.com Apogee/3D Realms does not provide support for this product. ----------------------------------------------------------------------------- Credits ----------------------------------------------------------------------------- `Duke It Out In D.C.' was developed by Sunstorm Interactive. Watch for more great add-ons from Sunstorm for cutting edge 3D games. Stop by our website at www.888sunstorm.com to get the latest updates! The GAMER add-on management program, and all documentation was developed by Charlie Wiederhold. Some artwork in `Duke It Out In D.C.' was created by 3DI Software Inc. Stop by and see them at www.3di-soft.com Duke Nukem is a trademark of 3D Realms Entertainment. All rights reserved.