Skip to content

Mod Manager Guide

FelisDiligens edited this page Jun 21, 2022 · 16 revisions

Hello there!

Understandably, many people are confused about the mod manager, so I made this guide.
I know this guide looks long and boring, but I recommend taking the time and reading all of it.
I try my best to cut to the chase, promised.

Table of contents

  1. Before we start
  2. Import a mod
  3. Configure a mod
  4. Deploy mods
  5. Update a mod
  6. More information!

1. Before we start

Before you can use the mod manager, you first need to pick the game path, if you haven't already.

If you're using the Xbox (Beta) app, I recommend to enable mods first:
Xbox (Beta) app
Open the game's page, click on the three dots, and enable mods. This will grant write-permission to the game path.

If the button is grayed out or somehow missing, don't worry: Just run the tool as administrator then. It’ll work anyway, even if it makes modding a bit inconvenient.


To pick the game path, go to the "Game profiles" tab in the settings:
Screenshot of 'Game profiles' tab in settings window
Click on "Attempt auto-detect" or on "..." to pick the path manually.

If you have trouble finding the game location, see: FAQ: Where is the Fallout76.exe located?

NOTE: If you use the Xbox version, make sure to use "X:\Program Files\ModifiableWindowsApps\Fallout 76" (X:\ being the drive you installed the game to). Any other path will NOT work!


When you first start the mod manager, you'll be greeted with this window:
Screenshot of mod manager

You might want to import mods you've already installed.
You can do this by clicking on "File → Import installed mods":
Screenshot "Import installed mods"\

Ready to mod the game now? Good! Let's continue:

2. Import a mod

To import a mod, you can simply drag-and-drop a *.ba2 file, an archive (*.zip, *.rar, *.7z), or a folder into the mod order.
Alternatively, you can click on the "Add archive" or "Add folder" buttons in the left panel (those with the little plus).

To sort mods, you can use the arrow buttons in the panel, or select a mod (or multiple mods) and press Ctrl+ArrowUp / Ctrl+ArrowDown.

After importing a mod, the mod manager trys to auto-detect the correct installation options. You might need to set these options yourself, though.

3. Configure a mod

There are generally three different types of mods:

  • .ba2 archives: These files contain textures, meshes, sound effects, interface files, and so on. You can think of them like *.rar or *.zip files.
  • .dll files: These files get loaded by the game and contain instructions (= machine code). They basically extend / change the game's functionality.
  • Loose assets, such as files in a Strings folder.

The mod manager gives you four options on how to install a mod:

  • Bundled *.ba2 archive: This will bundle every mod into a 'Bundled.ba2', 'Bundled - Textures.ba2', or 'Bundled - Sounds.ba2'. The files will get sorted for you.
  • Separate *.ba2 archive: This will create a new *.ba2 archive on every deployment.
  • Separate *.ba2 archive (Frozen): This will create a *.ba2 archive once (it will be stored in FrozenData) and then it will just copy and rename that archive into the Data folder. Freezing archives saves time on deployment, which is especially useful for huge re-texture mods (>1 GiB).
  • Loose files: This will copy files directly into a specified folder without putting them into a *.ba2 archive.

ℹ️ To know how to install a particular mod, you'll need to read the installation instructions of the mod authors carefully.

Let's look at an example:

Let's say you want to install Recipes and Plans Glow by runew0lf.
This mod only contains a "Glow.ba2".

Importing


Drag-and-drop the *.7z into the mod order. You can also unpack it first and drag-and-drop the *.ba2. For this example, it won't make a difference.

After importing it, you can edit the mod by simply selecting it.
This will open a side panel:
https://i.imgur.com/YqafjVe.png

Ugh, ugly.
Lets enter the URL and some more information,
and click on "Tools → NexusMods API → Update mod information",
then it will look like this:
https://i.imgur.com/0EElUmt.png

Better. Now let's focus on the installation options.

Installation options: Bundled


