Struct World 

pub struct World { /* private fields */ }

Central storage for all simulation entities and their components.

Uses separate SecondaryMap per component type (struct-of-arrays pattern) to enable independent mutable borrows of different component storages within the same system function.

Built-in components are accessed via typed methods. Games can attach custom data via the extension storage (insert_ext / get_ext). The query builder (world.query::<...>()) provides ECS-style iteration.

Implementations

impl World

pub fn new() -> Self

Create an empty world with no entities.

pub fn spawn(&mut self) -> EntityId

Allocate a new entity. Returns its id. No components attached yet.

pub fn despawn(&mut self, id: EntityId)

Remove an entity and all its components (built-in and extensions).

Cross-references are cleaned up automatically:

• If the entity is a rider aboard an elevator, it is removed from the elevator’s rider list and current_load is adjusted.
• If the entity is an elevator, its riders’ phases are reset to Waiting.

pub fn is_alive(&self, id: EntityId) -> bool

Check if an entity is alive.

pub fn entity_count(&self) -> usize

Number of live entities.

pub fn position(&self, id: EntityId) -> Option<&Position>

Get an entity’s position.

pub fn position_mut(&mut self, id: EntityId) -> Option<&mut Position>

Get an entity’s position mutably.

pub fn set_position(&mut self, id: EntityId, pos: Position)

Set an entity’s position.

pub fn prev_position(&self, id: EntityId) -> Option<&Position>

Snapshot of an entity’s position at the start of the current tick.

Pairs with position to support sub-tick interpolation (see Simulation::position_at).

pub fn velocity(&self, id: EntityId) -> Option<&Velocity>

Get an entity’s velocity.

pub fn velocity_mut(&mut self, id: EntityId) -> Option<&mut Velocity>

Get an entity’s velocity mutably.

pub fn set_velocity(&mut self, id: EntityId, vel: Velocity)

Set an entity’s velocity.

pub fn elevator(&self, id: EntityId) -> Option<&Elevator>

Get an entity’s elevator component.

pub fn elevator_mut(&mut self, id: EntityId) -> Option<&mut Elevator>

Get an entity’s elevator component mutably.

pub fn set_elevator(&mut self, id: EntityId, elev: Elevator)

Set an entity’s elevator component.

pub fn rider(&self, id: EntityId) -> Option<&Rider>

Get an entity’s rider component.

pub fn rider_mut(&mut self, id: EntityId) -> Option<&mut Rider>

Get an entity’s rider component mutably.

pub fn set_rider(&mut self, id: EntityId, rider: Rider)

Set an entity’s rider component.

pub fn stop(&self, id: EntityId) -> Option<&Stop>

Get an entity’s stop component.

pub fn stop_mut(&mut self, id: EntityId) -> Option<&mut Stop>

Get an entity’s stop component mutably.

pub fn set_stop(&mut self, id: EntityId, stop: Stop)

Set an entity’s stop component.

pub fn route(&self, id: EntityId) -> Option<&Route>

Get an entity’s route.

pub fn route_mut(&mut self, id: EntityId) -> Option<&mut Route>

Get an entity’s route mutably.

pub fn set_route(&mut self, id: EntityId, route: Route)

Set an entity’s route.

pub fn line(&self, id: EntityId) -> Option<&Line>

Get an entity’s line component.

pub fn line_mut(&mut self, id: EntityId) -> Option<&mut Line>

Get an entity’s line component mutably.

pub fn set_line(&mut self, id: EntityId, line: Line)

Set an entity’s line component.

pub fn remove_line(&mut self, id: EntityId) -> Option<Line>

Remove an entity’s line component.

pub fn iter_lines(&self) -> impl Iterator<Item = (EntityId, &Line)>

Iterate all line entities.

pub fn patience(&self, id: EntityId) -> Option<&Patience>

Get an entity’s patience.

pub fn patience_mut(&mut self, id: EntityId) -> Option<&mut Patience>

Get an entity’s patience mutably.

pub fn set_patience(&mut self, id: EntityId, patience: Patience)

Set an entity’s patience.

pub fn preferences(&self, id: EntityId) -> Option<&Preferences>

Get an entity’s preferences.

pub fn set_preferences(&mut self, id: EntityId, prefs: Preferences)

Set an entity’s preferences.

pub fn access_control(&self, id: EntityId) -> Option<&AccessControl>

Get an entity’s access control.

pub fn access_control_mut(&mut self, id: EntityId) -> Option<&mut AccessControl>

Get an entity’s access control mutably.

pub fn set_access_control(&mut self, id: EntityId, ac: AccessControl)

Set an entity’s access control.

pub fn energy_profile(&self, id: EntityId) -> Option<&EnergyProfile>

Get an entity’s energy profile.

pub fn energy_metrics(&self, id: EntityId) -> Option<&EnergyMetrics>

Get an entity’s energy metrics.

pub fn energy_metrics_mut(&mut self, id: EntityId) -> Option<&mut EnergyMetrics>

Get an entity’s energy metrics mutably.

pub fn set_energy_profile(&mut self, id: EntityId, profile: EnergyProfile)

Set an entity’s energy profile.

pub fn set_energy_metrics(&mut self, id: EntityId, metrics: EnergyMetrics)

Set an entity’s energy metrics.

pub fn service_mode(&self, id: EntityId) -> Option<&ServiceMode>

Get an entity’s service mode.

pub fn set_service_mode(&mut self, id: EntityId, mode: ServiceMode)

Set an entity’s service mode.

pub fn destination_queue(&self, id: EntityId) -> Option<&DestinationQueue>

Get an entity’s destination queue.

pub fn set_destination_queue(&mut self, id: EntityId, queue: DestinationQueue)

