Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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 invulnerable until first grab.
By TolgaFlashTR
| Date uploaded | 7 months ago |
| Version | 1.0.0 |
| Download link | TolgaFlashTR-ItemUnstuck-1.0.0.zip |
| Downloads | 1706 |
| Dependency string | TolgaFlashTR-ItemUnstuck-1.0.0 |
This mod requires the following mods to function
BepInEx-BepInExPack
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2304README
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
ValuableVolumeslot 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
ValuableVolumeobjects). - After the level finishes setting up volumes, scans all
ValuableObjectinstances. - 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:
EnableEnableRelocationScanDelaySecondsHudNotificationsShowInitialValueOnGrabInvulnerableUntilGrabFallThroughRecoveryEnabledRestoreValueToInitial
Advanced tuning settings are grouped under sections like:
Advanced.InvulnerabilityAdvanced.StuckDetectionAdvanced.MotionProbeAdvanced.FallThroughAdvanced.DamageFlowAdvanced.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!
CHANGELOG
Changelog
[1.0.3] - 2026-02-09
Changed
- Initial value show is configurable now, default is
false(previously alwaystrue).
Fixed
- Resolved nullable reference warnings in StuckValuableRelocator.
[1.0.2] - 2026-02-08
Added
- Spawn-slot aware relocation: move stuck valuables to a free
ValuableVolumeslot. - Mid-game spawn detection for items that spawn during gameplay (e.g. BlindBox, enemy drops, containers).
