PulseSave
Pulse Build needs no bridge for PulseSave: the building world and the builders save themselves as bytes (IPulseByteSaveable of PulseFoundation), and PulseSave keeps them in its general byte model with its byte collector, which the save menus use by default (a project that changed their collectors gets it back with the Set Up step “Let the save menus save objects that save themselves as bytes” of PulseGameplaySaveBridge).
| What | Save identity | Where |
|---|---|---|
| The building world: pieces, sites, health, spline points, zones and claims, actor data such as chest contents | Pulse.Build.Save.World, save scope World | A save carrier of PulseFoundation stands in for UPulseBuildSubsystem (loads with priority 100) |
| A builder: build points, favorites, hotbar, recent pieces | Pulse.Build.Save.Builder | UPulseBuildComponent; on a player actor the key is the player id |
The actors of actor pieces and their components that save themselves (an inventory in a chest) are saved inside the building world (Actor pieces). The byte collector of PulseSave finds them too and would keep a second copy under the name of an actor spawned at runtime; leave them out in a module of the game that uses both plugins:
// StartupModule
Pulse::Save::AddObjectFilter(TEXT("PulseBuild"), &Pulse::Build::Save::IsSavedWithPiece);
// ShutdownModule
Pulse::Save::RemoveObjectFilter(TEXT("PulseBuild"));
Without the filter both copies are written; the one of PulseSave is keyed by the name of an actor spawned at runtime (Pulse Check reports it as name based) and is not needed, since the building world loads its piece actors itself.
Saving and loading happen on the authority only. Loading replaces all pieces; their ids stay the same, so other saved systems can keep referring to them. Pieces are saved by the ids of their definitions (PulseBuildPiece:<name>); pieces whose id no definition answers to are skipped and listed in the import report (PulseSave reports). Data of an older version of the building world (before the ids) is refused with an error. The messages of a load carry CatchUp = Load.
The bridge PulseBuildSaveBridge with its save models and saveable components is archived; the building world in saves made with it is not read (the plugins were not released yet).