MSFE - Mask Straps Fit Everyone
Mod addresses a visual anomaly where mask straps appear to float unnaturally around character heads. It's accomplished by making each heister use their individual personalised model for mask straps.
Instruction
Place folder from the archive in mods/
Main features
Fitting heister's head
As simple as it sounds, no more floating straps! Check images for comparison. It works both in the menu and during heists.
Mod also makes straps ignore any offsets that some masks have for characters.
Menu options
if you use mods that visually replaces heisters, you can make some heisters use default straps if custom ones don't fit anymore.
You can turn on global override for everyone or toggle an override per character.
Game will refresh straps automatically everytime you change an option for character currently presented on scene. It's really satisfying, you should try it!
Option to use custom straps for custom heads
If you're an author of a head replacement mod and have enough time, you can easily make your mod compatible with MSFE by adding custom straps that fit your mod specifically! It's a really straightforward process:
Instructions
- Add custom backside (for example, with BeardLib)
- Create a small .json file this:
[
{ "character": "<heister internal name1>", "unit": "<path to .unit file of custom straps model1>},
{ "character": "<heister internal name2>", "unit": "<path to .unit file of custom straps model2>}
]
for example:
[
{"character":"jowi", "unit": "units/pd2_mod_john/msk_backside_john/msk_backside_john"}
]
- Name this .json file anything you like and place it in:
<PAYDAY2 Directory>/mods/MSFE - Mask Straps Fit Everyone/custom_units/
And that's all! MSFE will use units defined for characters in .json files.
As an example, check the John Wick Likeness Restoration made by splish optional files, which now includes an MSFE addon. It will make MSFE adapt to new John Wick's head.
Starting from 1.1 update, mod is fully compatible with Third Person by Hoppip.
Known issues
-
The Fixes by Dom conflicts with MSFE because it hooks to elementinventorydummy.lua, preventing MSFE from making necessary changes in this file.
The good news is that The Fixes hook actually changes nothing at all. You can delete elementinventorydummy.lua from The Fixes folder and remove its line from fixes.xml (line 26). -
While the menu toggles function perfectly, the menu UI is a buggy mess.
At game launch, you might be able to change character-specific toggles even when "Default Straps Override Per Character" is deactivated.
The good news is that this is purely a visual glitch and does not affect functionality.
Character-specific toggles will only take effect when "Default Straps Override Per Character" is turned on.
fixed in 1.1 update -
Straps won't be updated automatically immediatly after changing options in the menu. The straps will refresh with the next mask respawn (entering inventory will be enough).
fixed in 1.1 update
Also, in optional files you find debug version of this mod. It's only for testing purposes if you want to try something with my mod. It won't actually log anything but it makes REALLY obvious whose straps are now spawned, there are also variations for default straps and error, if you set up a script to make it as fallback instead of default. Also there are source files for sequence_managers.
