REPO Instant Save (rolling rollback)

A BepInEx 5 / Harmony plugin for R.E.P.O. that keeps a rolling history of the whole run (world state and native progression) so you can roll back a few minutes after a wipe and continue alive, with the quota partially done.

This is an extended fork of Ashx87/REPO-Instant-Save, updated for R.E.P.O. v0.5.1 and reworked around a snapshot history instead of a single save point.

Features

• Automatic snapshots every 10 minutes while you are alive in a level (configurable), plus one clean snapshot ~20 seconds after each level starts. Default history: 20 snapshots = about 3 hours.
• F6 – take a snapshot right now (also pushes the next automatic snapshot 10 minutes out).
• F8 – open the snapshot list: time, level, haul progress, item/player count. The camera and gameplay input freeze while it is open, and the game's own cursor is used.
• Manage snapshots – delete a single snapshot from the list, or clear the whole history, with an inline confirmation step so a stray click cannot wipe your backups.
• One-click rollback – restores the saved .es3 (money, quota, upgrades) and rebuilds the saved level layout, then reapplies the world state (valuables, carts and their contents, doors, extraction progress, haul/quota progress, player position/health, and the items in each quick slot).
• No-permadelete safety – the game no longer deletes your save on a team wipe.
• Host / singleplayer only: all authoritative state lives on the host.

Install

1. Install BepInEx 5.4.x for R.E.P.O. (the Thunderstore BepInEx pack).
2. Install this package (subscribe in Thunderstore Mod Manager / r2modman, or drop the DLL into BepInEx/plugins/Helix65-REPO-Instant-Save/).
3. Launch the game.

Usage

• Play as host or in singleplayer.
• Wait ~20 s in a level (entry snapshot) or ~10 minutes (regular interval), or press F6, to create the first snapshot.
• Press F8 to see the history.
• After death: press F8, pick a snapshot from earlier, click Restore. The game reloads that level with the old money/quota/haul progress, the items you had in your quick slots, and your team alive.

Snapshots live next to the save:

%USERPROFILE%\AppData\LocalLow\semiwork\REPO\saves\<save>\instant_history\

Configuration

BepInEx/config/Helix65.REPOInstantSave.cfg

• FullSaveNow – save hotkey (default F6)
• SnapshotMenu – history window hotkey (default F8)
• AutoSnapshotIntervalSeconds – seconds between automatic snapshots (default 600 = 10 min, range 60–7200)
• SnapshotOnLevelEntry – take one snapshot ~20 s after each level starts (default true)
• MaxSnapshots – snapshots kept per save (default 20)
• PreventDeathDelete – block the game's auto-delete on wipe (default true)
• ShowSeconds – show seconds in snapshot timestamps/ages (default false)
• UseGameCursor – draw REPO's cursor in the F8 window; set false if you ever see two cursors (default true)

Compatibility notes

• This fork uses its own plugin GUID (Helix65.REPOInstantSave), so it can coexist with the original Ashx-REPOInstantSave without a loader conflict — but run only one of them at a time.
• Disable/uninstall SaveKeeper (Zichen-SaveKeeper): it binds F7/F9 and auto-reloads saves on level start, which fights with the rollback flow.

Credits

Original mod and restore engine: Ashx87 (MIT). v0.5.1 fixes, snapshot history, F8 menu and one-click rollback added in this fork.

Changelog

2.1.3

• The map keeps its explored rooms after a rollback. Rebuilding the level reset every room's "explored" flag, so rooms you had already been through showed up as unexplored (blue blocks) again until you walked through them once more. The explored state is now part of the snapshot.
• Items restored into the level no longer end up wedged inside walls/shelves: after the restore settles, anything overlapping static geometry is pushed back out.
• Note: rolling back a snapshot taken before 2.1.3 cannot restore the map fog state; take a new snapshot after updating.

2.1.2

• Fixed items coming back drained after a rollback. The mod was feeding the battery bar count where the game expects a percentage; charge is now stored as 0-100 % and re-applied exactly as it was when the snapshot was taken. Old snapshots are converted from bars automatically.
• Rolled-back item charge is now re-applied to items that were still on the ground or in a cart, not just the ones being re-equipped into a quick slot.
• The truck's charging station now rolls back too: crystal count and stored charge are captured with each snapshot and restored on rollback. (Crystal props can only be removed, not re-grown, so spent crystals come back as usable charge rather than meshes - charging works normally.)
• Rolling back an old snapshot (taken before 2.1.2) cannot restore the charging station; take a new snapshot after updating.

2.1.1

• Repacked the archive with forward-slash paths. 2.1.0 stored the DLL under BepInEx\plugins\..., which some mod managers on Linux/Steam Deck extract as a single file with a literal backslash in the name, so the plugin never loaded there. Windows was unaffected.
• No code changes.

2.1.0

• Own plugin GUID (Helix65.REPOInstantSave) and package name (REPOInstantSaveRolling), so the fork no longer clashes with the original Ashx-REPOInstantSave plugin id.
• Config file is now Helix65.REPOInstantSave.cfg and the plugin folder BepInEx/plugins/Helix65-REPO-Instant-Save.
• Fixed enemy-dropped valuables ("Enemy Valuable - Small/Medium/Big", the orbs monsters leave behind) vanishing after a restore. They were captured, but the re-create path only knew level-preset and surplus prefabs, so it logged "prefab not found" and dropped them.

2.0.0

• Updated for R.E.P.O. v0.5.1 (SpawnModule / ModuleSpawn signature, module rebuild rework).
• Rolling snapshot history (auto every 10 minutes by default, configurable 60-7200 s, up to 20 kept ~ 3 hours) plus an entry snapshot ~20 s after each level starts.
• Automatic snapshots no longer burst when the level/player state briefly becomes invalid.
• Each snapshot stores a copy of the native .es3, so money/quota/upgrades roll back together with the world.
• F8 in-game snapshot menu with one-click restore; camera/gameplay input freeze while open and the game's own cursor is used (OS cursor is now reliably hidden to avoid a double cursor; UseGameCursor=false falls back to the OS cursor).
• Delete a single snapshot or clear the entire history from the F8 menu (with confirmation).
• Snapshot times/ages show minutes/hours by default; seconds are optional (ShowSeconds).
• Restore now brings back quick-slot items, cart contents and the extraction haul/quota progress (not just the world and .es3).
• F6 manual snapshot (was F7).
• Explicit-selection restore bypasses the stale-snapshot check.
• Death/arena frames are never captured as the newest snapshot.

1.0.0

• Initial Thunderstore release by Ashx87.
• F7 Instant Save with HUD toast.
• Automatic cross-session restore (rebuilds the exact level layout, then restores world state).
• No-permadelete safety toggle.