class

FActorSnapshotUtils

In-place PIE state preservation — the pre-Play snapshot the editor takes so Stop can undo Play WITHOUT destroying and recreating the world.

Module
Game
Header
#include "Game/ActorSnapshot.h"
Namespace
Mowo

CaptureActorState keeps every filtered actor ALIVE and records its backing entity alongside its property values. RestoreActorStateInPlace finds each actor back by that entity and writes the values onto the SAME instance, then re-publishes the ECS mirror — so actor and entity identity are stable across a Play/Stop cycle. Actors spawned during Play (no matching capture) are left for the caller to reap. Returns the number of actors restored.

Public functions

ReturnsNameDescription
std::vector<FActorSnapshot>SnapshotAndDestroyActors
size_tRestoreActors
std::vector<FActorSnapshot>CaptureActorState
size_tRestoreActorStateInPlace

Function details

SnapshotAndDestroyActors

C++
static std::vector<FActorSnapshot> SnapshotAndDestroyActors( MWorld& world, const std::function<bool(AActor*)>& filter)

RestoreActors

C++
static size_t RestoreActors(MWorld& world, const std::vector<FActorSnapshot>& snapshots)

CaptureActorState

C++
static std::vector<FActorSnapshot> CaptureActorState(MWorld& world, const std::function<bool(AActor*)>& filter)

RestoreActorStateInPlace

C++
static size_t RestoreActorStateInPlace(MWorld& world, const std::vector<FActorSnapshot>& snapshots)
Generated from Game/ActorSnapshot.h via game.json · Nov 5, 2026Version 1.0.0