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


This site uses Just the Docs, a documentation theme for Jekyll.