Set an entity’s destination queue.

pub fn iter_elevators( &self, ) -> impl Iterator<Item = (EntityId, &Position, &Elevator)>

Iterate all elevator entities (have Elevator + Position).

pub fn elevator_ids(&self) -> Vec<EntityId>

Iterate all elevator entity IDs (allocates).

pub fn elevator_ids_into(&self, buf: &mut Vec<EntityId>)

Fill the buffer with all elevator entity IDs, clearing it first.

pub fn iter_riders(&self) -> impl Iterator<Item = (EntityId, &Rider)>

Iterate all rider entities.

pub fn iter_riders_mut( &mut self, ) -> impl Iterator<Item = (EntityId, &mut Rider)>

Iterate all rider entities mutably.

pub fn rider_ids(&self) -> Vec<EntityId>

Iterate all rider entity IDs (allocates).

pub fn iter_stops(&self) -> impl Iterator<Item = (EntityId, &Stop)>

Iterate all stop entities.

pub fn stop_ids(&self) -> Vec<EntityId>

Iterate all stop entity IDs (allocates).

pub fn iter_idle_elevators( &self, ) -> impl Iterator<Item = (EntityId, &Position, &Elevator)>

Iterate elevators in Idle phase (not disabled).

pub fn iter_moving_elevators( &self, ) -> impl Iterator<Item = (EntityId, &Position, &Elevator)>

Iterate elevators that are currently moving — either on a dispatched trip (MovingToStop) or a repositioning trip (Repositioning). Excludes disabled elevators.

pub fn iter_waiting_riders(&self) -> impl Iterator<Item = (EntityId, &Rider)>

Iterate riders in Waiting phase (not disabled).

pub fn find_stop_at_position(&self, position: f64) -> Option<EntityId>

Find the stop entity at a given position (within epsilon).

pub fn find_nearest_stop(&self, position: f64) -> Option<EntityId>

Find the stop entity nearest to a given position.

Unlike find_stop_at_position, this finds the closest stop by minimum distance rather than requiring an exact match. Used when ejecting riders from a disabled/despawned elevator mid-transit.

pub fn stop_position(&self, id: EntityId) -> Option<f64>

Get a stop’s position by entity id.

pub fn insert_ext<T: 'static + Send + Sync + Serialize + DeserializeOwned>( &mut self, id: EntityId, value: T, name: &str, )

Insert a custom component for an entity.

Games use this to attach their own typed data to simulation entities. Extension components must be Serialize + DeserializeOwned to support snapshot save/load. A name string is required for serialization roundtrips. Extension components are automatically cleaned up on despawn().

use elevator_core::world::World;
use serde::{Serialize, Deserialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
struct VipTag { level: u32 }

let mut world = World::new();
let entity = world.spawn();
world.insert_ext(entity, VipTag { level: 3 }, "vip_tag");

pub fn get_ext<T: 'static + Send + Sync + Clone>( &self, id: EntityId, ) -> Option<T>

Get a clone of a custom component for an entity.

pub fn get_ext_mut<T: 'static + Send + Sync>( &mut self, id: EntityId, ) -> Option<&mut T>

Get a mutable reference to a custom component for an entity.

pub fn remove_ext<T: 'static + Send + Sync>( &mut self, id: EntityId, ) -> Option<T>

Remove a custom component for an entity.

pub fn register_ext<T: 'static + Send + Sync + Serialize + DeserializeOwned>( &mut self, name: &str, )

Register an extension type for deserialization (creates empty storage).

Must be called before restore() for each extension type that was present in the original simulation.

pub fn disable(&mut self, id: EntityId)

Mark an entity as disabled. Disabled entities are skipped by all systems.

pub fn enable(&mut self, id: EntityId)

Re-enable a disabled entity.

pub fn is_disabled(&self, id: EntityId) -> bool

Check if an entity is disabled.

pub fn insert_resource<T: 'static + Send + Sync>(&mut self, value: T)

Insert a global resource. Replaces any existing resource of the same type.

Resources are singletons not attached to any entity. Games use them for event channels, score trackers, or any global state.

use elevator_core::world::World;
use elevator_core::events::EventChannel;

#[derive(Debug)]
enum MyEvent { Score(u32) }

let mut world = World::new();
world.insert_resource(EventChannel::<MyEvent>::new());

pub fn resource<T: 'static + Send + Sync>(&self) -> Option<&T>

Get a shared reference to a global resource.

pub fn resource_mut<T: 'static + Send + Sync>(&mut self) -> Option<&mut T>

Get a mutable reference to a global resource.

pub fn remove_resource<T: 'static + Send + Sync>(&mut self) -> Option<T>

Remove a global resource, returning it if it existed.

pub const fn query<Q: WorldQuery>(&self) -> QueryBuilder<'_, Q>

Create a query builder for iterating entities by component composition.

use elevator_core::prelude::*;

let mut sim = SimulationBuilder::demo().build().unwrap();
sim.spawn_rider_by_stop_id(StopId(0), StopId(1), 75.0).unwrap();

let world = sim.world();
for (id, rider, pos) in world.query::<(EntityId, &Rider, &Position)>().iter() {
    println!("{id:?}: {:?} at {}", rider.phase(), pos.value());
}

pub fn query_ext_mut<T: 'static + Send + Sync>(&mut self) -> ExtQueryMut<'_, T>

Create a mutable extension query builder.

Uses the keys-snapshot pattern: collects matching entity IDs upfront into an owned Vec, then iterates with mutable access via for_each_mut.

Example

world.query_ext_mut::<VipTag>().for_each_mut(|id, tag| {
    tag.level += 1;
});

Trait Implementations

impl Default for World

fn default() -> Self

Returns the “default value” for a type.