Installing Mods - itb-community/ITB-ModLoader GitHub Wiki

Windows Setup

Modding in Into the Breach only works for windows installations. Other platforms must use a compatibility layer or similar.

  1. Download the mod loader.
    1. Download the ITB-ModLoader-X.X.X.zip - NOT the sources
  2. Extract the zip into the game's base directory next to the .exe, overwriting existing files.
  3. Go to Master Mod List or the Working Mods section on the Subset forums and download whichever mod you like. Extract it into the mods folder you have created earlier.
  4. Run the game.

Need Help?

In case of problems, hit up the modding community over at the #modding-support channel on the Into the Breach discord server.

Other Platforms

Linux based platforms (MacOS, Linux, Steam Deck) are not supported natively but can be run using a compatibility layer which runs the Windows version of Into the Breach.

This has been done at least with the following:

  • Mac OSX + Crossover (Crossover is a premium version of Wine)
  • Arch Linux + Wine
  • Steam Deck + Proton (Proton a version of Wine for Steam Deck)

Other Linux based OSs and equivalent compatibility layers should work too.

High Level Directions

This highlights the overall process of set up. Each step is described in more detail in its own section as appropriate and varies some based on OS and whether you have the Steam version of ItB or not

  1. Setup Wine (or equivalent)
  2. Install Windows version of ItB
  3. Configure Wine for ModLoader
  4. Launch ItB and make sure it starts up okay
  5. Close ItB and proceed with the Windows install instructions above

Setup Wine

MacOS

  1. (Optional) Install homebrew (or MacPorts). This is highly recommended as it makes installing Wine easier
    • /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" (from https://brew.sh/)
  2. Install Wine using homebrew (or other method of your choice)
  3. Follow common install instructions

Linux

Linux setup of Wine is more complex and varies by version. User is expected to be able to install wine

  1. Install Wine following appropriate directions for your distro https://gitlab.winehq.org/wine/wine/-/wikis/Download
  2. Follow common install instructions

Steam Deck

Proton should already be installed. No extra setup is needed. Go to common install instructions

Installing Windows Version of ItB

Steam Install

  1. Open Steam and right click on Into the Breach and select "Properties"
  2. Go to "Compatibility" tab and check "Force the use of a specific Steam Play compatibility tool"
  3. Select "Proton Experimental" or "Proton 8.0+" from the dropdown
    • Note: On all Steam platforms (Linux, Mac, Steam Deck), use Proton from the dropdown
  4. Close the properties window and install ItB

Steam will automatically create a Wine prefix and install the Windows version.

GOG/Installer

  1. Go to GOG.com library and find Into the Breach
  2. Download the Windows installer - filename will be like setup_into_the_breach_1.2.93_dev_(XXXXX).exe
  3. Open up a terminal, navigate to where the installer was downloaded and run the installer with Wine: wine setup_into_the_breach*.exe
  4. Follow the installer prompts and note the installation path
  5. Wine will automatically create a prefix at ~/.wine/ if one doesn't exist

Configuring Wine for ModLoader

Steam Config

  1. Right-click Into the Breach in Steam → Properties
  2. In Launch Options field, add: WINEDLLOVERRIDES="lua5.1,sdl2,opengl32=n,b" %command%

Manual Config

  1. Find your Wine prefix path:
    • Steam (MacOS, Linux): ~/.steam/steam/steamapps/compatdata/590380/pfx/
    • Steam Deck: /home/deck/.local/share/Steam/steamapps/compatdata/590380/pfx/
    • Manual Wine: ~/.wine/ (default) or your custom prefix path
  2. Open a terminal and run: WINEPREFIX="<path_from_step_1>" winecfg
  3. In winecfg, select the "Libraries" tab and locate the "New override for library:" field
  4. For each library (lua5.1, sdl2, opengl32), do the following one at a time:
    • Type the library name in the field and click "Add"
    • The library will now be in the "Existing overrides:" list. Select it and click "Edit"
    • In the popup make sure it's set to "Native then Builtin" or "Native, Builtin" then click OK
  5. When finished, your "Existing overrides:" list should show: 
    lua5.1 (native, builtin)
sdl2 (native, builtin)
opengl32 (native, builtin)