https://i.imgur.com/r0kINr1.png
If you select the "Bundled *.ba2 archive" option, the mod will get bundled in one or multiple "Bundled.ba2" files.
This option always works (at least for mods that come as *.ba2 files), but the deployment will take longer, as it rebuilds the bundled archives every time.

You can enable "Freeze bundled archives" to keep the bundled archives:
https://i.imgur.com/I5OGzJT.png

Installation options: Separate


If you decide to select the "Separate *.ba2 archive" option, you'll get a few more options:
https://i.imgur.com/BjOoNC0.png

Here, you can give the archive a name:
https://i.imgur.com/AUdVp4f.png

Also, you can select a preset. Since it is a mod that changes the materials of certain items (it contains *.bgsm files),
you could select the preset "General / Interface / Materials / Animations" or just leave it on "Auto-detect":
https://i.imgur.com/NYkhTRB.png

You might want to check the "Freeze" checkbox as well.
As said, it'll then pack the archive only once. This will therefore make the deployment process quicker.

Installation options: Loose files


By the way, if you wonder about the "Loose files" option:
https://i.imgur.com/AkfMm9Y.png

It only gives you the option to select the installation path relative to the game's directory. ("." being the Fallout76 folder)
So, nothing too fancy.

4. Deploy mods

The final step is to deploy mods.
Click on "Deploy", and the mod manager then starts to go through the list, from top-to-bottom, to install every mod you enabled.

5. Update a mod

When an update is available (and you use the NexusMods API), the version in the list becomes red:
https://i.imgur.com/U8k01mo.png

I suggest to update a mod this way:

  1. First, download the latest version of the mod from the Nexus.
  2. Then delete all folder contents. There's a button you can click (see image below).
  3. Drag-and-drop the archive, folder, or *.ba2 file into the little box (see image below).
  4. Check, if everything got imported correctly.
  5. Click on "Set latest version" (if you're using the NexusMods API).
  6. Deploy.

https://i.imgur.com/UfXUmvw.png

6. More information!

Keyboard shortcuts

Action Button Shortcut
Save changes File > Save changes Ctrl+S
Select all mods N/A Ctrl+A
Selecting multiple mods N/A Ctrl+Click or Shift+Click
Enable/disable mods Blue checkbox button Spacebar
Delete mods Red trash bin button Delete or Backspace
Move mods up and down Teal arrow up button and Teal arrow up button Ctrl+ArrowUp and Ctrl+ArrowDown

Side panel

If you wonder what the buttons in the panel do:

Button Action
add-archive-3-24.png Add any archive (*.zip, *.rar, *.7z, *.tar, *.ba2)
add-folder-24.png Add a folder
checked-checkbox-24(1).png Check / uncheck selected or all mods
arrow-up.png Move selected mod(s) up
arrow-down.png Move selected mod(s) down
folder-3-24.png Open the folder the mod resides in
snowflake-16-24.png Freeze selected mod(s)
thaw-24.png Unfreeze selected mod(s)
delete-24.png Delete selected mod(s)

Tip: You can select multiple mods and perform actions in bulk. (Use Shift+Click or Ctrl+Click to select multiple mods)

The settings tab

Editing the resource list

You cannot change the sResourceIndexFileList in the file itself, because it will get overwritten by the mod manager.
Instead, you may change it from the Settings tab of the mod manager:
https://i.imgur.com/vshnspy.png

  • ⚠️ Important: The list entries are separated by new-lines, not commas!
  • "Clean list" will remove non-existing files.
  • "Reset" will reset the list, if you made an accident.
  • Don't forget to hit "Apply changes".

NexusMods Integration

The mod manager can access the public NexusMods API to retrieve information about mods such as latest version, title, thumbnails, and so on.
You can also endorse mods from within the mod manager.
To access the API, you'll need to login first.

How to login?

This is all explained in detail here: NexusMods Integration

How to use?

  1. Open the mod manager
  2. Copy-and-paste the link of each mod in the side panel (otherwise the tool doesn't know what to do with it)
  3. Click on "Tools → Update mod information" to download thumbnails, etc. (see picture)