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 or SuperBLT for the 32-bit version of PAYDAY 2, you will have to:

  • Delete old versions of IPHLPAPI.dll and WSOCK32.dll, these are not compatible with the 64-bit release of PAYDAY 2.
  • Delete mods/base - This is another part of the original BLT, and SuperBLT will download its own 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 from ModWorkshop, and place it in your PAYDAY 2 folder (alongside PAYDAY2.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 (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%
  • Follow the regular instructions for installing for Windows from here on

Legacy Branch (32-bit PAYDAY 2)

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%
  • Follow the regular instructions for installing for Windows from here on

Development version

If you need to test the most recent version of the DLL you can get it from the GitHub workflow runs. 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 updater 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.