Generating dumps

This page details the standard procedure that is used to generate the dumps before they are attached to the releases.

Requirements

1. Install the latest version of xEdit. Download the latest version from NexusMods and extract the archive in the Fallout 76 installation folder. Alternatively, obtain a more recent build from the xEdit Discord server or from the Fallout 76 datamining Discord server.
2. Download the source code of this repository's latest version. Copy the files inside the Edit scripts directory over to the Edit scripts directory created by xEdit in the Fallout 76 installation directory.
   Do not move the scripts into a subdirectory of Edit scripts because then xEdit will be unable to find some scripts.
3. For automated post-processing of the exported data, the following are also required:
   • Python 3.6 or newer.
   • All Python packages listed in requirements.txt (optionally using a venv).
   • 7zip should be on the PATH as 7z.exe. Alternatively, an absolute path can be inserted in the export.py script.
   • The default action in Windows Explorer for .fo76pas should be to run the xEdit instance in the FO76 game folder. If dumps are to be created for the PTS version, then .fo76ptspas should open the xEdit instance in the FO76 PTS game folder.

Running the dump scripts for all records and perform post-processing

1. Adjust the configuration in export.py to your needs.
2. (Optional) Activate the venv in which the requirements are installed
3. Run the export script as python -m export and follow the instructions. Once xEdit is done, close xEdit and the post-processing will start.

Running the dump scripts for all records

To generate all dumps in one go, simply execute ExportAll.fo76pas from Windows Explorer to launch xEdit. Select the plugins you want to apply the dump scripts to, and press OK to start the process. After the indices have been generated or loaded, a prompt will appear allowing you to select which dump scripts to run. Note that you can right-click to (de)select all dump scripts. After confirming your choice, a dumps/ directory will be created in the same directory as ExportAll.fo76pas, and the dumps will be placed in the dumps/ directory. Once all scripts are done, the message You can close this application now. will show, and you can close xEdit.

Running the dump scripts on a selection of records

If you want to run the dump script on a subset of records, follow the procedure below.

1. Select the relevant records
   Most scripts apply only to records with a particular signature. For each plugin (.esm), xEdit lists the records with a given signature under the appropriate heading. Hold Ctrl while clicking a record to add it to your current selection.
2. Apply the script
   Right-click one of the records that you have selected, click Apply Script..., select the ExportAll.pas script, and press the OK button.
3. Let it run
   Choose which dump scripts to run and confirm your choice. Wait for the script to complete. A message will be displayed in the Messages tab on the right side of xEdit once the script has finished executing. Additionally, the title of the xEdit window will change back to FO76Edit after the script has finished executing.
4. Inspect the generated files
   Check the files in the dumps/ directory in the root directory of Fallout 76.