The modloader is a collection of lua scripts and DLL libraries, providing a framework that loads mods and empowers them with additional features.
This is a continuation of Cyberboy2000's mod loader, which was originally posted here. Seeing as he's been unreachable for quite a while, I decided to take over the deveopment to fix bugs and implement new features.
GitHub repository can be found here.
Download link: [ Version 2.2.4 ]
Release page with changelog
A list of all previous releases can be found here.
Extract the zip file into the game's base directory, next to the game's executable, overwriting files as necessary. The zip includes original copies of the overwritten files so you can easily revert, if need be.
After doing so, start the game. When you get to the main menu, there should be an additional button in the main menu reading "Mod Content", as well as modloader version string in the bottom-right corner.
If you're upgrading from a previous version of the modloader and encounter issues, the nuclear option of doing a clean reinstall of the game will solve all of them.
To install mods, simply unpack them into the mods folder in the game's base directory.
To access some functionalities of the modloader, like configuration, etc, click the Mod Content button in main menu after starting the game.
If you're interested in creating mods, be sure to join the Into the Breach Discord server, and hang out in the #modding-creation and #modding-discussion channels. They are a very useful place when it comes to getting help on how to do things, and accessing the general body of knowledge compiled by the community so far.
If you're looking for a place to start, this Google doc includes a few tutorials.
If you're an advanced modder, documentation of all additional features provided by the modloader and the mod API can be found here.
Frequently Asked Questions
- Do I need to download AUTOMATIC's DLL Extender, or Cyber's modloader?
No. This version of the modloader includes everything you need. Downloading AUTO's DLLs will actually cause problems.
- Does the modloader work on systems other than Windows? (once ITB is released on other platforms)
The lua part of the modloader does, but the additional features in the form of DLLs most likely won't. Unfortunately, I do not have enough C++ expertise to do anything about this.