    `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 <ENTER> 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 <ESC> 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
<ENTER>. 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 <ENTER> to continue
or <ESC> 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.01
1
DUKE NUKEM 3D <version>
DUKE3D<version>
NONE
<duke directory>

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 <version> 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 <version> to DUKE NUKEM 3D ATOMIC

On the 4th line, change the <version> to 1.3D for Duke version 1.3D, or PP
if you have the Plutonium Pack.

Example: Change DUKE3D<version> to DUKE3DPP

Leave the 5th line alone... this denotes what add-on is currently installed
for that game.

On the 6th line, change <duke directory> 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 <version>
DUKE3D<version>
NONE
<duke directory>

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 <version>
DUKE3D<version>
NONE
<duke directory>

On the first line, change the <version> 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 <version> to DUKE NUKEM 3D ATOMIC

On the second line, change the <version> to 13 for Duke version 1.3D, or PP
if you have the Plutonium Pack.

Example: Change DUKE3D<version> to DUKE3DPP

Leave the 3rd line alone... this denotes what add-on is currently installed
for that game.

On the 4th line, change <duke directory> 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.

Take a note to the version of GAMER you have (second line will say 1.0
or 1.01). If you have 1.01 there, then there is nothing to change. If it says
1.0, then you need to change it to 1.01.

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) Go onto you 'Duke It Out In D.C.' CD and change into the DUKEDC directory.
In there, you should see a file called GAMER.EXE. Simply copy that into the
directory you made for GAMER on your hard drive.

Example: COPY GAMER.EXE C:\GAMER

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 http://www.sunstorm.net 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.
