FAQ & Troubleshooting

"My actor is not being saved"

1. Does it have a Saveable Component?
2. Are the variables ticked Save Game?
3. Turn on Verbose Logging (Project Settings > Debug) and search the Output Log for captured - your actor's name should appear during a save.

"Loading duplicates my actors" / "old saves match nothing"

Renaming a level-placed actor changes its save identity: the old record no longer matches, the actor is treated as missing and (with Respawn Missing Level Actors on) respawned next to the renamed one. Delete old saves after renaming actors, or avoid renaming shipped actors.

"The colors/text I set in On Loaded do not show on clients"

They do - On Loaded fires on clients too. If you see defaults, check the client log for the lines in Step 9. Most often the PIE Net Mode is Play Standalone, which has no networking at all.

"My player data is missing after quitting"

You probably saved after the player already disconnected. Save while in game, or call Autosave Now (Synchronous = true) from a quit path where players are still connected.

"A save file got corrupted"

Nothing to do - writes are atomic and a .bak of the previous save is kept (Keep Backup File setting). A corrupt file fails CRC and the load recovers from the backup automatically; the result struct reports Recovered From Backup = true.

"I updated my game and old saves broke"

Adding or removing variables never breaks saves (serialization is name-based). Class renames and removals need a migration step - a full walkthrough with the built-in Class Remap and Drop Class steps is in Step 11: Save Versions & Migration.

"Where are the save files?"

YourProject/Saved/SaveGames/ (packaged: the project's Saved folder), unless you set Default Save Directory. A slot is one .sav file plus sidecars: .players (player records), .global (persistent/custom objects), and optionally .bak backups.

"Does it support World Partition?"

Streamed cells behave like sub-levels: data is chunked per level key, and cells load their chunk when shown. Identity is package-path based, so engine version updates do not break identities.

"How big can a save get?"

The streaming path is built for millions of records: chunked files, one sub-chunk resident at a time, a per-frame time budget and a memory ceiling. See Step 7 and tune the three Performance settings.

"Is the save file encrypted?"

Obfuscate Files adds light tamper deterrence, not real security. For a competitive game, treat client-side saves as untrusted regardless of encryption - that is why multiplayer saving is server-only.

Reading the logs

Everything logs under LogUSS. The two most useful lines:

Save 'Slot': wrote N record(s) ...
Restore: N in place, N respawned, N tombstoned, N skipped, N removed (X ms)

Turn on Verbose Logging for per-actor detail. When asking for support, paste the lines around the first Warning: - the startup line includes the plugin version.