Doom 3 (Boom3)

Background

Boom 3¹ is a Doom 3 and Doom 3: Resurrection Of Evil GPL source port, known to work on Windows and Linux. Doom 3 is a sci-fi horror fantasy first-person shooter computer game developed by id Software and published by ActiVision.

The PrBoom core has been authored by

The Boom 3 core is licensed under

• GPLv3

A summary of the licenses behind RetroArch and its cores can be found here.

BIOS

There are no required BIOS.

Extensions

Content that can be loaded by the Boom 3 core have the following file extensions:

• .pk4

RetroArch database(s) that are associated with the PrBoom core:

• DOOM

Features

Frontend-level settings or features that the PrBoom core respects.

Feature	Supported
Restart	✕
Screenshots	✔
Saves	✔
States	✕
Rewind	✕
Netplay	✕
Core Options	✔
RetroAchievements	✕
RetroArch Cheats	✔
Native Cheats	✔
Controls	✔
Remapping	✔
Multi-Mouse	✕
Rumble	✕
Sensors	✕
Camera	✕
Location	✕
Subsystem	✕
Softpatching	✕
Disk Control	✕
Username	✕
Language	✕
Crop Overscan	✕
LEDs	✕

Directories

The Boom 3 core's library name is 'boom3'

The Boom 3 core saves/loads to/from these directories.

Frontend's Save directory

