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

1. Install BepInEx 5
2. 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!

Changelog

1.0.1 - 2025-12-30

Changes:

• Updated the mod description to clarify that the mod needs to be installed for all players on the lobby to function correctly.