Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
systems:eduke32 [2022/10/04 00:50] – maionisystems:eduke32 [2025/06/07 15:22] (current) – [Supported games (.eduke32 file content and data files location)] brunoeduardo
Line 1: Line 1:
 +<WRAP center round todo>
 +This article needs some TLC. Read at your own risk.
 +</WRAP>
 +
 <WRAP group> <WRAP group>
 <WRAP round box twothirds column> <WRAP round box twothirds column>
Line 6: Line 10:
 ====== Eduke 32 ====== ====== Eduke 32 ======
  
-EDuke32 is a 32-bit/64-bit cross-platform port of Duke Nukem 3D aimed at both extending what can be edited in the game and providing a rich, full-featured means to explore the original episodes.+EDuke32 is a cross-platform port of Duke Nukem 3D aimed at both extending what can be edited in the game and providing a rich, full-featured means to explore the original episodes. It is widely used in the Duke Nukem modding community and has become a requirement in order to play most mods. It is also capable of playing Nam and WW2 GI.
  
-EDuke32 offers a convenient way to play Duke Nukem 3D and its expansion packs, with numerous features and enhancements not found in the base game. Widely used in the Duke Nukem modding community that it has become a requirement in order to play most mods and total conversions.  +"It’s time to kick ass and chew bubble gum... and I’m all outta gum." -- Duke Nukem from Duke Nukem 3D.
- +
-It is also capable of playing Nam and WW2 GI.  +
- +
-"It’s time to kick ass and chew bubble gum...and I’m all outta gum." Duke Nukem from Duke Nukem 3D.+
  
 This system scrapes metadata for the “ports” group(s) and loads the eduke32 set from the currently selected theme, if available. This system scrapes metadata for the “ports” group(s) and loads the eduke32 set from the currently selected theme, if available.
Line 38: Line 38:
 No Eduke32 emulator in Batocera needs a BIOS file to run.  No Eduke32 emulator in Batocera needs a BIOS file to run. 
  
-===== ROMs =====+===== Supported Command in .eduke32-file =====
  
-Place your Eduke32 ROMs in ''/userdata/roms/eduke32/''.+  * FILE (equivalent to ''-gamegrp'') 
 +  * FILE+ (equivalent to ''-g'') 
 +  * CON (equivalent to ''-x'') 
 +  * CON+ (equivalent to ''-mx'') 
 +  * DIR (equivalent to ''-j'') 
 +  * DEF (equivalent to ''-h'') 
 +  * DEF+ (equivalent to ''-mh'') 
 +  * MAP (equivalent to ''-map'')
  
-Each game needs a .eduke32 file to tell Eduke32 how to launch the game, the file need to point to the main game file and add-on file (it's case sensitive and can't have empty lines, otherwise files will not be found or game will not start, for CON files add the full path instead of the relative to the main file). +These commands are from ''configgen/utils/buildargs.py'' and may be updated in future. 
 +<code> 
 +BuildEngineArg("DIR", "-j", False),  # Adds directory to search list 
 +# The main game file to load: EDuke32 and Raze can load .grp, .zip, .ssi, .pk3, .pk4; Raze can also load .7z 
 +BuildEngineArg("FILE", "-gamegrp", True), 
 +# Add extra game file to load; this overrides files in virtual filesystem 
 +BuildEngineArg("FILE+", "-g", False), 
 +# Replace the main GAME.CON script module; surprisingly this can be a CON, DEF, or INI! 
 +BuildEngineArg("CON", "-x", True), 
 +BuildEngineArg("CON+", "-mx", False),  # Append CON after GAME.CON script module 
 +BuildEngineArg("DEF", "-h", True),  # Replace the main DEF module 
 +BuildEngineArg("DEF+", "-mh", False),  # Append DEF after main DEF module 
 +BuildEngineArg("MAP", "-map", True),  # Start specified MAP on launch 
 +</code>
  
-eg.: +===== ROMs =====
  
-/userdata/roms/eduke32/Duke it Out in D.C..eduke32 (make it easy to scrapper)+Place your Eduke32 ROMs in ''/userdata/roms/eduke32/''.
  
-/userdata/roms/eduke32/duke/DUKE3D.GRP (main game data)+Files MD5 sums: https://wiki.eduke32.com/wiki/Frequently_Asked_Questions
  
-/userdata/roms/eduke32/blood/DUKEDC.GRP (add-on data)+The following games are officially supported, and should be placed in the designated directory with their required 
 +files: 
 +  * duke:   Duke Nukem 3D (DUKE3D.GRP) 
 +  * duke:   Duke Nukem 3D: Duke It Out in D.C. (DUKEDC.GRP) 
 +  * duke:   Duke Nukem 3D: Duke Caribbean: Life's a Beach (VACATION.GRP) 
 +  * duke:   Duke Nukem 3D: Duke: Nuclear Winter (NWINTER.GRP) 
 +  * nam:    NAM (NAM.GRP, NAM.CON) 
 +  * ww2gi:  World War II GI (WW2GI.GRP) 
 +  * ww2gi:  World War II GI: Platoon Leader (PLATOONL.DAT, PLATOONL.DEF)
  
 ==== Supported games (.eduke32 file content and data files location) ==== ==== Supported games (.eduke32 file content and data files location) ====
