SuperBLT

SuperBLT is a fork of the BLT mod-loading hook for PAYDAY 2, with a number of major improvements, such as a cross-platform audio API and the ability to alter any base-game XML file without the hassle of modifying bundle files (greatly alleviating the need for Bundle Modder).

Installation

Prerequisite

If you've previously used vanilla BLT, you will have to:

  • Delete IPHLPAPI.dll - This is the original BLT DLL, and you can't have both installed at the same time due to conflicts.
  • Delete mods/base - This is another part of the original BLT, and SuperBLT will download its own version. However, you must first delete the old version.

Windows

  • Download and install the Microsoft Visual C++ 2017 Redistributable package (x86) (you will only need to do this once, even if you later reinstall SuperBLT)
  • Download the Latest Release DLL, and place it in your PAYDAY 2 folder (alongside payday2_win32_release.exe).
  • Start the game, and SuperBLT will prompt you to download the basemod. Select Yes, and it will notify you when it's done downloading. At this point, SuperBLT has been fully installed.

Linux (Native)

Dribbleondo maintains a Linux download that has compiled loaders for Debian and Arch-based distributions, which can be downloaded from modworkshop.net. If your distribution or Linux OS cannot run the precompiled loader, visit the SuperBLT repository for instructions on how to build GNU+Linux binaries for yourself.

Linux (Proton)

  • In the Compatibility tab in the game properties make sure to run through Proton and select Proton Experimental
  • Add these Launch options in the General tab in the Properties of the game: WINEDLLOVERRIDES="wsock32=n,b" %command%
  • Download the Latest Release DLL, and place it in your PAYDAY 2 folder (alongside payday2_win32_release.exe).
  • Start the game, and SuperBLT will prompt you to download the basemod. Select Yes, and it will notify you when it's done downloading. At this point, SuperBLT has been fully installed.

Regarding the IPHLPAPI.dll vs. WSOCK32.dll situation

Some computers, for reasons that are not apparent, refuse to load the IPHLPAPI.dll file as used by vanilla BLT. This seems to primarily affect Windows 10 systems. For this reason, SuperBLT has switched over to hooking WSOCK32.dll instead, which I've yet to see any trouble from.

If, for whatever reason, you require an IPHLPAPI.dll version, you can download the IPHLPAPI Release DLL, and install it like you would with the normal (i.e. WSOCK32.dll) version. Just don't install both at the same time.

Development version

If you need to test the most recent version of the DLL you can get it from AppVeyor. These versions contain the most recent changes that haven't been published officially yet and may have new features or minor bugfixes. Just note that the ingame download manager will claim there is a new version for the DLL if you use anything other than the release version of it.

Source Code

This project is Free and Open Source software, with the DLL under the GNU General Public License version 3 (or any later version), and the basemod under the BSD license.

DLL Source Code

Basemod Source Code

Developer Documentation

Almost all of the SuperBLT provided Lua functions are annotated and will show hints when working in an editor like VS Code. Documentation for all SuperBLT features can be found in the site navigation menu.