Skip to content

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.
  • The same world after play: shapes moved, some collected, and the counter showing six of six.
  • The world after Load World: every shape back where it was when the save was made, with a World loaded notification.
  • The USS Save component added to an actor in the Details panel, with its save options.
  • A Blueprint variable with the SaveGame box ticked in its advanced details.
  • A Blueprint graph calling Save World and Load World on the USS Save Subsystem from two key presses.
  • An On Post Load graph applying a loaded value: a branch on an Is Open variable that sets the door rotation.
1 / 7

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
  1. Enable the plugin.

  2. Add the USS Save component to the actors you want to keep.

  3. Tick SaveGame on the variables to keep, in the variable’s Details under Advanced.

  4. Apply the loaded values in On Post Load.

  5. Call Save World and Load World on the USS Save Subsystem.

  • 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.
  • 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.
  • 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.
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++.

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.

  • 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.
  • 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.