Elric

The Elrich is a tool to process Model Files and Texture Files into a more optimized form Fallout 4 will load. This utility is included with the Creation Kit and can be found in ...\Steam\SteamApps\common\Fallout 4\Tools\Elrich.

Setup

Follow these configuration steps.

1. Open Elrich.exe.
2. Select the File->"Load Settings" menu option.
   1. -Navigate to your Elric/Settings/PCMeshes.esf file.
   2. -Note: this will populate some of the properties of this tool. Additional configuration may still be required to fit your workflow.
3. OPTIONAL: Specify an Output directory for any processed files. Defaults to Elric/Processed/...
4. OPTIONAL: You can specify a log on conversion. The log supports wildcards (%m = month, %d = day, %y = year, etc...).
   1. -For example: .\Logs\PCMeshes-%m-%d-%y_%h-%n-%s.elf
5. OPTIONAL: Select "Close Elric When Finished" to do exactly that (disabled by default in the settings file).
6. OPTIONAL: Select "Do Subdirectories" if you would like to process all files in a directory tree.
7. OPTIONAL: Select "Force Overwrite" if you would like the output files to always be written to their destination.
8. OPTIONAL: Select "Only Process If Source Is Newer" to ignore processing source files which already have output with a more recent timestamp (must disble Force Overwrite to use this).

Usage

Some Model Files may only process properly if they are exported from the "BGS Fallout 4 NIF Export Plugin Toolset", included with the Creation Kit modding tools. This process will convert Havok data in an exported Model File to a format Fallout 4 will be able to load.

Model Files will only process if there is a parent folder somewhere in their directory hierarchy which contains the string "Meshes".

-INCORRECT: C:\Fallout4\Data\Source\Geom\Mytest.nif will NOT process correctly.

-CORRECT: C:\Fallout4\Data\Source\Meshes\MyTest.nif

1. To convert a set of files, select the "Convert Files" button. Navigate to the directory with the files you want to process, and select any number of files for processing.
2. To convert a directory, select the "Convert Directory" button. Navigate to the directory to process.
3. Errors may be output for some processing failures, which can aid in debugging bad source assets.
4. Assuming proper configuration, and no errors, any resulting processed files will be output in the specified Output directory.

Command Line

Elric can be executed at the command line using the following parameters.

Update parameters to use full paths to any files or directories.

"fullpath/Elric/Elrich.exe" "fullpath/PCMeshes.esf" -ElricOptions.ConvertTarget="fullpath1,fullpath2,fullpath3,..." -ElricOptions.OutputDirectory="fulloutputpath"

-The first parameter is the ESF file.

-The ConvertTarget is a list of files or directories to process, delimited by a ",".

-Note: Any XML options in the PCMeshes.ESF can be passed at the command line as optional overrides, if necessary.

Notes

• The texture process functions as a configuration wrapper to Microsoft's DirectXTex (texconv.exe) processing tool.

See Also

• Model File
• Texture File
• Creation Kit Category
• https://github.com/Microsoft/DirectXTex