BlastedSwimmingTarredBugFix

Prevents stale water/tar state from making players, carts, or floating objects stay stuck swimming or tarred after leaving a liquid trigger.

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.

How It Works

Valheim liquid volumes keep a list of objects currently inside water or tar. If OnTriggerExit is missed, an old WaterVolume or LiquidSurface can keep sending positive SetLiquidLevel(...) updates to an object that already left.

This mod keeps the fix narrow:

• Reject stale positive liquid updates when the source no longer overlaps the target.
• Remove stale entries from WaterVolume and LiquidSurface before floater updates.
• Clamp water/tar counters so missed exits cannot drive them below zero.
• Clear purged stale liquid state only when no current liquid trigger overlaps the target.
• Clear player liquid state at teleport start; destination triggers restore it if the player arrives in liquid.

Configuration

Only four options are exposed:

[General]
LockConfiguration = true
Enabled = true
BoundsPadding = 0.75

[Debug]
DebugLogging = false

Enabled turns all runtime protection on or off.

LockConfiguration lets the server control synced options.

BoundsPadding adds a small margin to liquid/target bounds checks. Keep the default unless legitimate shallow water or tar is rejected.

DebugLogging logs rejected liquid updates and stale purges. Leave it off during normal play.

Github

https://github.com/sighsorry1029/BlastedSwimmingTarredBugFix