Line 67: Line 95:
                            └── DUKE.RTS                            └── DUKE.RTS
 </code> </code>
- 
-Note: For Duke Nukem games it is possible to install High-Definition Packs and Music Packs: http://hrp.duke4.net/download.php 
-Some files have versions for Eduke32 emulator and others for Eduke32 emulator, make sure to download the correct one. 
  
 === Duke It Out in D.C. (expansion) === === Duke It Out in D.C. (expansion) ===
Line 88: Line 113:
 === Duke Caribbean: Life's a Beach (expansion) === === Duke Caribbean: Life's a Beach (expansion) ===
  
-<file - Duke It Out in D.C..eduke32>+<file - Duke Caribbean - Life's a Beach.eduke32>
 FILE  = /duke/DUKE3D.GRP FILE  = /duke/DUKE3D.GRP
 FILE+ = /duke/VACATION.GRP FILE+ = /duke/VACATION.GRP
Line 132: Line 157:
 === Duke ZONE 2 === === Duke ZONE 2 ===
  
-<file - Duke!Zone II.eduke32> (Atomic)+Atomic: 
 + 
 +<file - Duke!Zone II.eduke32>
 FILE  = /duke/DUKE!ZON.GRP FILE  = /duke/DUKE!ZON.GRP
 FILE+ = /duke/DUKEZONE2.GRPINFO FILE+ = /duke/DUKEZONE2.GRPINFO
 </file> </file>
  
-<file - Duke!Zone II.eduke32> (World Tour) +World Tour: 
 + 
 +<file - Duke!Zone II.eduke32>
 FILE  = /duke/DUKE!ZON.GRP FILE  = /duke/DUKE!ZON.GRP
 FILE+ = /duke/DUKEZONE2_WT.GRPINFO FILE+ = /duke/DUKEZONE2_WT.GRPINFO
Line 161: Line 190:
  
 Copy the two TILES014.ART and TILES015.ART files from ART directory to the ASSAULT directory. Copy the two TILES014.ART and TILES015.ART files from ART directory to the ASSAULT directory.
- 
-Select your map from the user map selection: New Game > User Map > Navigate to /userdata/roms/eduke/assault/ and select the desired map to play. 
- 
-^   ^  
-| {{:systems:dukenukemusermap1.png?direct&400 |}}{{:systems:dukenukemusermap2.png?direct&400 |}}{{:systems:dukenukemassault1.png?direct&400 |}} | 
  
 <file - Duke Assault.eduke32> <file - Duke Assault.eduke32>
Line 180: Line 204:
                |       |   └── TILES015.ART                |       |   └── TILES015.ART
                |       └── DUKE3D.GRP                    |       └── DUKE3D.GRP    
-               └── Duke Assalt.eduke32+               └── Duke Assault.eduke32
 </code> </code>
  
Line 186: Line 210:
  
 <file - Duke Nukem's Penthouse Paradise.eduke32> <file - Duke Nukem's Penthouse Paradise.eduke32>
-FILE  = /duke/DUKE3D.GRP+FILE   = /duke/DUKE3D.GRP
 FILE+  = /duke/PENTHOUS.GRP FILE+  = /duke/PENTHOUS.GRP
 +CON    = /duke/GAME.CON
 </file> </file>
  
Line 196: Line 221:
                |       ├── DUKE3D.GRP                |       ├── DUKE3D.GRP
                |       └── PENTHOUS.GRP                |       └── PENTHOUS.GRP
 +               |       └── GAME.CON (from Penthouse Paradise)
                └── Duke Nukem's Penthouse Paradise.eduke32                └── Duke Nukem's Penthouse Paradise.eduke32
 </code> </code>
Line 202: Line 228:
  
 <file - Red Zone.eduke32> <file - Red Zone.eduke32>
-FILE  = /duke/DUKE3D.GRP+FILE   = /duke/DUKE3D.GRP
 FILE+  = /duke/ZONE.GRP FILE+  = /duke/ZONE.GRP
 </file> </file>
Line 218: Line 244:
  
 <file - Red Zone.eduke32> <file - Red Zone.eduke32>
-FILE  = /duke/DUKE3D.GRP+FILE   = /duke/DUKE3D.GRP
 FILE+  = /duke/PNP.GRP FILE+  = /duke/PNP.GRP
 </file> </file>
