BG3 Mod Profiles for Linux

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.

• []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.