Beginner's Guide: How to Install Mods

Information for people who want to learn how to play DOOM Eternal with mods.

How to Install Mods (Doom Eternal)

Game Update 6.66 rev. 1 for DOOM Eternal was released on November 18, 2021. The download links below have been updated to the newest version of the mod-loading tools that support Game Update 6.66-r1.

If you are updating from a previous version of EternalModInjector, you must verify/repair the game before installing the new mod-loading tools. If you skipped the verify/repair step and you are having problems, please follow the steps to reset your backups.

Step 1 - Mod-Loader Installation

The DOOM Eternal mod-loading tools are maintained by the DOOM 2016+ Modding Discord. The files you need and the installation instructions depend on what version of the game you have.

If you are unable to access the DOOM 2016+ Modding Discord using the invite link above, you can find the download mirrors below.

Steam/Bethesda.net versions:

If you use the Steam/Bethesda.net Launcher version on Windows, go to https://gamebanana.com/tools/download/7475 and follow these steps:

  1. Download the EternalModInjector.zip file from the message linked above.
  2. Locate your DOOM Eternal installation directory. Steam version: right-click DOOM Eternal in your Steam library, and choose "Properties..." > "Local Files" > "Browse...". This will open a File Explorer window inside your DOOM Eternal installation folder. Bethesda version:  click on DOOM Eternal's icon in the Bethesda.net launcher, click "Game Options" near the top-right, and choose "Show in Folder".
  3. Extract the contents of this .zip file into your DOOM Eternal installation's root directory, (the one you found in step #2), e.g. C:\Program Files (x86)\Steam\steamapps\common\DOOMEternal\. Overwrite any existing files if prompted.
  4. Verify the files were properly extracted. You should end up with these files in your DOOM Eternal directory. If so, the mod-loading tools are now installed.
-/EternalModInjector.bat
-/EternalModManager.exe
-/EternalModManager.exe.config

-/base/BlangParser.dll
-/base/DEternal_loadMods.exe
-/base/DEternal_patchManifest.exe
-/base/EternalPatcher.def
-/base/EternalPatcher.exe
-/base/EternalPatcher.exe.config
-/base/idRehash.exe
-/base/Newtonsoft.Json.dll
-/base/opusdec.exe
-/base/opusenc.exe
-/base/rs_data
-/base/zlib64.dll

-/Mods/

Microsoft Store (Xbox Game Pass) version:

The Microsoft Store (Xbox Game Pass) version of the mod-loading tools can be found at https://github.com/SEWsam/DOOMdumper/releases/latest.

Important: The instructions for Steam/Bethesda are not the same as for the Microsoft Store version. If you're using the Microsoft Store (Xbox Game Pass) version, follow the instructions at the link above.

Linux version:

The Linux version of the mod-loading tools can be found at https://github.com/leveste/EternalBasher/releases/latest.

Step 2 - Playing with Mods

Follow the "Mod-Loader Installation" instructions above if you haven't already.

