Enum BuiltinStrategy 

#[non_exhaustive]
pub enum BuiltinStrategy {
    Scan,
    Look,
    NearestCar,
    Etd,
    Destination,
    Rsr,
    LoopSweep,
    LoopSchedule,
    Custom(String),
}

Serializable identifier for built-in dispatch strategies.

Used in snapshots and config files to restore the correct strategy without requiring the game to manually re-wire dispatch. Custom strategies are represented by the Custom(String) variant.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Scan

SCAN (elevator) algorithm — sweeps end-to-end.

Look

LOOK algorithm — reverses at last request.

NearestCar

Nearest-car — assigns closest idle elevator.

Etd

Estimated Time to Destination — minimizes total cost.

Destination

Hall-call destination dispatch — sticky per-rider assignment.

Rsr

Relative System Response — additive composite of ETA, direction, car-call affinity, and load-share terms.

LoopSweep

Continuous-patrol sweep for LineKind::Loop groups. Loop cars never enter the Hungarian idle pool — the kickstart pass and door FSM handle routing — so this variant is a typed snapshot/config label rather than a ranking implementation. Available only when the loop_lines cargo feature is enabled.

LoopSchedule

Fixed-dwell timetable for LineKind::Loop groups. Overrides every Loop car in the group to a uniform per-stop dwell, producing a predictable schedule rather than rider-load-shaped variable dwell. Hold-recovery (extending dwell for cars arriving early relative to the preceding car in patrol order) is wired in a follow-up PR; the target_headway_ticks field is round-trip-stable in the meantime. Available only when the loop_lines cargo feature is enabled.

Custom(String)

Custom strategy identified by name. The game must provide a factory.

Implementations

impl BuiltinStrategy

pub fn instantiate(&self) -> Option<Box<dyn DispatchStrategy>>

Instantiate the dispatch strategy for this variant.

Returns None for Custom — the game must provide those via a factory function.

Trait Implementations

impl Clone for BuiltinStrategy

fn clone(&self) -> BuiltinStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuiltinStrategy

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BuiltinStrategy

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BuiltinStrategy

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

Formats the value using the given formatter.

impl PartialEq for BuiltinStrategy

fn eq(&self, other: &BuiltinStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BuiltinStrategy

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BuiltinStrategy

impl StructuralPartialEq for BuiltinStrategy