Universal Save System
Universal Save System saves and loads the whole world, not just the player. Add the USS Save component to an actor, and its position and every variable you mark SaveGame are saved, on the actor and on its components.
Load World opens the saved level and puts it all back: actors spawned while playing are recreated, level actors that were destroyed stay destroyed, and references between saved actors reconnect.
There is nothing else to set up: no save classes to write, no lists of actors to maintain and no code per actor. It works from Blueprint and from C++.
The demo world with a World saved notification: crates and coloured shapes arranged on a grey floor.
- Current version
- 1.0
- Unreal Engine
- 5.4 - 5.8
The demo video
Section titled “The demo video”Quick start
Section titled “Quick start”-
Enable the plugin.
-
Add the USS Save component to the actors you want to keep.
-
Tick SaveGame on the variables to keep, in the variable’s Details under Advanced.
-
Apply the loaded values in On Post Load.
-
Call Save World and Load World on the USS Save Subsystem.
What is saved
Section titled “What is saved”- Location, rotation and scale of every actor with the USS Save component.
- Every SaveGame variable of the actor and of its components: bool, byte, integer, float, enum, name, string, text, vector, rotator and transform.
- Structs, saved whole, Blueprint structs included, plus arrays, sets and maps.
- References to other saved actors and their components, saved by id so they reconnect after a load.
- References to assets and classes, soft object and soft class references.
- Where the player was looking, with the player’s pawn.
The world, as it was
Section titled “The world, as it was”- Actors placed in the level are found again by level and name.
- A placed actor that was destroyed, a pickup taken or an enemy killed, stays destroyed.
- Actors spawned while playing are recreated from their class, in place, with their variables.
- Actors spawned after the save are removed by the load.
- The player’s pawn, controller and player state, the game mode and the game state are matched, never duplicated or destroyed.
- Actors in streaming sublevels keep their state while their level is streamed out, and get it back as it streams in.
Saves that do not break
Section titled “Saves that do not break”- A save is never half-written: the new file is written beside the old one, read back, then swapped in. If the game quits or crashes while saving, the old save is still whole.
- Every save carries a checksum. A damaged or truncated file is refused with a clear log line, and the world is left untouched.
- Add or remove SaveGame variables in a game update and old saves still load. A renamed class is covered by a Core Redirect, and a Save Version with an On Migrate event converts old values when you need it.
- Saves made on Unreal Engine 5.4 load on 5.5 and 5.8.
Events
Section titled “Events”| Event | When |
|---|---|
| On Pre Save | Copy anything kept elsewhere into SaveGame variables |
| On Post Load | Apply the loaded values: open the door, hide the taken item. Every saved actor is restored before it fires |
| On Migrate | The save was made with an older Save Version |
| On World Saved, On World Loaded, On World Restored | On the subsystem |
Events come from the USS Save component, or from the USS Save Interface on the actor or any of its components, in Blueprint or C++.
Your own save slots
Section titled “Your own save slots”Capture World returns the world as an array of bytes, and Restore World puts it back. Keep the bytes in your own SaveGame object: your menu owns the slots, thumbnails and screens, while this owns the world. That is how it sits beside a menu system such as Cipher or Rally, which have their own save slot screens.
Tested
Section titled “Tested”- An automated test of 370 checks passes on every engine version from 5.4 to 5.8: in a standalone game, across a full quit and relaunch, and in Play In Editor.
- The same test passes in a packaged game, and the demo’s own Blueprint checks pass in the packaged Shipping demo.
- It covers missing and damaged files, interrupted writes, old saves after a class change, and 1,000 saved actors.
- 1,000 actors with 28 saved variables each take about a tenth of a second to save and to restore in a development editor build, half that in a packaged game, and 3.9 MB on disk.
What it is not
Section titled “What it is not”- Not multiplayer. It saves the local world. Server-authoritative saves are planned.
- Not a menu or a slot screen. It saves and loads; your UI decides when.
- One level per save: the level being played, with its streaming sublevels. Other levels’ state is not kept when the game travels between levels.
- World Partition levels are not tested.
- Saves are not compressed or encrypted.
- An actor attached at runtime comes back in place but not attached, and physics bodies come back at rest.
- Objects created at runtime that are not actors are saved as references only.







