# Eternal Atlan Strings Modding

Atlan Mod Loader supports injecting data into Doom Eternal's binary language (blang) files.

#### Extracting Vanilla Strings

To extract Doom Eternal's vanilla string data, use [Atlan Resource Extractor](https://github.com/FlavorfulGecko5/EntityAtlan/releases/tag/Extractor) to extract resources of type `binaryFile`. This will dump the game's vanilla strings to CSV files. Each language has it's own blang file.

#### Creating String Mods

To setup a string mod for a particular language, add a new CSV file to your mod that matches the original .blang path.

For Example: to inject data into `binaryFile/strings/english.blang`

 your CSV path should be `binaryFile/strings/english.csv`

The file extension doesn't matter. It can be .csv, .txt, or anything else you prefer.

#### CSV Format

Atlan Mod Loader requires your CSV obey the following format: `#STRING_NAME "STRING TEXT"`

To summarize:

1. Your string name MUST start with a `#`
2. Your string text MUST be wrapped in quotes `"Like this"`
3. The following escape sequences are supported: `\n \r \\ \" \t`
4. OPTIONAL: You may have a comma between your string's name and text.
5. HIGHLY RECOMMENDED: Your string names should only use lowercase letters, underscores, and numbers

You may refer to the vanilla string CSV files as examples. These are all valid string CSVs that Atlan can load.

You can replace the content of existing strings or add new strings.

The following is a basic example CSV that replaces several strings found in the main menu.

```
#str_code_mainmenu_dlc1_name "THE ANCIENT CHUNGUS 1"
#str_code_mainmenu_dlc2_name "THE ANCIENT CHUNGUS 2"
#str_code_mainmenu_extras_name "SUPER COOL EXTRA STUFF"
#str_code_mainmenu_horde_name "HORSE"
```

#### Default CSV

Doom Eternal supports 13 different languages, each with it's own blang file. If you're only adding strings to your native language's blang, your custom strings will not exist when the game is played in other languages. To ensure parity between all languages, you may wish to add your untranslated strings to every blang file.

Atlan Mod Loader supports this with a special CSV: `binaryFile/strings/default.csv`

Strings in this CSV get added to all blang files that don't have their own CSV in the same mod.

For example: Let's say you have a mod with `binaryFile/strings/default.txt`

 and `binaryFile/strings/french.txt`

1. The data inside `french.txt` gets injected into the French blang
2. The data inside `default.txt` gets injected into every blang **except** French

This way, your mod can have a default/fallback CSV while being localized in specific languages.

#### Additional Information

To learn how to add colored text and other customization to your strings: see [String Customization](https://wiki.eternalmods.com/books/eternal-visual-modding/page/string-customization)