Infinite Loading Fix

Infinite Loading Fix

Requires Harmony. Some heavily modded colonies hang forever while loading a save: the loading bar sits near the end, the window stops responding, and the colony never opens.

What this does

• Unsticks that freeze so the save can finish loading
• On main-menu loads, briefly holds the Play scene from activating too early (that race is what hard-hangs the game)
• Allows Play activation from a small DontDestroyOnLoad helper once the async load is ready — not from inside the menu update loop
• Skips WorldTerrainColliderManager.ClearCache Destroy work during the Entry→Play handoff (that Destroy spam can freeze the main thread)
• Reloading from inside a colony leaves scene activation alone
• No new buttons, settings, or gameplay changes
• Safe to leave on all the time as a stability fix

What you’ll notice

• Most loads: nothing obvious
• Affected main-menu loads: a short pause near the end of loading (often around 90%), then the colony opens normally

Notes

• Doesn’t change balance or mechanics
• Safe to add to an existing colony
• Works alongside diagnostic mods like Load Hang Probe; this mod is the actual fix
• Fully quit RimWorld after updating this mod so the new DLL loads

Why this happens

Save load uses an asynchronous scene change from the main menu (Entry) to the colony map (Play). The loader waits for that scene operation to finish before continuing. With some mod setups, Play starts activating while the menu is still inside that wait. The menu scene is torn down mid-call — so the async load sits stuck around 90% progress, Root_Play never starts cleanly, and the game freezes with no useful error. Separately, finishing the long event can run WorldTerrainColliderManager.ClearCache, which destroys many collider objects during the scene swap and can freeze the main thread. This mod holds Play activation back on menu loads, allows it from a DontDestroyOnLoad host after the load reaches 90%, and replaces ClearCache Destroy with a safe dictionary clear during that handoff. Reloading a save while already in a colony leaves activation alone (forcing a hard scene reload there corrupts the display).

Updates

2026-08-01

• Working approach: DontDestroyOnLoad activator + strip/no-op ClearCache
• Removed synchronous LoadScene recovery (caused black-screen hangs)
• Confirmed on a known-bad heavily modded save

2026-07-26

• Fixed reloading a save from inside a colony going weird (pixelated / stuck loading)