Once you've installed the mod-loading tools, you can download and install mods as follows:

  1. Download one or more "mod loader"-based mods (they should be saved as .zip archives). You can find mods for download in Discord servers, and on websites like Nexus Mods.
  2. Put the zip archive(s) into the "Mods" folder in your DOOM Eternal installation. (You don't have to extract them, just keep them as zip archives.)
  3. Run EternalModInjector.bat. If this is the first time that you run it, it should tell you some first-time information about what the batch file does, and what to do if something goes wrong with it. Please pay attention while reading it, as the information may come in handy for you at some point.
  4. If this isn't the first time that you run it, it should automatically load mods and launch DOOM Eternal for you without requiring user input.
  5. From now on, simply launch DOOM Eternal as normal (e.g. through Steam or the Bethesda.net Launcher), and it should run with the mods that you last loaded.
  6. If you want to change which mods are/aren't loaded, move mods into/out of the "Mods" folder and run EternalModInjector.bat again.

­Please be wary that you don't enter BattleMode while you have any mods loaded. We take no responsibility for if you get yourself banned from it as a result of using mods.

 

Mod Removal

In most cases, mods can be removed simply by emptying your "Mods" folder and running the EternalModInjector.bat file again.

Removing Mods

Provided that you followed the "Mod Loader Installation" and "Playing With Mods" instructions correctly, simply empty the "Mods" folder and run EternalModInjector.bat again.

Resetting Backups

In rare cases, you may end up with mods that are "stuck" in your game files. In such a case, follow these steps to complete remove mods and perform a "clean" reinstallation:

  1. Verify/repair your game installation through Steam/Bethesda (for the Microsoft Store version, you may be required to reinstall the game).
  2. Open your DOOM Eternal installation directory and find the file called EternalModInjector Settings.txt.
  3. Use a raw text editor (e.g. Notepad or Notepad++) to open the EternalModInjector Settings.txt file, and change the line that says  RESET_BACKUPS=0 to RESET_BACKUPS=1. Save the file and close it.
  4. Run EternalModInjector.bat again. When prompted, press the key to delete your backup files and take new ones.

How to Verify/Repair (Steam version)

Right-click DOOM Eternal in your Steam library, choose "Properties..." > "Local Files" > "Verify Integrity of Game Files...", and wait for Steam to re-download the original resource files. When the download is complete, follow the steps above (starting at #2) to complete the removal of mod files.

How to Verify/Repair (Bethesda version)

Open the Bethesda.net Launcher, click on DOOM Eternal's game icon in the launcher, click "Game Options" near the top-right, choose "Scan and Repair", and wait for the Bethesda.net launcher to re-download any non-default files. When the download is complete, follow the steps above (starting at #2) to complete the removal of mod files.

How to Uninstall the Modding Tools

If you want to remove the modding tools, you can simply delete the files from your Doom Eternal directory.

After deleting the files, you must verify/repair your game installation through Steam/Bethesda in order to complete the removal. (If you have the Microsoft Store version, it may be necessary to reinstall the game).

Below is a list of files added by the EternalModInjector package. These files are safe to delete:

-/EternalModInjector.bat
-/EternalModManager.exe
-/EternalModManager.exe.config

-/base/BlangParser.dll
-/base/DEternal_loadMods.exe
-/base/DEternal_patchManifest.exe
-/base/EternalPatcher.def
-/base/EternalPatcher.exe
-/base/EternalPatcher.exe.config
-/base/idRehash.exe
-/base/Newtonsoft.Json.dll
-/base/opusdec.exe
-/base/opusenc.exe
-/base/rs_data
-/base/zlib64.dll

-/Mods/

 

Troubleshooting: Common Problems & How to Fix

The majority of problems with the mod-loading tools are caused either by installing them incorrectly, or trying to use an old/outdated version of the tools. If in doubt, make sure you downloaded the correct tools from the How To Install Mods page.

Common Error Messages

Below is a list of common error messages, along with explanations, and suggestions of how to fix them. 

DOOMEternalx64vk.exe has a wrong MD5 hash

"DOOMEternalx64vk.exe has a wrong MD5 hash!"

Explanation:

Each version of EternalModInjector is designed to work with a specific version of the gameThis error means EternalModInjector.bat is looking for a different version of the DOOMEternalx64vk.exe file than the one you have. 

How to Fix:

There are three common reasons why this error can occur:

  1. Most likely, you are using an out-of-date version of the mod-loading tools. You can always find the most updated version by following the links in the How To Install Mods page.
  2. If you're certain your mod-loading tools are up-to-date, then you may need to update your game to the latest version (in this case, run the game update through Steam/Bethesda/Microsoft/etc).
  3. It's possible you downloaded tools from the wrong version of the game. If you have the Microsoft Store version, make sure you download the Microsoft Store version of the tools (not Steam/Bethesda).

If the game itself was recently updated, it's possible that no version of EternalModInjector supports it yet. In that case, you will need to wait for an updated EternalModInjector to be released. This usually occurs within 24 - 48 hours of the latest game update.

<Other Filename> has a wrong MD5 hash

e.g. "packagemapspec.json" has a wrong MD5 hash!

Explanation:

This usually means you updated the game or mod-loading tools without following the proper steps. In general, you must always verify/repair your installation through Steam/Bethesda before updating the mod-loading tools.

How to Fix:

1. If you recently downloaded an update for EternalModInjector, make sure you extract all of the files from the EternalModInjector.zip archive. A common issue is that you might forget to extract the "base" folder - the files here need to be moved from the .zip folder into your own Doom Eternal "base" directory. Press "yes" to overwrite any existing files.

2. If you're certain that you installed the EternalModInjector update correctly, the other possibility is that you have corrupted or pre-modded backup files. This can be fixed by following the steps on this page: Resetting Your Backups.

idRehash couldn't find the resource hash offsets!

"idRehash couldn't find the resource hash offsets!"

How to Fix:

If you recently downloaded an update for EternalModInjector, make sure you extract all of the files from the EternalModInjector.zip archive. A common issue is that you might forget to extract the "base" folder.

If you're certain that you installed the EternalModInjector update correctly, follow these steps:

1. Keep the console window open with the error message visible. Read the line just above the red error message. You should see text that says "Failed to get offset for resource:" followed by a file path. An example of the file path might be .\game\dlc\e4m3_mcity\e4m3_mcity_patch2.resources"- make note of this file path, because this is the file that is causing a problem.

2. Close the console window and navigate to the file you found in step 1. This path is relative to your Doom Eternal "base" directory. So in this case you'd open your Doom Eternal installation folder, then the base folder, then game > dlc > e4m3_mcity- finally, you should see a file called e4m3_mcity_patch2.resources. Delete this file, then run EternalModInjector.bat again.

3. Run the injector again, and repeat steps 1 and 2 for any additional files that you see an error for.

If the issue still persists, or you have other issues with the game: follow the steps to Reset Your Backups.

Meta.resources is outdated or pre-modded

"meta.resources is outdated or pre-modded!"

How to Fix:

This error message isn't used anymore. This means your version of the mod-loading tools is out-of-date. To fix this, go to the How To Install Mods page and follow the instructions there to download the latest version.