Porting Legacy Mods to Atlan

This page is a work in progress. The features discussed here are not publicly available and are subject to change.

Atlan Mod Loader now supports DOOM Eternal, and will be replacing Eternal Mod Loader. Mods created for Eternal Mod Loader will not work out-of-the-box with Atlan. This page discusses all changes that need to be made to a mod zip for it to work with Atlan.

Simple

Atlan Changes

Legacy

1. Decls

Converter

DeclTo pathsconvert arean simplifiedEternal asMod follows:Injector zip to an Atlan zip, use Atlan Legacy Converter! This tool is built into Atlan Mod Packager. To use it:

If

1. Download Atlan Mod Packager and unzip it into your DOOM Eternal installation folder.
2. Drag and drop your Eternal Mod LoaderInjector declzip pathfiles is:
   onto 

   gameresources_patch1/generated/decls/damage/damage/my_damage.declAtlanModPackager.exe

Your

3. Output: AtlanFor Modeach Loaderzip declfile pathyou convert, you'll receive an output zip with the name <Original_Zip_Name>_AtlanPackage.zip
4. Pay attention to the output log, named packager_log.txt. If any files failed to convert, or require manual conversion, the output log will be:
   tell

   decls/damage/damage/my_damage.decl

   you.

   2. Entities

   Entities paths are adjusted as follows:

   If yourthis Eternalis Modthe Loadercase, entitiesproceed pathto is:

   the

   e5m1_spear_patch1/maps/game/dlc2/e5m1_spear/e5m1_spear.entities

   next

   Your Atlan Mod Loader entities path will be:

   compfile/maps/game/dlc2/e5m1_spear/e5m1_spear.entities

   Strings

   If your Eternal Mod Loader string file path is:

   gameresources_patch3/EternalMod/strings/english.json

   Then your Atlan Mod Loader string file path is:

   binaryFile/strings/english.txt

   The capitalizationsection in binaryFilethis matters.page.

The file extension doesn't matter anymore.

Format

AtlanAdvanced hasusers changedmay wish to run the Doomlegacy Eternalconverter stringthrough modthe format.command Stringline. mod files are now CSVs instead of JSON files.

Here is an example of how to do this:

AtlanModPackager.exe --gamedir "path_to_doom_eternal_folder" "zip_1.zip" "zip_2.zip"

Any number of zip files may be specified.

Manual Conversion

The overwhelming majority of legacy injector mods should convert to an Atlan zip without issue. However, some specific file types will require manual conversion. See the following table.

File Type	Remarks
Decls	Fully supported. New path is decls/<path>.decl
Entities	Fully supported. New path is compfile/<path>.entities
SWF Files	Fully supported. New path is cswf/<path>.swf
Strings JSON	Fully supported. New path is binaryFile/<path>
Eternal Mod JSON	Fully supported. New path is atlanmod.txt
Assets Info JSON	Manual conversion required. See below.
Static Model	Fully supported. New path is model/<path>
Audio: .wem	Fully supported. New path is audio/<path>
Audio: .opus	Manual conversion required. See below.
Images	Manual conversion rarely required. See below. New path is image/<path>
Other Files	Presumably unsupported. Please discuss with tool creators.

Converting Assets Info JSONs

Atlan uses a validcompletely stringdifferent CSVformat file.

for

#str_my_awesome_string,it's "Howdy"Assets #cool_string,Info. "Another string"
#str_escape_sequences, "\n \t \\ \" Usable escape sequences"

Notes:

• The identifierYou must alwaysmanually beingconvert your Assets Info JSON files to this new format. See this page for instructions.

  Converting OPUS Audio Files

  Atlan Mod Loader cannot load OPUS audio files. In order to load legacy SFX audio mods with Atlan, you must convert your OPUS files to WEMs.

  1. Convert your OPUS file back to a '#'WAV. symbol.Tools like Audacity can do this.
  2. Use WWise to convert your WAV to a WEM. See this page.
  3. The textnew contentspath of your file in your mod zip should be audio/<path>.wem

  Converting Image Files

  Atlan Legacy Converter will successfully convert the majority of texture files. However, some files have ambiguous names that must always be containedmanually resolved. To do this:

  1. Extract the texture file from your Legacy zip
  2. Rename the file to have the exact extension metadata of the file you want to replace. Use resource explorer tools like Valen to identify the correct extension metadata.
  3. Put the image into a new zip file, keeping the same path as it had in athe quotelegacy blockzip. "likeConvert this"that zip with Atlan Legacy Converter.