Struct RiderBuilder 

pub struct RiderBuilder<'a> { /* private fields */ }

Fluent builder for spawning riders with optional configuration.

Created via Simulation::build_rider.

use elevator_core::prelude::*;

let mut sim = SimulationBuilder::demo().build().unwrap();
let rider = sim.build_rider(StopId(0), StopId(1))
    .unwrap()
    .weight(80.0)
    .spawn()
    .unwrap();

Implementations

impl RiderBuilder<'_>

pub const fn weight(self, weight: f64) -> Self

Set the rider’s weight (default: 75.0).

pub const fn group(self, group: GroupId) -> Self

Set the dispatch group explicitly, skipping auto-detection.

pub fn route(self, route: Route) -> Self

Provide an explicit multi-leg route.

pub const fn patience(self, max_wait_ticks: u64) -> Self

Set maximum wait ticks before the rider abandons.

pub const fn preferences(self, prefs: Preferences) -> Self

Set boarding preferences.

pub fn access_control(self, ac: AccessControl) -> Self

Set per-rider access control (allowed stops).

pub fn spawn(self) -> Result<EntityId, SimError>

Spawn the rider with the configured options.

Errors

Returns SimError::NoRoute if no group serves both stops (when auto-detecting). Returns SimError::AmbiguousRoute if multiple groups serve both stops (when auto-detecting). Returns SimError::GroupNotFound if an explicit group does not exist. Returns SimError::RouteOriginMismatch if an explicit route’s first leg does not start at origin.