Struct SimEngine 

pub struct SimEngine<'a> {
    queue: &'a mut EventQueue,
    state: SimState,
    telemetry: &'a mut TelemetryAccumulator,
    handler: &'a mut dyn SpecHandler,
    sink: &'a mut TelemetrySink,
    encounter_end_ms: u32,
    pending_player_ready: Option<SimTime>,
}

Event loop for a single sim iteration; queue and handler are borrowed for reuse across iterations.

Fields

queue: &'a mut EventQueue

state: SimState

telemetry: &'a mut TelemetryAccumulator

handler: &'a mut dyn SpecHandler

sink: &'a mut TelemetrySink

encounter_end_ms: u32

pending_player_ready: Option<SimTime>

Implementations

impl<'a> SimEngine<'a>

pub fn new(state: SimState, refs: SimEngineRefs<'a>) -> Self

Construct an iteration engine over caller-owned reusable state; the caller clears the queue and resets the handler first.

pub fn run(&mut self) -> Result<()>

Execute one iteration to completion and record telemetry.

Errors

Returns an error if the event budget is exceeded or the spec handler fails.

pub fn capture_representative(&mut self) -> Result<()>

Deterministically rerun one selected iteration and install only its representative trace, leaving aggregates unchanged.

Errors

Returns an error if the event budget is exceeded or the spec handler fails.

fn run_with_mode(&mut self, mode: RunMode) -> Result<()>

fn push_player_ready(&mut self, t: SimTime)

fn handle_event(&mut self, event: Event, t: SimTime) -> Result<()>

fn handle_player_ready_event(&mut self, t: SimTime) -> Result<()>

fn handle_player_ready(&mut self, t: SimTime) -> Result<()>

fn dispatch( &mut self, f: impl FnOnce(&mut dyn SpecHandler, &mut SimContext<'_>), ) -> Result<()>

fn check_handler_error(&mut self) -> Result<()>

fn finalize(&mut self, completed_at: SimTime, mode: RunMode)

fn debug_assert_damage_telemetry_reconciled( &self, combat_total: f64, completed_at: SimTime, mode: RunMode, )

Trait Implementations

impl Debug for SimEngine<'_>

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

Formats the value using the given formatter.