ItemUnstuck

Detects valuables that spawn stuck inside world geometry and relocates them to a free valuable spawn slot. Also applies a short invincibility window after spawn.

Features

Spawn-slot aware relocation: moves stuck valuables to another recorded ValuableVolume slot that isn’t occupied
Invincibility window: makes valuables temporarily indestructible right after spawn (configurable)
HUD notification (optional): shows a message when valuables were relocated
Value diagnostics: logs baseline total value vs. after-scan totals (helps spot value loss)

How it works (high level)

Records valuable spawn slots during level setup (before the game destroys ValuableVolume objects).
After the level finishes setting up volumes, scans all ValuableObject instances.
Uses physics overlap checks to detect valuables embedded in world colliders.
Teleports stuck valuables to a free recorded slot (master-client only in multiplayer).

Configuration

Config file:

BepInEx\config\Tolga.ItemUnstuck.cfg

Notable settings:

Enable
EnableRelocation
ScanDelaySeconds
HudNotifications
ShowInitialValueOnGrab
InvulnerableUntilGrab
FallThroughRecoveryEnabled
RestoreValueToInitial

Advanced tuning settings are grouped under sections like:

Advanced.Invulnerability
Advanced.StuckDetection
Advanced.MotionProbe
Advanced.FallThrough
Advanced.DamageFlow
Advanced.Relocation

Installation

Thunderstore (recommended)

Install with Thunderstore Mod Manager and launch the game.

Manual

Install BepInEx 5
Copy the DLL to:

R.E.P.O.\BepInEx\plugins\ItemUnstuck\ItemUnstuck.dll

Dependencies

BepInEx-BepInExPack-5.4.2304

Multiplayer notes

Relocation runs on the master client to avoid desync.

Special thanks

teragos — for helping test the mod!