Struct WorldSnapshot 

pub struct WorldSnapshot {
    pub entities: Vec<EntitySnapshot>,
    pub resources: Vec<ResourceSnapshot>,
    pub timestamp: f64,
    pub version: u32,
    pub metadata: HashMap<String, String>,
}

A complete serialized snapshot of the world state at a point in time.

This is the primary unit passed to the save/load pipeline and the checkpoint manager.

Fields

entities: Vec<EntitySnapshot>

All entity snapshots.

resources: Vec<ResourceSnapshot>

All resource snapshots.

timestamp: f64

When this snapshot was taken, in seconds since some epoch (game time).

version: u32

Schema version — used to detect incompatible save files.

metadata: HashMap<String, String>

Free-form metadata (level name, player name, etc.).

Implementations

impl WorldSnapshot

pub fn new() -> Self

Create an empty snapshot.

pub fn with_timestamp(self, ts: f64) -> Self

Create a snapshot with a specific timestamp.

pub fn add_entity( &mut self, entity_id: u64, components: HashMap<String, SerializedValue>, )

Add or replace an entity snapshot.

pub fn add_entity_snapshot(&mut self, snapshot: EntitySnapshot)

Add an entity snapshot directly.

pub fn add_resource( &mut self, type_name: impl Into<String>, value: SerializedValue, )

Add or replace a resource snapshot.

pub fn set_meta(&mut self, key: impl Into<String>, value: impl Into<String>)

Set a metadata key.

pub fn get_meta(&self, key: &str) -> Option<&str>

Get a metadata value.

pub fn entity_count(&self) -> usize

Number of entity snapshots.

pub fn resource_count(&self) -> usize

Number of resource snapshots.

pub fn get_entity(&self, id: u64) -> Option<&EntitySnapshot>

Find an entity snapshot by id.

pub fn get_entity_mut(&mut self, id: u64) -> Option<&mut EntitySnapshot>

Find a mutable entity snapshot by id.

pub fn get_resource(&self, type_name: &str) -> Option<&ResourceSnapshot>

Find a resource snapshot by type name.

pub fn remove_entity(&mut self, id: u64) -> bool

Remove an entity by id. Returns true if it was found.

pub fn merge(&mut self, other: &WorldSnapshot)

Merge other into self. Entities and resources in other override self.

pub fn diff(&self, other: &WorldSnapshot) -> SnapshotDiff

Compute the changes from self (old) to other (new).

pub fn apply_diff(&mut self, diff: &SnapshotDiff)

Apply a SnapshotDiff to produce an updated snapshot.

Trait Implementations

impl Clone for WorldSnapshot

fn clone(&self) -> WorldSnapshot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WorldSnapshot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WorldSnapshot

fn default() -> Self

Returns the “default value” for a type.