The GodRun Theory Compatibility

Pack-specific compatibility and numerical balance patch for Risk of Rain 2.

Source and releases: https://github.com/lcnbns/TheGodRunTheoryCompat

This package is intended for The God Run Theory r2modman profile. Thunderstore installs the DLL and its required content mods automatically; the profile export supplies the pack's matching configuration choices.

Version 2.0.1

This update removes the long startup stall introduced in 2.0.0 and adds targeted protection for three recurring runtime failures found in the pack's logs:

• Uninitialized equipment-slot arrays are repaired before inventory synchronization, preventing the repeated fixed-update exception that flooded a previous long run.
• Drone Vendor dispatch ignores missing terminals, purchase data, or interactors while still dispatching every valid purchase.
• A malformed Delusion Chest controller is disabled only if its startup throws the reproduced null-reference error.

Each guard is independently configurable under Stability. The patch does not suppress WellRoundedBalance hook failures, missing optional integrations, or unrelated addressable warnings; those remain visible for upstream diagnosis.

Existing balance and compatibility changes

• Keeps the Oppressive elite's gravity and jump-lock mechanics while changing its 200 m-tall capsule into a visible 13 m spherical bubble.
• Restores twelve ClassicItemsReturns items and rebalances their existing numbers without replacing their triggers or identities.
• Restores Artifact of Clovers with 56 Leaf Clover reduced to 0.5% per elite plus 0.1 percentage point per extra stack.
• Restores Cloudburst's five finished items at a 50% numerical scale. Blast Boot remains disabled.
• Keeps Hex3 Shard of Glass disabled because it is an effective duplicate of Starstorm 2 Fork.
• Keeps VanillaVoid Clockwork Mechanism and Enhancement Vials disabled so Nautilus owns those two corruption ingredients.
• Guards the reproduced Crystalline Lotus null reference without disabling valid Lotus behavior.
• Uses startup patches and existing game events; it performs no per-frame inventory polling.

All gameplay values are configurable in BepInEx/config/com.lucie.thegodruntheorycompat.cfg. Changes to IL-patched values require restarting the game.

Every multiplayer participant should use the same DLL, item-enable configuration, and gameplay values.

Installation

Install this package through r2modman or Thunderstore Mod Manager, then import the current The God Run Theory profile code. Do not install a second manual copy of the DLL. After updating, launch once so BepInEx/config/com.lucie.thegodruntheorycompat.cfg is generated.

The two intentionally disabled VanillaVoid items and the other pack-wide enable/disable choices are controlled by the profile configuration, not by this package's dependency list.

Known upstream limitations

• ClassicItemsReturns 3.6.26 calculates Thallium's extra-stack duration but does not use it when applying the dot. This patch preserves that behavior and reduces the working base duration to two seconds.
• Cloudburst 0.4.6 has no separate Enigmatic Keycard shock-duration parameter. This patch reduces its proc chance and complete damage expression only.
• Modded Empyrean and Sandswept construct VFX are not generically suppressed in this build because broad effect filtering could hide gameplay telegraphs.

Changelog

2.0.2

• Corrected every ClassicItemsReturns language token used by the balance layer so logbook, Cookbook, and tooltip descriptions show the actual configured values.
• Synchronized 56 Leaf Clover's visible values with its gameplay roll and added strict replacement-count verification to every constant-based ClassicItemsReturns and Cloudburst patch so an upstream method change can no longer be reported as successfully patched.
• Made missing R2API language registration fail visibly instead of silently leaving stale descriptions.
• Added an optional client performance module with Risk of Options controls for effect renderer optimization, particle caps, corpse retention, damage-number limits, and effect-light shadows.
• Reused RoR2's existing effect pooling and avoided per-frame inventory or scene scans.

2.0.1

• Replaced global assembly type scans with cached exact-name lookups, removing the startup stall caused by broken optional compatibility types in other mods.
• Added a guard for uninitialized equipment slots, which previously produced more than 100,000 repeated exceptions during a long run.
• Added a null-safe Drone Vendor dispatch path that preserves valid terminal purchases while skipping malformed terminal data.
• Added a targeted Delusion Chest startup guard that disables only a malformed controller after its required component is missing.
• Exposed each runtime guard as a separate Stability configuration option.

2.0.0

• Restored and numerically rebalanced the approved ClassicItemsReturns set.
• Restored and scaled Cloudburst's five finished items.
• Added a targeted Crystalline Lotus null guard.
• Retained the Oppressive spherical aura patch.
• Kept exact duplicates and the two rejected VanillaVoid corruptions disabled through the profile configuration.