File	Description
(conten folder)/savegames/*.save	Save
(content folder)/libretro.cfg	DOOM 3 Config

Geometry and timing

• The Boom 3 core's core provided FPS (by default) is 60
• The Boom 3 core's core provided sample rate is 44100 Hz
• The Boom 3 core's base width is dependent on the Internal resolution core option.
• The Boom 3 core's base height is dependent on the Internal resolution core option.
• The Boom 3 core's max width is dependent on the Internal resolution core option.
• The Boom 3 core's max height is dependent on the Internal resolution core option.
• The Boom 3 core's core provided aspect ratio is 4/3

Loading DOOM 3 files

Boom 3 can load pk4 files. The Boom 3 core requires game data files which can be found here and here. If you bought the game on CDs/DVD, base/pak000.pk4 - pak004.pk4 and d3xp/pak000.pk4 can be copied from the disks, the other files are from the patch.

On Linux (and probably other Unix-like systems and maybe even Windows with a mingw shell) you can extract the needed files from the official 1.3.1 patch for Linux with:

sh /path/to/doom3-linux-1.3.1.1304.x86.run --tar xvf --wildcards base/pak* d3xp/pak*

On Windows you can just install the game and the official 1.3.1 patch for Windows and then get the files from the installation directory (or copy dhewm3 in there).

Warning

Doom3 BFG is not supported.

You'll need the game data from a Doom3 installation patched to 1.3.1. Specifically, you'll need the following .pk4 files for the main game:

Filename    Size    MD5-sum
base/pak000.pk4 337MB   71b8d37b2444d3d86a36fd61783844fe
base/pak001.pk4 220MB   4bc4f3ba04ec2b4f4837be40e840a3c1
base/pak002.pk4 398MB   fa84069e9642ad9aa4b49624150cc345
base/pak003.pk4 303MB   f22d8464997924e4913e467e7d62d5fe
base/pak004.pk4 227MB   38561a3c73f93f2e6fd31abf1d4e9102
base/pak005.pk4 540KB   2afd4ece27d36393b7538d55a345b90d
base/pak006.pk4 214KB   a6e7003fa9dcc75073dc02b56399b370
base/pak007.pk4 118KB   6319f086f930ec1618ab09b4c20c268c
base/pak008.pk4 12KB    28750b7841de9453eb335bad6841a2a5

... and (optionally) these .pk4 files for the Resurrection of Evil addon:

Filename    Size    MD5-sum
d3xp/pak000.pk4 514MB   a883fef0fd10aadeb73d34c462ff865d
d3xp/pak001.pk4 98KB    06fc9be965e345587064056bf22236d2

An example folder structure would be like so:

└── contents/
    └── doom3/
        ├── base/
        │   ├── pak000.pk4
        │   ├── pak001.pk4
        │   ├── pak002.pk4
        │   ├── pak003.pk4
        │   ├── pak004.pk4
        │   ├── pak005.pk4
        │   ├── pak006.pk4
        │   ├── pak007.pk4
        │   └── pak008.pk4
        └── d3xp/
            ├── pak000.pk4 
            └── pak001.pk4

Game saves and internal configuration files will be created in the content directory, organised in folders matching the filenames of loaded content - for example:

└── contents/
    └── doom3/
        └── base/
            ├── savegames/
            │   ├── *.save  
            └── └── *.txt

Game saves are named from mission names.

Loading Doom 3: Resurrection Of Evil

Doom 3: Resurrection of Evil is a horror first-person shooter video game developed by Nerve Software and published by Activision. It was released for Microsoft Windows on April 3, 2005, as an expansion pack and sequel to Doom 3 and on October 5, 2005, for the Xbox video game console. The Xbox version does not require the original Doom 3 in order to play, and includes The Ultimate Doom, Doom II: Hell on Earth and Master Levels for Doom II.

You will need to get Doom 3 and expansion pack RoE here.

You need to load Boom 3 xp core instead of Boom3 core. After Core is loaded you can load RoE's pk4 file

└── contents/
    └── doom3/
        └── d3xp/
            ├── pak000.pk4
            └── pak001.pk4

You can get Boom 3 xp core here for now.

Config

Boom 3's internal game settings can be found in the 'libretro.cfg' file inside each game's directory.

Many of these settings may be changed from the in-game menu.

Core options

The Boom 3 core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.

• Framerate (restart) [boom3-framerate] (Auto|50fps|60fps|72fps|75fps|90fps|100fps|119fps|120fps|144fps|155fps|160fps|165fps|180fps|200fps|240fps|244fps|300fps|360fps)

  Modify framerate. Requires a restart.

Internal resolution - 640x368

Internal resolution - 1920x1080

• Internal Resolution (restart) [boom3-resolution] (480x272|640x368|720x408|960x544|1280x720|1920x1080|2560x1440|3840x2160)

  Configure the resolution. Requires a restart.

• Invert Y Axis [boom3-invert_y_axis] (OFF|ON)

  Invert the gamepad right analog stick's Y axis.

• Show FPS [boom3-show_fps] (OFF|ON)

  Shows framerate on screen.

User 1 device types

The Boom3 core supports the following device type(s) in the controls menu, bolded device types are the default for the specified user(s):

• None - Input disabled.
• Gamepad Classic - Joypad
• Gamepad Classic Alt - Joypad
• Gamepad Modern - Joypad

Joypad

User 1 input descriptors for 'Gamepad Classic' device type	RetroPad Inputs	PrBoom inputs
Use		Use
Run		Run
Show/Hide Map		Show/Hide Map
Show/Hide Menu		Show/Hide Menu
D-Pad Up		D-Pad Up
D-Pad Down		D-Pad Down
D-Pad Left		D-Pad Left
D-Pad Right		D-Pad Right
Fire		Fire
Strafe		Strafe
Strafe Left		Strafe Left
Strafe Right		Strafe Right
Previous Weapon		Previous Weapon
Next Weapon		Next Weapon

User 1 input descriptors for 'Gamepad Modern' device type	RetroPad Inputs	PrBoom inputs
Menu Cancel		Menu Cancel
Quick Save		Quick Save
Show/Hide Map		Show/Hide Map
Show/Hide Menu		Show/Hide Menu
D-Pad Up		D-Pad Up
D-Pad Down		D-Pad Down
D-Pad Left		D-Pad Left
D-Pad Right		D-Pad Right
Menu Select		Menu Select
Quick Load		Quick Load
Previous Weapon		Previous Weapon
Next Weapon		Next Weapon
Use		Use
Fire		Fire
Toggle Run		Toggle Run
180 Turn		180 Turn
	X	Strafe Left/Right
	Y	Move Forwards/Backwards
	X	Look Left/Right

External Links

• Official dhewm3 Website
• Official dhewm3 Repository
• Libretro Boom 3 Core info file
• Libretro Boom 3 xp Core info file
• Libretro Boom 3 Github Repository
• Report Libretro Boom 3 Core Issues Here

id Software

• Doom 1&2 (PrBoom)

---

1. Core renamed to Boom 3 from Dhewm3 based on original author request. ↩