ItemUnstuck
Detects valuables stuck in world geometry and relocates them to safe spawn slots. Includes optional HUD notifications, shows a valuable's initial (undamaged) value on grab, and can keep valuables invu
About this mod Author’s original text
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)
- Mid-game spawn detection: automatically detects and relocates valuables that spawn during gameplay (e.g., from BlindBox, enemy drops, containers)
Configuration
Config file:
- BepInEx\config\Tolga.ItemUnstuck.cfg
Notable settings:
- Enable
- EnableRelocation
- ScanDelaySeconds
- HudNotifications
- ShowInitialValueOnGrab
- InvulnerableUntilGrab
- FallThroughRecoveryEnabled
- RestoreValueToInitial
- EnableMidGameDetection — detect items spawned after level load
- MidGameScanDelaySeconds — delay before checking mid-game spawned items (default: 2.5s)
- MidGameHudNotifications — show HUD message when mid-game items are relocated
Advanced tuning settings are grouped under sections like:
- Advanced.Invulnerability
- Advanced.StuckDetection
- Advanced.MotionProbe
- Advanced.FallThrough
- Advanced.DamageFlow
- Advanced.Relocation
- Advanced.MidGameDetection
Installation
(recommended)
Install 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!
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: