Need help? Most issues are resolved by carefully re-reading the installation instructions, but if you have stumbled on a bug, please file a bug report on the Bugs tab with as much information as possible to help us find the cause of the issue and get it squashed in an update.
This mod is very nice and essential. It's also required for Subnautica: Below Zero. Is the reason you haven't created it because it's difficult?
PS: I found “FrogFrozen” had a similar question. However, when we actually used the mod in Subnautica: Below Zero, we didn't feel it was functioning. When returning to the main menu and restarting the game, the symptom that items in the item slots aren't available isn't fixed.
This mod should already work as-is in Below Zero, I just never bothered to make a separate page for it.
However, the feature which prevents mods from being killed when backing out to main menu is not compatible with all mods - only some BepInEx plugins (not all), and 0 QMods. Unfortunately most mods for BZ are still QMods, so quite likely the mod you are referring to is a QMod and therefore this mod cannot and will not work with it until it is updated to a BepInEx plugin, and even then only if the mod doesn't do strange things that this mod cannot predict. And before you ask - no, it cannot be made to work for QMods as well, due to fundamental differences in how they are built.
From your comment about items in item slots not being available I assume you are referring to a quick slots mod. If that's the case, try Quick Slots Plus BZ (BepInEx plugin) instead of More Quick Slots (QMod). If the issue persists with Quick Slots Plus BZ then there's nothing I can do about it.
Realistically, it is the mod developer's own responsibility to consider what happens when a user quits to main menu, and you should take it up with them if their mod does not work under these conditions - it is their bug to fix, and it would usually be pretty easy for them to do so unless they're a complete novice or the mod is extremely complicated, and even then it would still be doable. Luckily, this mod is able to mitigate the issue for some mods with no extra work required, but it simply cannot ever do so for all mods.
If you use a mod which it does not work with, then your only options are to always quit to desktop, or remove that mod until it is fixed (and look for an alternative in the meantime). Go with whichever you find the least annoying.
I didn't use any QMods, only BepInEx. Therefore, I checked by removing one by one the mods involved in the item slots. The cause was "Headlamp in Chip Slot BepInEx". Looking at the "Headlamp in Chip Slot BepInEx" page, some people had the same symptoms as me. I will remove that mod until the bug is fixed. I also sympathized with your "it is the mod developer's own responsibility to consider what happens when a user quits to main menu,".
Your BepInEx also helped me when I made the mod for BZ before. I will always be grateful to you.
Any idea on why Bepin Tweaks isnt appearing on the Config Manager, I tried putting the BepInEx Tweaks folder (BepInEx->plugins->Tobey->BepInEx Tweaks) and the .dll file inside of that but it won't appear still.
The main reason I made BepInEx Tweaks in the first place was to save me having to put the same code in every one of my own mods, while making it optional for users in case it caused issues with some mods. It could also help some other author's mods survive returning to the main menu in some cases, and at the time I did consider adding it to the pack for that reason, but decided instead to release it as a standalone plugin as a simple way to make the behaviour opt-in for users, in case of unforeseen compatibility issues.
Unforeseen compatibility issues did come up, primarily with some QMods according to bug reports. As such I released an update to address this, which seems to have resolved it - I've not had a bug report about an issue caused by BepInEx Tweaks in some time. This does not however mean that there are no lingering issues, since not every user reports every issue they encounter to the mod authors.
BepInEx Tweaks also relies on Subnautica-specific code, which means it can break with updates to the game. We want to keep Subnautica-specific code which isn't mandatory out of the BepInEx pack as much as possible to reduce friction with game updates and to ensure the pack itself remains compatible with as many mods as possible, across all versions of the game, on all operating systems which can run it.
It's worth mentioning that BepInEx Tweaks only helps with a small subset of mods: only BepInEx plugins, and only those which aren't storing critical runtime state and/or functionality in a GameObject they created outside of the bounds of the BepInEx_Manager GameObject, or are handling the possibility that these GameObjects might get destroyed, at a minimum. Depending on the exact functionality of the mod, more effort by the mod's author may be required to ensure it continues to function correctly when a user loads another save.
Many mods exist today which have not been designed with these considerations in mind, and the functionality of this plugin cannot help with them, and I don't believe it would be feasible for anyone to solve that problem, aside from the individual mod authors themselves when designing and developing their mods.
I am planning to add a new plugin to the pack which will attempt to raise awareness of the problem to users and mod authors alike, by letting users know when they back out to the main menu that they should probably quit and reload the game, otherwise they risk save file corruption if they load a save which requires a mod which is no longer properly functioning. Unfortunately, that's pretty much the best I can do.
As for the extra log info, this was migrated into my BepInEx pack, but remains part of this plugin for users who have not updated the pack.
Thanks for the thorough answer. There's one thing though,
It's worth mentioning that BepInEx Tweaks only helps with a small subset of mods: only BepInEx plugins...
caught my attention. As far as I know the only mods for Subnautica 2.0 and up are bepinex plugins since QModManager is not supported past that version. To my great dismay as it means there are no buildable reactors on the Cyclops anymore. Am I wrong?
You're not wrong. But you may be misunderstanding.
BepInEx Tweaks itself can be active and loaded on the legacy branch when using QModManager, with BepInEx plugins which are compatible with legacy, like SnapBuilder, BepInEx Tweaks, Configuration Manager, etc. And I'm just saying, BepInEx Tweaks is only useful for plugins, even though it can feasibly be active and loaded while using other mod loaders, like QMM on legacy.
Hey - just wanted to let you know that this mod for some reason causes incompatibilities with either the Seatruck Arms mod (https://www.nexusmods.com/subnauticabelowzero/mods/53) or its required mod Slot Extender Zero (https://www.nexusmods.com/subnauticabelowzero/mods/44). Having this mod loaded for some reason removes the arm slots for the seatruck, but does not appear to affect any of the others. Odds are this isn't your problem at all, but I figured I'd let both mod authors know about the conflict.
I've investigated the report and found it to be accurate, somehow part of BepInEx Tweaks was indeed preventing SeaTruck Arms/Slot Extender Zero from showing the SeaTruck arm slots. I'm still not entirely sure how - I determined the line of code that caused the conflict, but I am baffled at how it caused their mod to fail. I have informed them of the code which caused their mod to fail so that they can insulate themselves from it in future, and I have released an update to BepInEx Tweaks without this code which seems to resolve the conflict.
Tweaks and Fixes is a mod to help tweak/fix some of the GAME behaviours.
BepInEx Tweaks is a mod to help tweak/fix BEPINEX-related behaviours.
Neither of them are NEEDED for SnapBuilder, but BepInEx Tweaks is recommended if you like to back out to the main menu, as without it SnapBuilder (and all other BepInEx plugins) will be destroyed (essentially unloaded) when you do. e.g. if you back out to main menu then load another save or start a new game while you were already in a game, SnapBuilder won't be active anymore as it needs its plugin component loaded to function.
Whether you want Tweaks and Fixes installed also is up to you.
This is listed as required by a mod for Below Zero. I've never seen a cross-nexus requirement before, so I just want to make sure, does this work with both Subnautica and Subnautica Below Zero?
EDIT: Immediately after posting this, I realized you were the one who made both mods. So, I imagine it does work for both?
Keeps BepInEx plugins (mods) alive when backing out from a game to the main menu. Without this tweak, every time you exit to main menu, all your mods will stop working or be incredibly buggy.
Sets a reasonable default hotkey (F2) for BepInEx.ConfigurationManager, the popular in-game settings editor for BepInEx plugins. Without this tweak, the hotkey is F1, which causes Subnautica to open a dev info panel. The hotkey can be customised as needed.
Essentially, it is a useful additional BepInEx plugin specifically for Subnautica to help mods work their best and alleviate pain points for end users, but it is technically entirely optional. More tweaks will be added as needed.
BepInEx has been involved with Subnautica since the release of QMM4, which was powered by BepInEx.
The reason some mods are choosing to convert to BepInEx mods is because BepInEx works seamlessly with the 2.0 update, whereas QMM needs to be updated to work.
Therefore, if those mods do not require features from QMM or mods made for QMM, then it makes sense to become a BepInEx mod, especially since BepInEx mods and QMM are fully compatible with one another, but QMods go in the QMods folder, and BepInEx mods go in the BepInEx/plugins or BepInEx/patchers folder.
Thank you for the reply! I didn't know BepInEx was related to the update of Subnautica to begin with. Thank you for explaining why some mods are swapping over to it. It's a small incovenience to handle multiple modding ways, knowing why helps.
Yes, unfortunately it has been very difficult to get messages out to users about why things have gone this way. Putting info on one mod page can help, but it only will reach a certain amount of the user base.
Unfortunately nexus haven't made a news post about it though I did talk to them about it and they said they would so I don't know why they haven't...
With the upcoming updates to the vortex extension I'm going to try to get that to explain to Vortex users what's happened, why it's happened, and what they need to know. So hopefully that will help most nexus users, who can pass the word on
Right now we're just in that messy transitional period where nobody knows which way is up haha, but it will get better!
28 comments
Most issues are resolved by carefully re-reading the installation instructions, but if you have stumbled on a bug, please file a bug report on the Bugs tab with as much information as possible to help us find the cause of the issue and get it squashed in an update.
PS: I found “FrogFrozen” had a similar question. However, when we actually used the mod in Subnautica: Below Zero, we didn't feel it was functioning. When returning to the main menu and restarting the game, the symptom that items in the item slots aren't available isn't fixed.
However, the feature which prevents mods from being killed when backing out to main menu is not compatible with all mods - only some BepInEx plugins (not all), and 0 QMods. Unfortunately most mods for BZ are still QMods, so quite likely the mod you are referring to is a QMod and therefore this mod cannot and will not work with it until it is updated to a BepInEx plugin, and even then only if the mod doesn't do strange things that this mod cannot predict. And before you ask - no, it cannot be made to work for QMods as well, due to fundamental differences in how they are built.
From your comment about items in item slots not being available I assume you are referring to a quick slots mod. If that's the case, try Quick Slots Plus BZ (BepInEx plugin) instead of More Quick Slots (QMod). If the issue persists with Quick Slots Plus BZ then there's nothing I can do about it.
Realistically, it is the mod developer's own responsibility to consider what happens when a user quits to main menu, and you should take it up with them if their mod does not work under these conditions - it is their bug to fix, and it would usually be pretty easy for them to do so unless they're a complete novice or the mod is extremely complicated, and even then it would still be doable. Luckily, this mod is able to mitigate the issue for some mods with no extra work required, but it simply cannot ever do so for all mods.
If you use a mod which it does not work with, then your only options are to always quit to desktop, or remove that mod until it is fixed (and look for an alternative in the meantime). Go with whichever you find the least annoying.
I didn't use any QMods, only BepInEx. Therefore, I checked by removing one by one the mods involved in the item slots. The cause was "Headlamp in Chip Slot BepInEx". Looking at the "Headlamp in Chip Slot BepInEx" page, some people had the same symptoms as me. I will remove that mod until the bug is fixed. I also sympathized with your "it is the mod developer's own responsibility to consider what happens when a user quits to main menu,".
Your BepInEx also helped me when I made the mod for BZ before. I will always be grateful to you.
Not every mod shows up in Configuration Manager, and not every setting shows up there by default.
Unforeseen compatibility issues did come up, primarily with some QMods according to bug reports. As such I released an update to address this, which seems to have resolved it - I've not had a bug report about an issue caused by BepInEx Tweaks in some time. This does not however mean that there are no lingering issues, since not every user reports every issue they encounter to the mod authors.
BepInEx Tweaks also relies on Subnautica-specific code, which means it can break with updates to the game. We want to keep Subnautica-specific code which isn't mandatory out of the BepInEx pack as much as possible to reduce friction with game updates and to ensure the pack itself remains compatible with as many mods as possible, across all versions of the game, on all operating systems which can run it.
It's worth mentioning that BepInEx Tweaks only helps with a small subset of mods: only BepInEx plugins, and only those which aren't storing critical runtime state and/or functionality in a GameObject they created outside of the bounds of the BepInEx_Manager GameObject, or are handling the possibility that these GameObjects might get destroyed, at a minimum. Depending on the exact functionality of the mod, more effort by the mod's author may be required to ensure it continues to function correctly when a user loads another save.
Many mods exist today which have not been designed with these considerations in mind, and the functionality of this plugin cannot help with them, and I don't believe it would be feasible for anyone to solve that problem, aside from the individual mod authors themselves when designing and developing their mods.
I am planning to add a new plugin to the pack which will attempt to raise awareness of the problem to users and mod authors alike, by letting users know when they back out to the main menu that they should probably quit and reload the game, otherwise they risk save file corruption if they load a save which requires a mod which is no longer properly functioning. Unfortunately, that's pretty much the best I can do.
As for the extra log info, this was migrated into my BepInEx pack, but remains part of this plugin for users who have not updated the pack.
Am I wrong?
BepInEx Tweaks itself can be active and loaded on the legacy branch when using QModManager, with BepInEx plugins which are compatible with legacy, like SnapBuilder, BepInEx Tweaks, Configuration Manager, etc. And I'm just saying, BepInEx Tweaks is only useful for plugins, even though it can feasibly be active and loaded while using other mod loaders, like QMM on legacy.
I've investigated the report and found it to be accurate, somehow part of BepInEx Tweaks was indeed preventing SeaTruck Arms/Slot Extender Zero from showing the SeaTruck arm slots. I'm still not entirely sure how - I determined the line of code that caused the conflict, but I am baffled at how it caused their mod to fail. I have informed them of the code which caused their mod to fail so that they can insulate themselves from it in future, and I have released an update to BepInEx Tweaks without this code which seems to resolve the conflict.
Tweaks and Fixes is a mod to help tweak/fix some of the GAME behaviours.
BepInEx Tweaks is a mod to help tweak/fix BEPINEX-related behaviours.
Neither of them are NEEDED for SnapBuilder, but BepInEx Tweaks is recommended if you like to back out to the main menu, as without it SnapBuilder (and all other BepInEx plugins) will be destroyed (essentially unloaded) when you do. e.g. if you back out to main menu then load another save or start a new game while you were already in a game, SnapBuilder won't be active anymore as it needs its plugin component loaded to function.
Whether you want Tweaks and Fixes installed also is up to you.
EDIT: Immediately after posting this, I realized you were the one who made both mods. So, I imagine it does work for both?
Essentially, it is a useful additional BepInEx plugin specifically for Subnautica to help mods work their best and alleviate pain points for end users, but it is technically entirely optional. More tweaks will be added as needed.
The reason some mods are choosing to convert to BepInEx mods is because BepInEx works seamlessly with the 2.0 update, whereas QMM needs to be updated to work.
Therefore, if those mods do not require features from QMM or mods made for QMM, then it makes sense to become a BepInEx mod, especially since BepInEx mods and QMM are fully compatible with one another, but QMods go in the QMods folder, and BepInEx mods go in the BepInEx/plugins or BepInEx/patchers folder.
Unfortunately nexus haven't made a news post about it though I did talk to them about it and they said they would so I don't know why they haven't...
With the upcoming updates to the vortex extension I'm going to try to get that to explain to Vortex users what's happened, why it's happened, and what they need to know. So hopefully that will help most nexus users, who can pass the word on
Right now we're just in that messy transitional period where nobody knows which way is up haha, but it will get better!
- Install the latest version of BepInEx?. On Windows, pick the x64 version and extract the archive into your game folder. Click here for full installation instructions?, including for Linux and macOS.
- Optionally download BepInEx.ConfigurationManager?? and extract the archive into your game folder.
- Download BepInEx Tweaks from the Files tab and extract the archive into your game folder.
Ran game, So were is this Conflguration File? Game did not make one?The configuration file gets generated in the [GameDir]\BepInEx\config folder. You can also press F2 in-game to open the configuration window.
If the game didn't generate a config file or the window didn't open, this sounds like an installation issue.
For installation issues, you'll find much faster support at the Subnautica Modding discord linked in the above sticky post.