Line 234: Line 260:
  
 <file - Duke Nukem Zero Hour.eduke32> <file - Duke Nukem Zero Hour.eduke32>
-FILE  = /duke/DUKE3D.GRP+FILE   = /duke/DUKE3D.GRP
 FILE+  = /duke/ZEROHOUR.GRP FILE+  = /duke/ZEROHOUR.GRP
 </file> </file>
Line 252: Line 278:
  
 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.
- 
-Select your map from the user map selection: New Game > User Map > Navigate to /userdata/roms/eduke/dkxtrm/ and select the desired map to play at DMMAPS or SPMAPS folder. 
- 
-^   ^  
-| {{:systems:dukenukemusermap1.png?direct&400 |}}{{:systems:dukenukemusermap2.png?direct&400 |}}{{:systems:dukenukemxtreme1.png?direct&400 |}}{{:systems:dukenukemxtreme2.png?direct&400 |}}{{:systems:dukenukemxtreme3.png?direct&400|}} | 
  
 <file - Duke Xtreme.eduke32> <file - Duke Xtreme.eduke32>
Line 294: Line 315:
 FILE = /nam/NAM.GRP FILE = /nam/NAM.GRP
 CON  = /nam/NAM.CON CON  = /nam/NAM.CON
-<\file>+</file>
  
 Files from game folder /NAM Files from game folder /NAM
Line 306: Line 327:
 </code> </code>
  
-=== NAMPAL [Walmart version of NAM with different .GPR files] ===+=== NAPALM [Walmart version of NAM with different .GPR files] ===
  
 <file - Napalm.eduke32> <file - Napalm.eduke32>
-FILE = /nampal/NAPALM.GRP +FILE = /napalm/NAPALM.GRP 
-CON  = NAMPAL.CON +CON  = NAPALM.CON 
-<\file>+</file>
  
 Files from game folder /NAMPALM Files from game folder /NAMPALM
  
 <code> <code>
-/userdata/roms/eduke32/nampal/+/userdata/roms/eduke32/napalm/
                |       ├── NAPALM.CON (Renamed from GAME.CON)                |       ├── NAPALM.CON (Renamed from GAME.CON)
                |       ├── NAPALM.GRP                |       ├── NAPALM.GRP
                |       └── NAPALM.RTS                |       └── NAPALM.RTS
-               └── Nampal.eduke32+               └── Napalm.eduke32
 </code> </code>
 +
 === World War II GI === === World War II GI ===
  
Line 335: Line 357:
                |       └── WW2GI.CON                |       └── WW2GI.CON
                └── World War II GI.eduke32                └── World War II GI.eduke32
-</code>                         +</code> 
 === World War II GI: Platoon Leader (expansion) === === World War II GI: Platoon Leader (expansion) ===
  
-<file - World War II GI - Platoon Leader .eduke32>+<file - World War II GI - Platoon Leader.eduke32>
 FILE  = /ww2gi/WW2GI.GRP FILE  = /ww2gi/WW2GI.GRP
 FILE+ = /ww2gi/PLATOONL.DAT FILE+ = /ww2gi/PLATOONL.DAT
Line 354: Line 377:
 </code> </code>
  
-How to find out which files are needed to build the .eduke32 file? The Eduke32 for PC has some .CFG files, that contains what is se add-on file used.+=== Duke Nukem 3D: 20th Anniversary World Tour ===
  
-Eduke32 compatible games: https://wiki.eduke32.com/wiki/Installation_Guide_for_Official_Add-ons+As of the date this text was written, running Duke Nukem 3D: 20th Anniversary World Tour with EDuke32 requires the use of the ''stopgap'' patch, which ensures compatibility between the game and the source port. To download the patch, visit the official ''stopgap'' patch page on GitHub: [[https://github.com/Hendricks266/e32wt|official stopgap patch GitHub page]]
  
-Duke Nukem High Definition Pack and Music Packs: https://hrp.duke4.net/download.php +<file - Duke Nukem 3D Twentieth Anniversary World Tour.eduke32> 
- +DIR = /dukewt/duke 
-Mods: https://www.moddb.com/engines/eduke32 +DIR = /dukewt/stopgap 
- +FILE = /dukewt/stopgap/e32wt.grp 
-==== Features ====+</file>
  
