Warning: This mod will not work if placed in your Addons folder like normal mods, it must instead be installed in your base game folder. See installation instructions below.

What is this and why do I want it?

By default, whenever you gain a secret in Sunless Sea, your remaining fragments are set to zero. This means that if you overshoot the secret threshold with a large fragment drop (such as from a discovery) most of the fragments in that drop are wasted. Apart from anything else, this means that a very high Pages stat (a thing that Failbetter obviously wanted to be desirable but extremely difficult to get) is of limited use or efficacy, because it means fragments are wasted more frequently.

This mod changes this behaviour to instead allow fragments to roll over. Whenever you gain a secret, the mod subtracts a number of fragments equal to 300 minus half your pages stat (which is what you would normally need to accumulate to gain a secret) from your fragment total instead of zeroing it, and keeps doing this until your total is under the threshold. If you have an extremely high pages stat, or somehow gain an extremely high number of fragments at once, then the mod will handle gaining multiple secrets at once from the same fragment drop neatly, telling you how many you have acquired instead of triggering the event multiple times (This cannot, to my knowledge, happen in normal play because no fragment drop in the game is over 181 fragments -the minimum number of fragments needed for a secret assuming a pages value of 200 with all possible boosts above that- but it's behaviour that mods that add bigger fragment drops or change the relationship of Pages to fragments might cause). UPDATE: This IS possible: It can (at the very least) happen while playing chess at the Principles of Coral.

Is this a bugfix?

Possibly. It's unclear whether the fragments = 0 behaviour was intentional or not on Failbetter's part. I'd prefer to call it a "design correction" or "quality of life fix".

Upsides and downsides

Upsides:

• Avoids feelbad fragment wastage
• High pages stat now has a usefulness that fits its inaccessibility.
  

Downsides:

• You will level up slightly faster than in the vanilla game. In order to fix this, I would need to know exactly how many fragments are on average wasted across a normal run's play, in order to increase the threshold by that much. I don't care enough to find that out, but if you do and you give me the data, I'll make a less easymode version of the mod I guess. Ultimately I believe the increase in level up speed should be minimally noticeable.
  

Compatibility

Should be compatible with any mod EXCEPT code injection using mods that specifically alter the "CheckFragments" method of the "MoveBoat" class in the game's code. Might even be compatible with those, depending on what they do. At time of publishing, no other such mods exist.

Installation (Windows)

If you already have the BepInEx code injector installed for Sunless Sea, either off your own bat or because you installed a mod like Immersive Log Book by Mayfunction, download the "plugin only" version of the mod. Otherwise, or if you're not sure, download the "full" version of the mod. In either case, extract the zip file directly into your base SunlessSea folder (the one with Sunless Sea.exe in it), and run the game. Do not install the mod in your Appdata "Addons" folder. It will not work there.

Installation (Linux)

Exactly the same as above, except that you also need to set your launch options to
WINEDLLOVERRIDES="winhttp.dll=n,b" %COMMAND%
(Big shout out to Hate09 for providing this information)

Uninstallation

Delete the "FragmentRollover.dll" file in SunlessSea\BepInEx\plugins\. If there are then no more files in that folder or the "patchers" folder next to it, you can delete the winhttp.dll and doorstop_config.ini files and the Bepinex folder in your root Sunless Sea folder if you want.