FusionFix
0.9.x | Starts Fusion with the correct profile paths, forces a datatable rebuild when your mod list changes, and turns off mods that fight Fusion over a datatable; telling you which, on the menu.
CHANGELOG
Changelog
0.3.1
Rewritten from scratch. 0.1.0 did not work. it looked for its own helper under a folder name the package no longer had, so it gave up before ever reaching Fusion. Everything below is new.
- Finds its own folder instead of guessing at it, so the namespace it is published under no longer matters.
- No executable any more. The whole mod is Lua now, which is also why it works on Linux and the Steam Deck. the old helper needed .NET, which a Proton prefix does not have, so on those machines 0.1.0 did nothing at all.
- Turns off mods that claim the same prop list as Fusion, and names them on a page over the main menu with a Back button to dismiss it. The pak is renamed aside, never deleted, and comes back on its own once nothing is fighting it. A mod claiming a list nobody else wants is left alone.
- Forces a fresh Fusion build when your mod list changes, so a mod you just
installed does not keep spawning as
error. - Leaves Fusion alone when Fusion already started itself correctly. 0.1.0's approach would have run it two or three times over.
- Starting Fusion no longer freezes the game while it works.
- Reads Fusion's log and names the pak it was reading when it failed, on your next launch. Fusion says nothing about this itself.
- Writes
FusionFix.logandFusionFix-report.txtnext to the mod, which is everything anyone needs to see what happened. - Finds Fusion wherever it is installed rather than requiring one exact folder
name, and takes a
fusion_diroverride for anything unusual. - Warns when your profile uses an overlay folder, because Fusion drops it when it restarts the game and those mods vanish for that session.
- Optional config:
enabled,conflict_action,language,launch,preview_notice,fusion_dir,launch_debounce_seconds,force_full_rebuild,verbose.
Known limitation, documented in the README: a mod that replaces the prop list wholesale cannot be merged back in from outside Fusion. It gets turned off and named, and the fix belongs in that mod.
0.1.0
First release. Did not work; see above.