Installing Mods on Mac OS - itb-community/ITB-ModLoader GitHub Wiki

MacOS Setup

  1. (Optional) Install homebrew. This is highly recommended as it makes installing Wine easier
    1. Open terminal
    2. run the following: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Note: command is from from https://brew.sh/
  2. Install Wine using homebrew (or other method of your choice if not doing step 1)
    1. Reopen terminal
    2. run the following: brew install --cask --no-quarantine wine-stable Note: command is from https://gitlab.winehq.org/wine/wine/-/wikis/MacOS
  3. Install AND configure Into the breach. Steps for Steam and Installer (e.g. GoG) are provided
  4. Download the mod loader.
    1. Download the ITB-ModLoader-X.X.X.zip - NOT the sources
  5. Extract the folder OUTSIDE of the Into the Breach main folder (the one with breach.exe in it)
  6. Manually copy over and replace files from the extracted folder to the main Into the Breach folder (the one with breach.exe in it) with these steps. Something about doing it step by step seems necessary for Macs for unknown reasons
    1. Move all the dll's in the modloader folder to the game's folder and overwrite anything it asks you to
    2. Drag the mods folder into the game's folder
    3. Copy/paste the contents of the modloader's "resources" folder to that of the game
    4. Copy/paste the contents of the modloader's "scripts" folder to that of the game. when it asks to replace modloader.lua, click replace
  7. Go to Master Mod List or the Working Mods section on the Subset forums and download whichever mods you like
  8. Extract the mods and put them in the "mods" folder in the main Into the Breach folder.
    1. Make sure the mods are unzipped and do not have an extra layer of folders in them
  9. 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.