RAID compatible port of https://superblt.znix.xyz/

what?

For those who don't know what this is: basically RaidBLT, but far more extended.

It has the same roots as RaidBLT, but instead was always designed for Payday2.
When Raid came it out, it was too complicated to port the whole SuperBLT package, with all it's extra features.

Instead an earlier base (just BLT, by James W.) was taken, with basically just the lua-hook framework, and there we had atleast something.
But now, it is finally time to say hello to an even better RaidBLT!

So what does that mean for existing RaidBLT mods, are they compatible?

No, but Yes!
SuperBLT uses a slightly different xml format for mods, and its name is supermod.xml, instead of mod.xml.
(note for pd2-mod devs: mod.txt, as in pd2's sblt version, is not required in the raid fork!)

..but RAIDWW2-BeardLib (which requires SuperBLT's extra features, and therefore could never be ported, until now) can handle mod.xml files!
(who like to know side-facts: RaidBLT's mod loading was actually based on BeardLib's code)

This should make it even possible to seamlessly switch to SuperBLT right now, with your whole mod collection! (if everything goes well, lol)

so, how to switch from RaidBLT, without losing mods?

first you want remove the components of RaidBLT, which conflict with RAID-SuperBLT, that being:

1. Delete IPHLPAPI.dll
2. Delete mods/base/
   It is NOT be required to delete the entire mods folder! you can just keep saves, downloads, logs and all your mods (other than base).)
3. install RAID-SuperBLT
4. install RAIDWW2-BeardLib

How to install RAID-SuperBLT?

Extract the mods directory, and one dll of your choice to your steamapps/common/RAID World War II/ directory
(should be safe to overwrite everything, if asked. however: if you had RBLT before, you might wanna delete /mods/base first, to be clean.)
RaidBLT users: make sure to delete the RaidBLT IPHLPAPI.dll at this point!

just to be super clear: the Raid-BLT IPHLPAPI.dll is not the same as the Raid-SuperBLT IPHLPAPI.dll, even if you wanna still use IPHLPAPI.dll with SBLT, you need to replace it.

Wait what? One dll of my choice?

One dll of your choice!
just as SuperBLT for PD2, we release our hook with a choice: IPHLPAPI.dll OR WSOCK32.dll (preferred)
if both are installed, IPHLPAPI.dll takes over, and WSOCK32.dll deactivated itself.

backstory: there have been cases where IPHLPAPI.dll didnt work well on some systems, which lead ZNix (original dev of SBLT) to switch the hooking mechanism over to WSOCK32.dll, which delivered better results for those cases. for maximum compat, both have been kept.

Great, but what are those 'extra features'?

• asset db: https://superblt.znix.xyz/doc/assets/asset_db/
• xml tweaker: https://superblt.znix.xyz/doc/assets/tweaker/
• Wren: https://superblt.znix.xyz/doc/wren/core_sblt_api/
• lots of blt core improvements
• custom auto update servers (with meta data): https://superblt.znix.xyz/doc/mod_definition/updates/
• a dependency system: https://superblt.znix.xyz/doc/mod_definition/dependencies/
• modern https! - the backend of dohttpreq() uses latest libcurl, using Schannel for SSH, with alt-svc, IPv6, Largefile, HSTS, libz, etc
• the ability to use BeardLib, which opens even more possibilities!

for more details (especially for mod devs), just check the "Developer Documentation" dropdown on https://superblt.znix.xyz/, there is more. However: ignore everything that has to with XAudio! we don't have that in RAID!

Mod-Devs: How to port my RBLT mod to SBLT?

For most mods, it should be sufficent to just add a supermod.xml, with a slightly different structure than RBLT's mod.xml.
For examples, you can check my mods, as those are all sblt ready now:
https://modworkshop.net/user/bangl?game=543&category=567

the rblt-xml modules for options and menus are not backported, if you used them you gotta reimplemented them yourself, or become a BeardLib mod, which those original modules originally stem from.

more beardlib rblt/sblt notes:

• if you dont require beardlib, you can have a mod.xml and supermod.xml at the same time. beardlib will ignore mod.xml files, when supermod.xml files are present, and only provide compat for rblt-only mods. that way we are able to have rblt + sblt compat at the same time, without getting loaded 2x when using sblt and beardlib.
• if you do require beardlib, and want rblt backwards compat, you can have mod.xml for rblt, supermod.xml for sblt and then main.xml for beardlib.

Source

DLL: https://github.com/RAIDModding/RAID-SuperBLT
Lua (base): https://github.com/RAIDModding/RAID-SuperBLT-Lua
thumbnail image by Dribbleondo