See the Github repository for an up to date README file, because I cannot be arsed to keep this one here updated :)

Baldur’s Gate 3 Mod Profiles

This is not a mod manager! It is a collection of Bash scripts that can manage separate sets of mods in conjunction with a mod manager like BG3 Mod Manager or Lamp.

Features

• Store an arbitrary amount of profiles. Each of them contains distinct "Mods" folders, mod settings files and loose files mods.

• Create and switch between your profiles via shell script.

• Mount loose files mods into your game folder at runtime via overlayfs.

• Keep loose files mods separate! No more “which files did that add⁈” when you want to uninstall one of them.

Installation

• Install whatever package(s) provide(s) fusermount and fuse-overlayfs for your distribution.

• Clone this repository or grab an archive and extract it somewhere.

• Optional: add bg3overlay and bg3switch to your PATH.

• Optional: create bg3overlay.pre and bg3overlay.post files. They will be executed before mounting and after unmounting the overlay, respectively.

• Create a new mod profile using bg3switch --create PROFILE.

• Change Baldur’s Gate 3’s launch options in Steam to bg3overlay --enable && %command% ; bg3overlay --disable. Ifyou already had launch options set, don’t forget to keep them. If you
  did not add the scripts to your PATH, you need to add the full
  /path/to/bg3overlay.

Installing / Updating Mods, Usage

Please see the README on Github, as that will be up to date.

Troubleshooting

The game doesn’t start after changing the launch options.

Double check the launch options match the example. Run bg3overlay --enable manually and see if it works.

If yes, run bg3overlay --disable and start looking elsewhere, because it’s not my fault :)

If not, feel free to file an issue and be sure to attach the output.