Difference between revisions of "The Official Add-on Installation Guide"

From EDukeWiki
Jump to navigation Jump to search
(Duke!ZONE)
 
(5 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
==Add-on Guides==
 
==Add-on Guides==
  
===Duke It Out In D.C.===
+
===Duke it out in D.C.===
 
<font size="1">a.k.a. Duke D.C., DukeDC, D.C., DC, DDC</font>
 
<font size="1">a.k.a. Duke D.C., DukeDC, D.C., DC, DDC</font>
  
#Insert your Duke It Out In D.C. CD, Kill-a-Ton Collection Disc 3, or Duke: The Apocalypse 2 CD into your CD-ROM drive. Optionally, you can copy '''DUKEDC.GRP (aka DC.GRP)''' to your EDuke32 directory if you already have it, or '''DUKEDCPP.SSI''' and '''DUKEDC13.SSI''' from the CD if you don't. Do '''not''' run the installer included on the disc.
+
#[[Installation and configuration|Install the base game.]]
#Alternatively, download the [http://hendricks266.duke4.net/stuff/dukedc_demo.7z Duke It Out In D.C. demo].
+
#The next step is to provide EDuke32 with the add-on data.
#Download the [http://hendricks266.duke4.net/files/dukedc_script.7z Duke D.C. Installer & Launcher].
+
#*If you bought the game from [http://store.steampowered.com/app/225140/ Steam (as ''Duke Nukem 3D: Megaton Edition'')], copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
#Extract it to your EDuke32 directory or a subdirectory thereof using [http://www.7-zip.org 7-Zip].
+
#*Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
#Run '''DukeDC.bat''' to install the expansion.
+
#**''Duke Nukem 3D: Megaton Edition'' on Steam: ''<path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\dc\'''dukedc.grp'''''.
#'''DukeDC.bat''' will also launch the expansion. It is compatible with the [http://hrp.duke4.net/ Duke It Out In D.C. HRP], compiled by NightFright.
+
#**''Duke it out in D.C.'' CD-ROM: ''<CD root>\DUKEDC\'''DUKEDCPP.SSI'''''
#If you want to use the DCHRP's Subversion (SVN) repository, read [[How to Download Add-on HRP SVNs|the add-on HRP SVN tutorial]].
+
#**''Kill-a-Ton Collection'' CD-ROM #3: ''<CD root>\DUKEDC\DUKEDC\'''DUKEDCPP.SSI'''''
#Periodically, use the SVN software's update function to ensure you have the most recent changes and updates applied to your copy of the data.
+
#**''Duke: The Apocalypse 2'' CD-ROM: ''<CD root>\DUKEDC\'''DUKEDCPP.SSI''''' (TODO: confirm this)
 +
#**If you have not purchased the add-on, the [http://hendricks266.duke4.net/stuff/dukedc_demo.7z one-level demo] is also supported.
  
  
Line 25: Line 26:
 
<font size="1">a.k.a. Duke Vacation: Life's a Beach, Duke Caribbean Vacation, LAB, DCLAB</font>
 
<font size="1">a.k.a. Duke Vacation: Life's a Beach, Duke Caribbean Vacation, LAB, DCLAB</font>
  
#Insert your Duke Caribbean: Life's A Beach into your CD-ROM drive. Optionally, you can copy '''VACATION.GRP/VACATION.PRG''' to your EDuke32 directory if you already have it, or '''VACA15.SSI''', '''VACAPP.SSI''', and '''VACA13.SSI''' from the CD if you don't. Do '''not''' run the installer included on the disc.
+
#[[Installation and configuration|Install the base game.]]
#Download [http://hendricks266.duke4.net/vaca_plus.php Duke Caribbean: Life's A Beach Plus] by following the instructions in [[How to Download Add-on HRP SVNs|the add-on HRP SVN tutorial]].
+
#The next step is to provide EDuke32 with the add-on data.
#Periodically, use the SVN software's update function to ensure you have the most recent changes and updates applied to your copy of the data.
+
#*If you bought the game from [http://store.steampowered.com/app/225140/ Steam (as ''Duke Nukem 3D: Megaton Edition'')], copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
#Run '''Caribbean.bat'''. The installation of the game will be handled for you, and you can run the game from the same batch file once completed.
+
#*Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
#Vaca+ will provide fixes and improvements to all aspects of the game, including fixed programming, patched errors in the classic art and maps, Roland Sound Canvas SC-55 music (just like in 1997!), and compatibility with the new Polymer renderer, as well as high-definition art and 3D models.
+
#**''Duke Nukem 3D: Megaton Edition'' on Steam: ''<path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\vacation\'''vacation.grp'''''.
 +
#**''Duke Caribbean: Life's A Beach'' CD-ROM: ''<CD root>\VACATION\'''VACA15.SSI'''''
  
  
Line 35: Line 37:
 
<font size="1">a.k.a. Nuclear Winter, NW</font>
 
<font size="1">a.k.a. Nuclear Winter, NW</font>
  
#Insert your Duke: Nuclear Winter into your CD-ROM drive and/or copy the '''NWINTER.GRP''' file to your EDuke32 directory. Do '''not''' run the installer included on the disc.
+
#[[Installation and configuration|Install the base game.]]
#Alternatively, download the [http://hendricks266.duke4.net/stuff/nw_demo.7z Duke: Nuclear Winter demo] and copy its NWINTER.GRP.
+
#The next step is to provide EDuke32 with the add-on data.
#Download [http://hendricks266.duke4.net/nw_plus.php Duke: Nuclear Winter Plus] by following the instructions in [[How to Download Add-on HRP SVNs|the add-on HRP SVN tutorial]].
+
#*If you bought the game from [http://store.steampowered.com/app/225140/ Steam (as ''Duke Nukem 3D: Megaton Edition'')], copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
#Periodically, use the SVN software's update function to ensure you have the most recent changes and updates applied to your copy of the data.
+
#*Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
#Run '''NWinter.bat'''. The installation of the game will be handled for you, and you can run the game from the same batch file once completed.
+
#**''Duke Nukem 3D: Megaton Edition'' on Steam: ''<path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\nw\'''nwinter.grp'''''.
#NW+ will provide fixes and improvements to all aspects of the game, including fixed programming, patched errors in the classic art and maps, Roland Sound Canvas SC-55 music (just like in 1997!), and compatibility with the new Polymer renderer, as well as high-definition art and 3D models.
+
#**''Duke: Nuclear Winter'' CD-ROM: ''<CD root>\GAMEDATA\'''NWINTER.GRP'''''
 +
#**If you have not purchased the add-on, the [http://hendricks266.duke4.net/stuff/nw_demo.7z one-level demo] is also supported.
  
  
Line 47: Line 50:
 
#Insert your Duke!ZONE CD or Duke: The Apocalypse 2 CD into your CD-ROM drive.
 
#Insert your Duke!ZONE CD or Duke: The Apocalypse 2 CD into your CD-ROM drive.
 
#Try using Skulldog's [http://forums.duke4.net/topic/3909-duke-nukem-3d-dosbox-launcher-frontend/ Duke Nukem 3D Dosbox Launcher - Frontend].
 
#Try using Skulldog's [http://forums.duke4.net/topic/3909-duke-nukem-3d-dosbox-launcher-frontend/ Duke Nukem 3D Dosbox Launcher - Frontend].
 +
  
 
===Duke!ZONE 2===
 
===Duke!ZONE 2===
Line 52: Line 56:
 
#Insert your Duke!ZONE 2 CD, Kill-a-Ton Collection Disc 3, or Duke: The Apocalypse CD into your CD-ROM drive.
 
#Insert your Duke!ZONE 2 CD, Kill-a-Ton Collection Disc 3, or Duke: The Apocalypse CD into your CD-ROM drive.
 
#Copy '''DUKE!ZON.GRP''' from the "'''DZ2'''" directory for v1.3D or "'''DZ2PP'''" for v1.4/v1.5 to your EDuke32 directory.
 
#Copy '''DUKE!ZON.GRP''' from the "'''DZ2'''" directory for v1.3D or "'''DZ2PP'''" for v1.4/v1.5 to your EDuke32 directory.
#Alternatively, download the [http://hendricks266.duke4.net/stuff/d!z2_demo.7z Duke!ZONE 2 demo].
+
#*Alternatively, download the [http://hendricks266.duke4.net/stuff/d!z2_demo.7z Duke!ZONE 2 demo].
 
#Download [http://hendricks266.duke4.net/stuff/duke_zone2_cons.zip the fixed CON files].
 
#Download [http://hendricks266.duke4.net/stuff/duke_zone2_cons.zip the fixed CON files].
 
#Extract them to a subdirectory of your EDuke32 directory.
 
#Extract them to a subdirectory of your EDuke32 directory.
Line 64: Line 68:
 
#In DKXTRM/PACK14, rename '''DKEXGAME.CON''' to '''GAME.CON''', '''DKEXDEFS.CON''' to '''DN3DDEFS.CON''', and '''DKEXUSER.CON''' to '''DN3DUSER.CON'''.
 
#In DKXTRM/PACK14, rename '''DKEXGAME.CON''' to '''GAME.CON''', '''DKEXDEFS.CON''' to '''DN3DDEFS.CON''', and '''DKEXUSER.CON''' to '''DN3DUSER.CON'''.
 
#Run EDuke32 with these command line parameters: "-jDKXTRM\PACK14 -jDKXTRM\SPMAPS -jDKXTRM\DMMAPS".
 
#Run EDuke32 with these command line parameters: "-jDKXTRM\PACK14 -jDKXTRM\SPMAPS -jDKXTRM\DMMAPS".
#''For the time being, the other content from this expansion is not covered in this tutorial.''
+
#''For the time being, the other content from this expansion is not covered in this tutorial.'' Try using Skulldog's [http://forums.duke4.net/topic/3909-duke-nukem-3d-dosbox-launcher-frontend/ Duke Nukem 3D Dosbox Launcher - Frontend].
 
#If you desire, you can download [http://hendricks266.duke4.net/stuff/duke_xtreme_cons.zip some CON files that have the maps grouped into episodes] until a better solution is created.
 
#If you desire, you can download [http://hendricks266.duke4.net/stuff/duke_xtreme_cons.zip some CON files that have the maps grouped into episodes] until a better solution is created.
  
Line 79: Line 83:
  
 
Ask any questions in the [http://forums.duke4.net/topic/2231-the-official-add-on-installation-guide/ The Official Add-on Installation Guide Duke4.net forum thread].
 
Ask any questions in the [http://forums.duke4.net/topic/2231-the-official-add-on-installation-guide/ The Official Add-on Installation Guide Duke4.net forum thread].
 
===Batch Script Errors===
 
 
Please see the [[Working with the Windows Command Prompt]] page if you have trouble performing the following actions.
 
 
If you encounter an error in the batch files provided, copy and paste the output into a post at the [http://forums.duke4.net/topic/2231-the-official-add-on-installation-guide/ forum thread] inside <code>[codebox][/codebox]</code> tags. If available, run the bat file with the '''_Debug''' suffix, such as '''DukeDC_Debug.bat''', '''Carib_Debug.bat''', and '''NW_Debug.bat'''.
 
 
If the window closes before you can copy the output, open a command prompt window at the folder and type the name of the batch file in question. Again, use the '''_Debug''' script if applicable. This hopefully should allow you to see what error you are experiencing. If not, make a post with a verbal description of what's happening and what you do see.
 
  
 
[[Category:EDuke32 end-user documentation]]
 
[[Category:EDuke32 end-user documentation]]

Latest revision as of 15:59, 25 March 2015

This guide is intended to help users install the officially released add-ons to Duke Nukem 3D. Unlike other mods, they are unique in the facts that they were officially endorsed by 3D Realms (making them canon) and they were (and are) for sale.

Disclaimer: This guide assumes you have legally acquired a legitimate copy (or demo) of the add-on you wish to install, from eBay, etc.

Do not ask where you can acquire these add-ons illegally.

Before proceeding, ensure you have downloaded the latest EDuke32 and installed Duke Nukem 3D by copying the DUKE3D.GRP and DUKE.RTS files to your EDuke32 directory.

Add-on Guides

Duke it out in D.C.

a.k.a. Duke D.C., DukeDC, D.C., DC, DDC

  1. Install the base game.
  2. The next step is to provide EDuke32 with the add-on data.
    • If you bought the game from Steam (as Duke Nukem 3D: Megaton Edition), copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
    • Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
      • Duke Nukem 3D: Megaton Edition on Steam: <path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\dc\dukedc.grp.
      • Duke it out in D.C. CD-ROM: <CD root>\DUKEDC\DUKEDCPP.SSI
      • Kill-a-Ton Collection CD-ROM #3: <CD root>\DUKEDC\DUKEDC\DUKEDCPP.SSI
      • Duke: The Apocalypse 2 CD-ROM: <CD root>\DUKEDC\DUKEDCPP.SSI (TODO: confirm this)
      • If you have not purchased the add-on, the one-level demo is also supported.


Duke Caribbean: Life's A Beach

a.k.a. Duke Vacation: Life's a Beach, Duke Caribbean Vacation, LAB, DCLAB

  1. Install the base game.
  2. The next step is to provide EDuke32 with the add-on data.
    • If you bought the game from Steam (as Duke Nukem 3D: Megaton Edition), copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
    • Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
      • Duke Nukem 3D: Megaton Edition on Steam: <path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\vacation\vacation.grp.
      • Duke Caribbean: Life's A Beach CD-ROM: <CD root>\VACATION\VACA15.SSI


Duke: Nuclear Winter

a.k.a. Nuclear Winter, NW

  1. Install the base game.
  2. The next step is to provide EDuke32 with the add-on data.
    • If you bought the game from Steam (as Duke Nukem 3D: Megaton Edition), copying the data yourself is not required. EDuke32 will use the Windows registry to automatically identify your installation and add the required data to its search path.
    • Otherwise, copy one of the following files to your EDuke32 folder. (On Windows, GRP files may be labeled "Microsoft Program Group".)
      • Duke Nukem 3D: Megaton Edition on Steam: <path to Steam Library>\SteamApps\common\Duke Nukem 3D\gameroot\addons\nw\nwinter.grp.
      • Duke: Nuclear Winter CD-ROM: <CD root>\GAMEDATA\NWINTER.GRP
      • If you have not purchased the add-on, the one-level demo is also supported.


Duke!ZONE

  1. Insert your Duke!ZONE CD or Duke: The Apocalypse 2 CD into your CD-ROM drive.
  2. Try using Skulldog's Duke Nukem 3D Dosbox Launcher - Frontend.


Duke!ZONE 2

  1. Insert your Duke!ZONE 2 CD, Kill-a-Ton Collection Disc 3, or Duke: The Apocalypse CD into your CD-ROM drive.
  2. Copy DUKE!ZON.GRP from the "DZ2" directory for v1.3D or "DZ2PP" for v1.4/v1.5 to your EDuke32 directory.
  3. Download the fixed CON files.
  4. Extract them to a subdirectory of your EDuke32 directory.
  5. Run EDuke32 with these command line parameters: "-j<dir> -g DUKE!ZON.GRP". (replace <dir> with the subdirectory from the previous step)


Duke Xtreme

  1. Insert your Duke Xtreme CD, Kill-a-Ton Collection Disc 3, or Duke: The Apocalypse CD into your CD-ROM drive.
  2. Copy the DKXTRM directory from the CD to your EDuke32 directory.
  3. In DKXTRM/PACK14, rename DKEXGAME.CON to GAME.CON, DKEXDEFS.CON to DN3DDEFS.CON, and DKEXUSER.CON to DN3DUSER.CON.
  4. Run EDuke32 with these command line parameters: "-jDKXTRM\PACK14 -jDKXTRM\SPMAPS -jDKXTRM\DMMAPS".
  5. For the time being, the other content from this expansion is not covered in this tutorial. Try using Skulldog's Duke Nukem 3D Dosbox Launcher - Frontend.
  6. If you desire, you can download some CON files that have the maps grouped into episodes until a better solution is created.


Duke Assault

  1. Insert your Duke Assault CD into your CD-ROM drive.
  2. Copy the ASSAULT directory from the CD to your EDuke32 directory.
  3. Copy the two TILES0??.ART files to the ASSAULT directory.
  4. In EDuke32, select ASSAULT for your mod directory, or run EDuke32 with the command line parameters "-jASSAULT".
  5. Select your map from the user map selection.

Errors, Questions, and Feedback

Ask any questions in the The Official Add-on Installation Guide Duke4.net forum thread.