-Eduke32 includes the following features: +Files from game folder /dukewt
- +
-  *     EDuke32 runs natively without relying on emulation of any kind +
-  *     EDuke32 runs at crazy resolutions like 3072x2304. +
-  *     EDuke32 allows you to choose between two different hardware accelerated OpenGL renderers, or the classic, warped software mode you grew up with +
-  *     EDuke32 fixes an insane amount of programming errors which were harmless in the days of DOS but are fatal with modern protected memory models; translation: EDuke32 crashes less +
-  *     EDuke32 has been the only actively developed and maintained Duke3D port for years +
-  *     EDuke32 features Plagman's incredible "Polymer" renderer as a replacement for Ken Silverman's "Polymost" renderer +
-  *     EDuke32 has a huge number of new extensions to the game's scripting system, allowing gameplay mods that rival even modern games. +
-  *     EDuke32 runs the HRP with support for all features, most of which require EDuke32; no other port can run the HRP with all features enabled +
-  *     EDuke32 adds a full-featured console, including Quake-style key bindings, command aliases, advanced tab completion, comprehensive command history, colored text and more +
-  *     EDuke32 has hundreds of code rewrites, optimizations and fixes for rare or annoying bugs in the original code +
-  *     EDuke32 adds tons of optional new features that make the player's life easier including modern status display/HUD, support for loading mods from the startup window, and modern, WSAD-based controls with thoroughly reworked mouse aiming +
-  *     EDuke32 supports Ogg Vorbis sound and music +
-  *     EDuke32 is developed by people who have been in the Duke3D scene since the beginning +
-  *     EDuke32 lets you play that game called 'NAM' you saw at the dollar store 10 years ago +
-  *     EDuke32 makes sandwiches!+
  
 +<code>
 +/userdata/roms/eduke32/dukewt/
 +               |       ├── duke/
 +               |       |    ├── DUKE3D.GRP    (The extra features of The World Tour require the complete game installation files and folders) 
 +               |       |    └── DUKE.RTS
 +               |       └── stopgap/       (Extract the contents of the stopgap patch .zip file into this folder) 
 +               |            ├── E32WT.CON
 +               |            ├── e32wt.def
 +               |            ├── e32wt.grp
 +               |            ├── e32wt.grpinfo
 +               |            ├── E32WT_CODE.CON
 +               |            ├── e32wt_content.def
 +               |            ├── e32wt_normalmaps.def
 +               |            ├── E32WT_OLD.CON
 +               |            ├── LICENSE.txt
 +               |            ├── README.md
 +               |            └── version_e32wt.txt
 +               └── Duke Nukem 3D Twentieth Anniversary World Tour.eduke32
 +</code>
 ===== Saves ===== ===== Saves =====
  
Line 389: Line 415:
  
 ==== Eduke32 ==== ==== Eduke32 ====
- 
-FIXME [Needs review] 
  
 Standardized features available to all cores of this emulator: ''eduke32.videomode'', ''eduke32.padtokeyboard'', ''eduke32.videomode'', ''eduke32.bezel'', ''eduke32.bezel_stretch'', ''eduke32.hud'', ''eduke32.hud_corner'', ''eduke32.bezel.tattoo'', ''eduke32.bezel.tattoo_corner'', ''eduke32.bezel.tattoo_file'', ''eduke32.bezel.resize_tattoo'' Standardized features available to all cores of this emulator: ''eduke32.videomode'', ''eduke32.padtokeyboard'', ''eduke32.videomode'', ''eduke32.bezel'', ''eduke32.bezel_stretch'', ''eduke32.hud'', ''eduke32.hud_corner'', ''eduke32.bezel.tattoo'', ''eduke32.bezel.tattoo_corner'', ''eduke32.bezel.tattoo_file'', ''eduke32.bezel.resize_tattoo''
Line 404: Line 428:
 ===== Troubleshooting ===== ===== Troubleshooting =====
  
-==== Game does not launch: ==== +==== My game does not launch ==== 
  
-  * Check logs files ''es_launch_stderr.log'' and ''eduke32.log'' at ''userdata/system/logs'' 
-  * Make sure all files are available at roms/eduke32 
   * Make sure the ''.eduke32'' launch file is setup correctly   * Make sure the ''.eduke32'' launch file is setup correctly
-    * Check the case sensitive+    * Check the case sensitivity
     * Check the use of FILE, FILE+ and CON     * Check the use of FILE, FILE+ and CON
        * FILE and FILE+ must use the path ''/roms/eduke32/<gamefolder>/<main file or add-on>''        * FILE and FILE+ must use the path ''/roms/eduke32/<gamefolder>/<main file or add-on>''
        * CON also use the path ''/roms/eduke32/<gamefolder>/<con file>''        * CON also use the path ''/roms/eduke32/<gamefolder>/<con file>''
-    * ''.eduke32'' files mustn't have empty lines, so delete the empty lines +    * ''.eduke32'' files must not have any empty lines 
-  * As a last alternative, reset system files: delete files from ''/userdata/system/configs/eduke32/*'' and ''/userdata/saves/eduke32/*''+ 
 +To start from scratch, delete all the files from ''system/configs/eduke32/'' and ''saves/eduke32/''. 
  • systems/eduke32.1664844630.txt.gz
  • Last modified: 4 years ago
  • by maioni