Struct WorldSnapshot 

pub struct WorldSnapshot {
    pub tick: u64,
    pub dt: f64,
    pub entities: Vec<EntitySnapshot>,
    pub groups: Vec<GroupSnapshot>,
    pub stop_lookup: HashMap<StopId, usize>,
    pub metrics: Metrics,
    pub metric_tags: MetricTags,
    pub extensions: HashMap<String, HashMap<EntityId, String>>,
    pub ticks_per_second: f64,
}

Serializable snapshot of the entire simulation state.

Capture via Simulation::snapshot() and restore via WorldSnapshot::restore(). The game chooses the serde format (RON, JSON, bincode, etc.).

Extension components and resources are NOT included. Games must handle their own custom data separately.

Fields

tick: u64

Current simulation tick.

dt: f64

Time delta per tick.

entities: Vec<EntitySnapshot>

All entities indexed by position in this vec. EntityIds are regenerated on restore.

groups: Vec<GroupSnapshot>

Elevator groups (references into entities by index).

stop_lookup: HashMap<StopId, usize>

Stop ID → entity index mapping.

metrics: Metrics

Global metrics at snapshot time.

metric_tags: MetricTags

Per-tag metric accumulators and entity-tag associations.

extensions: HashMap<String, HashMap<EntityId, String>>

Serialized extension component data: name → (EntityId → RON string).

ticks_per_second: f64

Ticks per second (for TimeAdapter reconstruction).

Implementations

impl WorldSnapshot

pub fn restore( self, custom_strategy_factory: Option<&'_ dyn Fn(&str) -> Option<Box<dyn DispatchStrategy>>>, ) -> Simulation

Restore a simulation from this snapshot.

Built-in strategies (Scan, Look, NearestCar, ETD) are auto-restored. For Custom strategies, provide a factory function that maps strategy names to instances. Pass None if only using built-in strategies.

To restore extension components, call world.register_ext::<T>(name) on the returned simulation’s world for each extension type, then call Simulation::load_extensions() with this snapshot’s extensions data.

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<'de> Deserialize<'de> for WorldSnapshot

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WorldSnapshot

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.