BlastedSwimmingTarredBugFix

Defensive runtime fixes for stale liquid state, scene and Character lifecycle cleanup, and optional MagicPlugin interoperability.

What It Fixes

• Random swimming while nowhere near water.
• Random tarred state after leaving a Plains tar pit.
• Portal, dungeon, or scene transitions leaving old liquid state behind.
• Carts or floating objects keeping water/tar state after a missed trigger exit.
• Long-lived LiquidVolume raycast arrays using a short-lived allocator.
• Scene cleanup failing on missing, destroyed, or mismatched ZNetView data.
• Malformed StatusEffect start effects interrupting Character destruction.
• Character registry and EnemyHud entries surviving incomplete destruction.
• MagicPlugin projectile patches repeatedly registering configuration handlers.
• MagicPlugin summon teleport and Character registry patches reading destroyed or incomplete objects.

How It Works

Liquid and scene protection

• Rejects stale positive liquid updates when the source no longer overlaps the target.
• Removes stale entries from WaterVolume and LiquidSurface before floater updates.
• Clamps water/tar counters so missed exits cannot drive them below zero.
• Clears purged state only when no current liquid trigger overlaps the target.
• Clears player liquid state after a teleport successfully starts.
• Keeps LiquidVolume raycast arrays valid for their full lifetime.
• Cleans invalid or mismatched ZNetScene entries without dereferencing destroyed views.

Character lifecycle protection

• Safely tears down StatusEffect start effects with missing or invalid ZNetView components.
• Repairs Character registry and EnemyHud bookkeeping when Character.OnDestroy is incomplete or throws.
• Prunes tracked creature-removal state after scene teardown.

Optional MagicPlugin interoperability

When MagicPlugin is installed, each compatible fix is enabled independently only after its expected types, methods, fields, and Harmony patch are validated:

• Replaces the affected Attack.FireProjectileBurst prefix with a guarded implementation.
• Moves valid followed summons only after a player teleport succeeds.
• Removes destroyed Characters before MagicPlugin reads the global registry.

MagicPlugin is optional and is not a Thunderstore package dependency.

Automatic Compatibility

• MyPitsDontLeak disables the integrated LiquidVolume lifetime module.
• Scenic disables the integrated scene cleanup module.
• MagicPlugin support stays inactive when the expected plugin or patch structure is absent.

Configuration

[Synchronization]
LockConfiguration = true

[Liquid]
Enabled = true
BoundsPadding = 0.75

[Diagnostics]
DebugLogging = false

Only the liquid settings are synchronized. Character lifecycle and compatibility modules are automatic and have no configuration switches.

The 1.2.0 configuration layout is not migrated from older layouts. Delete BepInEx/config/sighsorry.blastedswimmingtarredbugfix.cfg once if you want to remove obsolete entries and regenerate a clean file.

Credits

• MyPitsDontLeak by AzumattDev (MIT-0)
• Scenic by ComfyMods (GPL-3.0)

GitHub

https://github.com/sighsorry1029/BlastedSwimmingTarredBugFix