aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2026-10-23 11:02:27 +0300
committerValentin Popov <valentin@popov.link>2026-10-23 11:02:27 +0300
commit7c909ea67ba7f27e11d5b33b8df9f6569da7eb7b (patch)
tree344ca595b3fcd34eb20671b65ad86146813d7873
parent83db371742ad3865bf4dc534ae38429c07a936d3 (diff)
downloadfparkan-7c909ea67ba7f27e11d5b33b8df9f6569da7eb7b.tar.xz
fparkan-7c909ea67ba7f27e11d5b33b8df9f6569da7eb7b.zip
feat(runtime): advance loaded mission resources
-rw-r--r--crates/fparkan-runtime/src/lib.rs1089
-rw-r--r--crates/fparkan-runtime/tests/behavior_distributor_tick_native_oracle.cs165
-rw-r--r--docs/appendices/knowledge-boundaries.md25
-rw-r--r--docs/appendices/script-vm.md91
-rw-r--r--docs/tomes/06-behavior.md44
5 files changed, 1369 insertions, 45 deletions
diff --git a/crates/fparkan-runtime/src/lib.rs b/crates/fparkan-runtime/src/lib.rs
index b4c13df..51b5180 100644
--- a/crates/fparkan-runtime/src/lib.rs
+++ b/crates/fparkan-runtime/src/lib.rs
@@ -134,9 +134,8 @@ pub struct BehaviorRegisteredObject {
pub class_flags: u32,
/// Native share field at record offset `+0x04`.
pub share: f32,
- /// Raw DWORDs at offsets `+0x08..+0x18`; the first controls whether
- /// normalization treats this record as fixed, and the remaining words are
- /// not yet assigned semantics. A normal native Add initializes all five to 0.
+ /// Raw DWORDs at offsets `+0x08..+0x18`: fixed-share flag, power demand,
+ /// power allocation, ore demand, and ore allocation. A native Add zeros them.
pub native_tail: [u32; 5],
}
@@ -457,19 +456,20 @@ pub struct MissionScriptBundle {
pub package: ScriptPackage,
/// Outcome of the restricted first-`Init` resolution for this bundle.
pub init_execution: MissionScriptInitExecution,
- /// Recovered per-AI Behavior state computed by a full mission startup.
+ /// Recovered per-AI Behavior scheduler and total state.
/// Static previews leave this empty because they do not run script startup.
pub behavior_warm_start: Option<BehaviorWarmStartState>,
}
-/// Initial Behavior distributor fields recovered from the original warm-start path.
+/// Behavior distributor clock and totals tracked from warm start through resource ticks.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct BehaviorWarmStartState {
- /// Queue-clock value copied to distributor offset `+0x10` when it is zero.
+ /// Native offset `+0x10`: startup queue time, later replaced by the last due tick time.
pub first_time_ms: u32,
- /// Initial scheduled time written to distributor offset `+0x14`.
+ /// Native offset `+0x14`: current deadline, rescheduled after each due tick.
pub next_deadline_ms: u32,
- /// Opaque distributor words at offsets `+0x30..=+0x40`, cleared on first start.
+ /// Native totals at offsets `+0x30..=+0x40`: zeroed at startup, then power
+ /// available, ore available, ore in buffer, power usage, and ore usage.
pub cleared_words: [u32; 5],
}
@@ -490,6 +490,35 @@ impl BehaviorWarmStartState {
}
}
+fn behavior_elapsed_seconds(elapsed_ms: u32) -> f32 {
+ // The exact integer product is rounded once to f32; scaling by 2^-33 is
+ // exact and matches native FILD / FMUL / FSTP under the measured control word.
+ ((u64::from(elapsed_ms) * 0x0083_126f) as f32) * f32::from_bits(0x2f00_0000)
+}
+
+fn schedule_behavior_distributor_tick(
+ state: &mut BehaviorWarmStartState,
+ queue_time_ms: u32,
+ rng_state: &mut u32,
+) -> Option<f32> {
+ if state.first_time_ms == 0 {
+ let initialized = BehaviorWarmStartState::start(queue_time_ms, rng_state);
+ state.first_time_ms = initialized.first_time_ms;
+ state.next_deadline_ms = initialized.next_deadline_ms;
+ state.cleared_words = [0; 5];
+ return None;
+ }
+ if state.next_deadline_ms != 0 && queue_time_ms <= state.next_deadline_ms {
+ return None;
+ }
+
+ let elapsed_ms = queue_time_ms.wrapping_sub(state.first_time_ms);
+ let next = BehaviorWarmStartState::start(queue_time_ms, rng_state);
+ state.first_time_ms = next.first_time_ms;
+ state.next_deadline_ms = next.next_deadline_ms;
+ Some(behavior_elapsed_seconds(elapsed_ms))
+}
+
/// Numeric script defaults selected for the mission's first script bundle.
///
/// GOG `ai.dll` first tries `<bundle-base>.var`, then falls back to the shared
@@ -833,6 +862,13 @@ pub enum EngineError {
/// Entry, field, or format diagnostic.
message: String,
},
+ /// A Behavior resource tick could not resolve a required runtime value.
+ BehaviorDistributorTick {
+ /// TMA clan whose distributor could not complete its tick.
+ clan_index: usize,
+ /// Unsupported query, property, or arithmetic detail.
+ message: String,
+ },
/// World error.
World(fparkan_world::WorldError),
/// Reference movement input or terrain query failed.
@@ -960,6 +996,10 @@ impl std::fmt::Display for EngineError {
entry,
message,
} => write!(f, "{path}:{entry}: Behavior profile failed: {message}"),
+ Self::BehaviorDistributorTick {
+ clan_index,
+ message,
+ } => write!(f, "Behavior resource tick for clan {clan_index}: {message}"),
Self::World(source) => write!(f, "{source}"),
Self::Movement(message) => write!(f, "reference movement: {message}"),
Self::RegistrationTeardown {
@@ -994,6 +1034,7 @@ impl std::error::Error for EngineError {
| Self::Movement(_)
| Self::PrototypeGraph { .. }
| Self::BehaviorProfile { .. }
+ | Self::BehaviorDistributorTick { .. }
| Self::RegistrationTeardown { .. } => None,
}
}
@@ -1880,6 +1921,100 @@ pub fn query_loaded_mission_behavior_resource(
}
}
+/// Runs due native Behavior resource-distributor ticks against the loaded mission.
+///
+/// `queue_time_ms` is an explicit sample from the original wrapping 32-bit
+/// queue clock. The method updates the distributor schedule, its five totals,
+/// per-object row values, CurrentOre, and supported Control selector-1 state
+/// atomically. Preview missions and loaded missions without visible Behavior
+/// bundles have no due distributors and return `Ok(0)`. Otherwise it returns
+/// the number of distributors whose schedule was due; this includes a due
+/// tick with zero elapsed time, which leaves resource rows unchanged.
+///
+/// # Errors
+/// Returns an error when a live registered object reaches an unsupported
+/// Behavior profile, Control query, or property state. On error, all
+/// schedules, RNG state, totals, rows, ore values, and Control values remain
+/// unchanged.
+pub fn advance_loaded_mission_resources(
+ engine: &mut Engine,
+ queue_time_ms: u32,
+) -> Result<usize, EngineError> {
+ let Some(loaded) = engine.loaded.as_ref() else {
+ return Ok(0);
+ };
+
+ let mut distributors = loaded.behavior_distributors.clone();
+ let mut ore_states = loaded.behavior_ore_states.clone();
+ let mut control_tables = loaded.control_device_tables.clone();
+ let mut warm_starts = loaded
+ .script_bundles
+ .iter()
+ .map(|bundle| bundle.behavior_warm_start)
+ .collect::<Vec<_>>();
+ let profiles = &loaded.behavior_profiles;
+ let world = &engine.world;
+ let mut rng_state = engine.behavior_rng_state;
+ let mut scheduled_ticks = 0;
+
+ for distributor in distributors.iter_mut() {
+ if !distributor.super_ai_visible {
+ continue;
+ }
+ let bundle_index = loaded
+ .script_bundles
+ .iter()
+ .position(|bundle| bundle.clan_index == distributor.clan_index)
+ .ok_or_else(|| EngineError::BehaviorDistributorTick {
+ clan_index: distributor.clan_index,
+ message: "visible distributor has no matching script bundle".to_string(),
+ })?;
+ let Some(schedule) = warm_starts.get_mut(bundle_index).and_then(Option::as_mut) else {
+ return Err(EngineError::BehaviorDistributorTick {
+ clan_index: distributor.clan_index,
+ message: "visible distributor has no warm-start schedule".to_string(),
+ });
+ };
+
+ let delta_seconds =
+ schedule_behavior_distributor_tick(schedule, queue_time_ms, &mut rng_state);
+ let Some(delta_seconds) = delta_seconds else {
+ continue;
+ };
+ scheduled_ticks += 1;
+ if delta_seconds == 0.0 {
+ continue;
+ }
+
+ let totals = advance_behavior_distributor_tick(
+ distributor,
+ delta_seconds,
+ world,
+ &mut ore_states,
+ profiles,
+ &mut control_tables,
+ )
+ .map_err(|message| EngineError::BehaviorDistributorTick {
+ clan_index: distributor.clan_index,
+ message,
+ })?;
+ schedule.cleared_words = totals;
+ }
+
+ let loaded = engine
+ .loaded
+ .as_mut()
+ .expect("loaded mission was checked above");
+ loaded.behavior_distributors = distributors;
+ loaded.behavior_ore_states = ore_states;
+ loaded.control_device_tables = control_tables;
+ for (bundle, warm_start) in loaded.script_bundles.iter_mut().zip(warm_starts) {
+ bundle.behavior_warm_start = warm_start;
+ }
+ engine.behavior_rng_state = rng_state;
+ Ok(scheduled_ticks)
+}
+
/// Sets native Control global-table selector 1 on rows whose selector-0 value
/// is positive. Validation is completed before any row is changed.
///
@@ -2059,6 +2194,387 @@ fn query_behavior_profile_ore_rate(
)
}
+#[derive(Clone, Copy, Default)]
+struct BehaviorTickTotals {
+ power_available: f32,
+ ore_available: f32,
+ power_weighted_demand: f32,
+ power_demand: f32,
+ ore_weighted_demand: f32,
+ ore_demand: f32,
+ ore_in_buffer: f32,
+}
+
+#[derive(Clone, Copy, Default)]
+struct BehaviorAllocation {
+ priority: f32,
+ residual: f32,
+ consumption: f32,
+}
+
+fn behavior_difference(lhs: f32, rhs: f32, field: &'static str) -> Result<f32, String> {
+ let range_probe = f64::from(lhs) - f64::from(rhs);
+ check_control_range_probe(None, field, range_probe).map_err(|error| format!("{error:?}"))?;
+ checked_control_float(0, field, lhs - rhs).map_err(|error| format!("{error:?}"))
+}
+
+fn behavior_product(lhs: f32, rhs: f32, field: &'static str) -> Result<f32, String> {
+ checked_control_product(0, field, lhs, rhs).map_err(|error| format!("{error:?}"))
+}
+
+fn behavior_allocation(
+ available: f32,
+ demand: f32,
+ weighted_demand: f32,
+) -> Result<BehaviorAllocation, String> {
+ if available <= 0.0 || demand <= 0.0 {
+ Ok(BehaviorAllocation::default())
+ } else if available <= weighted_demand {
+ Ok(BehaviorAllocation {
+ priority: checked_control_ratio("priority allocation", available, weighted_demand)
+ .map_err(|error| format!("{error:?}"))?,
+ residual: 0.0,
+ consumption: 1.0,
+ })
+ } else if available < demand {
+ let residual_available =
+ behavior_difference(available, weighted_demand, "residual available")?;
+ let residual_demand = behavior_difference(demand, weighted_demand, "residual demand")?;
+ Ok(BehaviorAllocation {
+ priority: 1.0,
+ residual: checked_control_ratio(
+ "residual allocation",
+ residual_available,
+ residual_demand,
+ )
+ .map_err(|error| format!("{error:?}"))?,
+ consumption: 1.0,
+ })
+ } else {
+ Ok(BehaviorAllocation {
+ priority: 1.0,
+ residual: 1.0,
+ consumption: checked_control_ratio("source consumption", demand, available)
+ .map_err(|error| format!("{error:?}"))?,
+ })
+ }
+}
+
+fn behavior_add_total(total: &mut f32, value: f32, field: &'static str) -> Result<(), String> {
+ *total = checked_control_sum(0, field, *total, value).map_err(|error| format!("{error:?}"))?;
+ Ok(())
+}
+
+fn behavior_profile_for_handle<'a>(
+ profiles: &'a [BehaviorProfileState],
+ handle: ObjectHandle,
+) -> Result<&'a BehaviorProfileState, String> {
+ profiles
+ .iter()
+ .find(|profile| profile.handle == handle)
+ .ok_or_else(|| format!("Behavior profile for object {handle:?} is unavailable"))
+}
+
+fn behavior_ore_index_for_handle(
+ ore_states: &[BehaviorOreState],
+ handle: ObjectHandle,
+) -> Result<usize, String> {
+ ore_states
+ .iter()
+ .position(|state| state.handle == handle)
+ .ok_or_else(|| format!("CurrentOre property for object {handle:?} is unavailable"))
+}
+
+fn behavior_control_index_for_handle(
+ control_tables: &[MissionControlDeviceTableState],
+ handle: ObjectHandle,
+) -> Result<usize, String> {
+ let index = control_tables
+ .iter()
+ .position(|table| table.handle == handle)
+ .ok_or_else(|| format!("Control interface for object {handle:?} is unavailable"))?;
+ match &control_tables[index].status {
+ MissionControlDeviceTableStatus::Available(_) => Ok(index),
+ MissionControlDeviceTableStatus::Unavailable(reason) => Err(format!(
+ "Control interface for object {handle:?} is unresolved: {reason:?}"
+ )),
+ }
+}
+
+fn behavior_checked_property(state: &BehaviorOreState, maximum: bool) -> Result<f32, String> {
+ let (field, bits) = if maximum {
+ ("MaximumOre", state.maximum_ore_bits)
+ } else {
+ ("CurrentOre", state.current_ore_bits)
+ };
+ checked_control_float(state.class_flags, field, f32::from_bits(bits))
+ .map_err(|error| format!("{error:?}"))
+}
+
+fn behavior_tick_resource_rate(
+ class_flags: u32,
+ handle: ObjectHandle,
+ selector: u32,
+ profiles: &[BehaviorProfileState],
+ control_tables: &[MissionControlDeviceTableState],
+) -> Result<f32, String> {
+ let profile = behavior_profile_for_handle(profiles, handle)?;
+ match selector {
+ 0x1005 => checked_control_float(
+ class_flags,
+ "Transfer_Power_Out",
+ f32::from_bits(profile.transfer_power_out_bits),
+ )
+ .map_err(|error| format!("{error:?}")),
+ 0x1002 => {
+ let table_index = behavior_control_index_for_handle(control_tables, handle)?;
+ query_behavior_profile_ore_rate(
+ &control_tables[table_index],
+ profile.transfer_ore_off_board_bits,
+ )
+ .map_err(|error| format!("{error:?}"))
+ }
+ _ => Err(format!(
+ "unsupported Behavior resource selector {selector:#x}"
+ )),
+ }
+}
+
+fn behavior_query_control(
+ control_tables: &[MissionControlDeviceTableState],
+ handle: ObjectHandle,
+ selector: u32,
+) -> Result<f32, String> {
+ let table_index = behavior_control_index_for_handle(control_tables, handle)?;
+ query_control_device_table_resource(&control_tables[table_index], selector)
+ .map(|value| value.unwrap_or(0.0))
+ .map_err(|error| format!("{error:?}"))
+}
+
+fn advance_behavior_distributor_tick(
+ distributor: &mut BehaviorDistributorState,
+ delta_seconds: f32,
+ world: &World,
+ ore_states: &mut [BehaviorOreState],
+ profiles: &[BehaviorProfileState],
+ control_tables: &mut [MissionControlDeviceTableState],
+) -> Result<[u32; 5], String> {
+ let mut totals = BehaviorTickTotals::default();
+
+ // Native pass one measures supply and demand, then records per-row demand.
+ for object in &mut distributor.registered_objects {
+ let Some(live_handle) = handle_by_original_id(world, object.original_id) else {
+ object.native_tail[1] = 0;
+ object.native_tail[3] = 0;
+ continue;
+ };
+ if live_handle != object.handle {
+ return Err(format!(
+ "live original object {} maps to {live_handle:?}, expected {:?}",
+ object.original_id.0, object.handle
+ ));
+ }
+ let share = checked_control_float(object.class_flags, "Behavior share", object.share)
+ .map_err(|error| format!("{error:?}"))?;
+
+ let power_source = matches!(
+ object.class_flags,
+ 0x8000_0002 | 0x8001_0000 | 0x8002_0000 | 0x8004_0000
+ );
+ let power_demand = if power_source {
+ let rate = behavior_tick_resource_rate(
+ object.class_flags,
+ live_handle,
+ 0x1005,
+ profiles,
+ control_tables,
+ )?;
+ let production = behavior_product(delta_seconds, rate, "power production")?;
+ behavior_add_total(&mut totals.power_available, production, "power available")?;
+ 0.0
+ } else {
+ let total_power = behavior_query_control(control_tables, live_handle, 2)?;
+ let power_ratio = behavior_query_control(control_tables, live_handle, 1)?;
+ if total_power > 0.0 {
+ let used_power = behavior_product(power_ratio, total_power, "used power")?;
+ behavior_difference(total_power, used_power, "power demand")?
+ } else {
+ 0.0
+ }
+ };
+ object.native_tail[1] = power_demand.to_bits();
+ behavior_add_total(&mut totals.power_demand, power_demand, "power demand")?;
+ behavior_add_total(
+ &mut totals.power_weighted_demand,
+ behavior_product(power_demand, share, "weighted power demand")?,
+ "weighted power demand",
+ )?;
+
+ let ore_source = matches!(object.class_flags, 0x8000_0004 | 0x8000_0008);
+ let ore_index = behavior_ore_index_for_handle(ore_states, live_handle)?;
+ let current = behavior_checked_property(&ore_states[ore_index], false)?;
+ let ore_demand = if ore_source {
+ let rate = behavior_tick_resource_rate(
+ object.class_flags,
+ live_handle,
+ 0x1002,
+ profiles,
+ control_tables,
+ )?;
+ let production = behavior_product(delta_seconds, rate, "ore production")?;
+ let available = if current < production {
+ current
+ } else {
+ production
+ };
+ behavior_add_total(&mut totals.ore_available, available, "ore available")?;
+ behavior_add_total(&mut totals.ore_in_buffer, current, "ore in buffer")?;
+ 0.0
+ } else {
+ let maximum = behavior_checked_property(&ore_states[ore_index], true)?;
+ let deficit = behavior_difference(maximum, current, "ore deficit")?;
+ if deficit >= f32::from_bits(0x3c23_d70a) {
+ deficit
+ } else {
+ ore_states[ore_index].current_ore_bits = maximum.to_bits();
+ 0.0
+ }
+ };
+ object.native_tail[3] = ore_demand.to_bits();
+ behavior_add_total(&mut totals.ore_demand, ore_demand, "ore demand")?;
+ behavior_add_total(
+ &mut totals.ore_weighted_demand,
+ behavior_product(ore_demand, share, "weighted ore demand")?,
+ "weighted ore demand",
+ )?;
+ }
+
+ let power_allocation = behavior_allocation(
+ totals.power_available,
+ totals.power_demand,
+ totals.power_weighted_demand,
+ )?;
+ let ore_allocation = behavior_allocation(
+ totals.ore_available,
+ totals.ore_demand,
+ totals.ore_weighted_demand,
+ )?;
+
+ // Native pass two re-reads callbacks before applying each row in order.
+ for object in &mut distributor.registered_objects {
+ let Some(live_handle) = handle_by_original_id(world, object.original_id) else {
+ object.native_tail[2] = 0;
+ object.native_tail[4] = 0;
+ continue;
+ };
+ if live_handle != object.handle {
+ return Err(format!(
+ "live original object {} maps to {live_handle:?}, expected {:?}",
+ object.original_id.0, object.handle
+ ));
+ }
+ object.native_tail[2] = 0;
+ object.native_tail[4] = 0;
+
+ let power_source = matches!(
+ object.class_flags,
+ 0x8000_0002 | 0x8001_0000 | 0x8002_0000 | 0x8004_0000
+ );
+ if power_source {
+ let table_index = behavior_control_index_for_handle(control_tables, live_handle)?;
+ set_control_device_table_multiplier(&mut control_tables[table_index], 1.0)
+ .map_err(|error| format!("{error:?}"))?;
+ } else {
+ let table_index = behavior_control_index_for_handle(control_tables, live_handle)?;
+ let total_power = behavior_query_control(control_tables, live_handle, 2)?;
+ if total_power > 0.0 {
+ let power_ratio = behavior_query_control(control_tables, live_handle, 1)?;
+ let used_power = behavior_product(power_ratio, total_power, "used power")?;
+ let demand = behavior_difference(total_power, used_power, "power demand")?;
+ let share = object.share;
+ let priority_share =
+ behavior_product(share, power_allocation.priority, "priority power share")?;
+ let residual_share = behavior_product(
+ behavior_difference(1.0, share, "remaining share")?,
+ power_allocation.residual,
+ "residual power share",
+ )?;
+ let fraction = checked_control_sum(
+ 0,
+ "power allocation fraction",
+ residual_share,
+ priority_share,
+ )
+ .map_err(|error| format!("{error:?}"))?;
+ let allocated = behavior_product(demand, fraction, "power allocation")?;
+ let updated =
+ checked_control_sum(0, "used plus allocated power", used_power, allocated)
+ .map_err(|error| format!("{error:?}"))?;
+ let new_ratio =
+ checked_control_ratio("new Control selector 1", updated, total_power)
+ .map_err(|error| format!("{error:?}"))?;
+ set_control_device_table_multiplier(&mut control_tables[table_index], new_ratio)
+ .map_err(|error| format!("{error:?}"))?;
+ object.native_tail[2] = allocated.to_bits();
+ }
+ }
+
+ let ore_source = matches!(object.class_flags, 0x8000_0004 | 0x8000_0008);
+ let ore_index = behavior_ore_index_for_handle(ore_states, live_handle)?;
+ let current = behavior_checked_property(&ore_states[ore_index], false)?;
+ if ore_source {
+ let rate = behavior_tick_resource_rate(
+ object.class_flags,
+ live_handle,
+ 0x1002,
+ profiles,
+ control_tables,
+ )?;
+ let production = behavior_product(delta_seconds, rate, "ore withdrawal rate")?;
+ let bounded_production = if current < production {
+ current
+ } else {
+ production
+ };
+ let taken = behavior_product(
+ bounded_production,
+ ore_allocation.consumption,
+ "ore withdrawal",
+ )?;
+ ore_states[ore_index].current_ore_bits =
+ behavior_difference(current, taken, "remaining ore")?.to_bits();
+ } else {
+ let maximum = behavior_checked_property(&ore_states[ore_index], true)?;
+ let capacity = behavior_difference(maximum, current, "ore capacity")?;
+ let share = object.share;
+ let priority_share =
+ behavior_product(share, ore_allocation.priority, "priority ore share")?;
+ let residual_share = behavior_product(
+ behavior_difference(1.0, share, "remaining share")?,
+ ore_allocation.residual,
+ "residual ore share",
+ )?;
+ let fraction =
+ checked_control_sum(0, "ore allocation fraction", residual_share, priority_share)
+ .map_err(|error| format!("{error:?}"))?;
+ let allocated = behavior_product(capacity, fraction, "ore allocation")?;
+ ore_states[ore_index].current_ore_bits =
+ checked_control_sum(0, "current plus allocated ore", current, allocated)
+ .map_err(|error| format!("{error:?}"))?
+ .to_bits();
+ object.native_tail[4] = allocated.to_bits();
+ }
+ }
+
+ Ok([
+ totals.power_available.to_bits(),
+ totals.ore_available.to_bits(),
+ totals.ore_in_buffer.to_bits(),
+ totals.power_demand.to_bits(),
+ totals.ore_demand.to_bits(),
+ ])
+}
+
fn set_control_device_table_multiplier(
table: &mut MissionControlDeviceTableState,
value: f32,
@@ -4272,6 +4788,79 @@ mod tests {
}
#[test]
+ fn behavior_elapsed_seconds_preserve_native_qword_conversion_rounding() {
+ let vectors = [
+ (1, 0x3a83_126f),
+ (1_001, 0x3f80_20c5),
+ (16_777_217, 0x4683_1270),
+ (16_777_219, 0x4683_1271),
+ (u32::MAX, 0x4a83_126f),
+ (u32::MAX - 1, 0x4a83_126f),
+ ];
+ for (elapsed_ms, expected_bits) in vectors {
+ assert_eq!(
+ behavior_elapsed_seconds(elapsed_ms).to_bits(),
+ expected_bits,
+ "elapsed={elapsed_ms}"
+ );
+ }
+ }
+
+ #[test]
+ fn behavior_distributor_scheduler_requires_a_strictly_later_unsigned_time() {
+ let original = BehaviorWarmStartState {
+ first_time_ms: 100,
+ next_deadline_ms: 200,
+ cleared_words: [0x11; 5],
+ };
+ let mut state = original;
+ let mut rng_state = 1;
+
+ assert_eq!(
+ schedule_behavior_distributor_tick(&mut state, 200, &mut rng_state),
+ None
+ );
+ assert_eq!(state, original);
+ assert_eq!(rng_state, 1);
+
+ let elapsed = schedule_behavior_distributor_tick(&mut state, 201, &mut rng_state)
+ .expect("deadline is passed");
+ assert_eq!(elapsed.to_bits(), behavior_elapsed_seconds(101).to_bits());
+ assert_eq!(state.first_time_ms, 201);
+ assert_eq!(state.next_deadline_ms, 403);
+ assert_eq!(state.cleared_words, [0x11; 5]);
+ assert_eq!(rng_state, 0x0029_e2c0);
+ }
+
+ #[test]
+ fn behavior_distributor_scheduler_wraps_elapsed_but_keeps_unsigned_deadline_order() {
+ let mut state = BehaviorWarmStartState {
+ first_time_ms: u32::MAX - 15,
+ next_deadline_ms: 5,
+ cleared_words: [0; 5],
+ };
+ let mut rng_state = 1;
+
+ assert_eq!(
+ schedule_behavior_distributor_tick(&mut state, 5, &mut rng_state),
+ None
+ );
+ assert_eq!(state.next_deadline_ms, 5);
+ let elapsed = schedule_behavior_distributor_tick(&mut state, 6, &mut rng_state)
+ .expect("current time is unsigned-greater than deadline");
+ assert_eq!(elapsed.to_bits(), behavior_elapsed_seconds(22).to_bits());
+ assert_eq!(state.first_time_ms, 6);
+
+ let before = state;
+ assert_eq!(
+ schedule_behavior_distributor_tick(&mut state, 1, &mut rng_state),
+ None,
+ "unsigned 1 is not strictly later than the current deadline"
+ );
+ assert_eq!(state, before);
+ }
+
+ #[test]
fn mission_script_start_stops_before_warming_later_bundles() {
fn push_u32(bytes: &mut Vec<u8>, value: u32) {
bytes.extend_from_slice(&value.to_le_bytes());
@@ -5837,6 +6426,259 @@ mod tests {
);
}
+ #[test]
+ #[ignore = "requires licensed corpus"]
+ fn licensed_autodemo_resource_ticks_use_queue_time_and_real_generator_profile() {
+ let root = licensed_root("IS");
+ let vfs: Arc<dyn Vfs> = Arc::new(DirectoryVfs::new(root));
+ let mut engine = create(EngineServices::new(vfs)).expect("engine");
+ load_mission(
+ &mut engine,
+ MissionRequest {
+ key: "MISSIONS/Autodemo.00/data.tma".to_string(),
+ mode: MissionMode::AutoDemo,
+ },
+ 100_000,
+ )
+ .expect("load licensed AutoDemo");
+
+ let deadlines = loaded_mission_script_bundles(&engine)
+ .expect("script bundles")
+ .iter()
+ .map(|bundle| {
+ (
+ bundle.clan_index,
+ bundle
+ .behavior_warm_start
+ .expect("full load warm-start")
+ .next_deadline_ms,
+ )
+ })
+ .collect::<Vec<_>>();
+ assert_eq!(deadlines, [(0, 100_202), (1, 100_200)]);
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 100_000)
+ .expect("no due resource tick at warm start"),
+ 0
+ );
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 100_200)
+ .expect("strict deadline equality is not due"),
+ 0
+ );
+
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 100_201).expect("clan 1 resource tick"),
+ 1
+ );
+ let first_totals = loaded_mission_script_bundles(&engine)
+ .expect("bundles after first tick")
+ .iter()
+ .find(|bundle| bundle.clan_index == 1)
+ .and_then(|bundle| bundle.behavior_warm_start)
+ .expect("clan 1 scheduler")
+ .cleared_words;
+ assert!(
+ f32::from_bits(first_totals[0]) > 0.0,
+ "clan 1's real prof_generator.var contributes power"
+ );
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 100_202)
+ .expect("clan 0 deadline equality is not due"),
+ 0
+ );
+
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 100_203).expect("clan 0 resource tick"),
+ 1
+ );
+ let second_totals = loaded_mission_script_bundles(&engine)
+ .expect("bundles after second tick")
+ .iter()
+ .find(|bundle| bundle.clan_index == 0)
+ .and_then(|bundle| bundle.behavior_warm_start)
+ .expect("clan 0 scheduler")
+ .cleared_words;
+ assert!(
+ f32::from_bits(second_totals[0]) > 0.0,
+ "clan 0's real prof_generator.var contributes power"
+ );
+
+ let first_tick_time = 100_500;
+ let deadlines = loaded_mission_script_bundles(&engine)
+ .expect("bundles after one tick per clan")
+ .iter()
+ .map(|bundle| {
+ bundle
+ .behavior_warm_start
+ .expect("full load warm-start")
+ .next_deadline_ms
+ })
+ .collect::<Vec<_>>();
+ assert!(deadlines.iter().all(|deadline| *deadline < first_tick_time));
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, first_tick_time)
+ .expect("second resource tick for each clan"),
+ 2
+ );
+ let totals_at_100500 = loaded_mission_script_bundles(&engine)
+ .expect("bundles at 100500")
+ .iter()
+ .map(|bundle| {
+ (
+ bundle.clan_index,
+ bundle.behavior_warm_start.expect("full load warm-start"),
+ )
+ })
+ .collect::<Vec<_>>();
+ for (clan, warm_start) in &totals_at_100500 {
+ assert_eq!(warm_start.first_time_ms, first_tick_time);
+ let elapsed = if *clan == 0 { 297 } else { 299 };
+ assert_eq!(
+ warm_start.cleared_words[0],
+ (behavior_elapsed_seconds(elapsed) * 10.0).to_bits(),
+ "clan {clan} recomputes power availability from the elapsed interval"
+ );
+ }
+
+ assert_eq!(
+ advance_loaded_mission_resources(&mut engine, 101_000)
+ .expect("third resource tick for each clan"),
+ 2
+ );
+ let totals_at_101000 = loaded_mission_script_bundles(&engine)
+ .expect("bundles at 101000")
+ .iter()
+ .map(|bundle| {
+ (
+ bundle.clan_index,
+ bundle.behavior_warm_start.expect("full load warm-start"),
+ )
+ })
+ .collect::<Vec<_>>();
+ for (clan, warm_start) in &totals_at_101000 {
+ assert_eq!(warm_start.first_time_ms, 101_000);
+ assert_eq!(
+ warm_start.cleared_words[0],
+ 5.0_f32.to_bits(),
+ "clan {clan} replaces totals with the latest interval"
+ );
+ let previous = totals_at_100500
+ .iter()
+ .find(|(previous_clan, _)| previous_clan == clan)
+ .expect("same clan totals at previous tick")
+ .1;
+ assert_ne!(warm_start.cleared_words[0], previous.cleared_words[0]);
+ }
+
+ assert!(loaded_mission_behavior_profiles(&engine)
+ .expect("loaded profiles")
+ .iter()
+ .filter(|profile| profile.class_flags == 0x8000_0002)
+ .all(|profile| profile.transfer_power_out_bits == 10.0_f32.to_bits()));
+
+ for clan in [0, 1] {
+ let distributor = loaded_mission_behavior_distributors(&engine)
+ .expect("loaded distributors")
+ .iter()
+ .find(|distributor| distributor.clan_index == clan)
+ .expect("loaded clan distributor");
+ assert_eq!(distributor.registered_objects.len(), 2);
+ let generator = loaded_mission_behavior_distributors(&engine)
+ .expect("loaded distributors")
+ .iter()
+ .find(|distributor| distributor.clan_index == clan)
+ .and_then(|distributor| {
+ distributor
+ .registered_objects
+ .iter()
+ .find(|object| object.class_flags == 0x8000_0002)
+ })
+ .expect("licensed AutoDemo generator row");
+ let profile = loaded_mission_behavior_profiles(&engine)
+ .expect("loaded Behavior profiles")
+ .iter()
+ .find(|profile| profile.handle == generator.handle)
+ .expect("generator profile");
+ let totals = totals_at_101000
+ .iter()
+ .find(|(candidate, _)| *candidate == clan)
+ .expect("generator clan totals")
+ .1
+ .cleared_words;
+ println!(
+ "licensed AutoDemo Behavior tick: clan={clan} ObjectId={} profile={} Transfer_Power_Out={} PowerAvailable={} at queue times 100201/100203,100500,101000; registered rows={}",
+ generator.original_id.0,
+ profile.profile_entry.as_deref().unwrap_or("<defaults>"),
+ f32::from_bits(profile.transfer_power_out_bits),
+ f32::from_bits(totals[0]),
+ distributor.registered_objects.len(),
+ );
+ }
+
+ let second_plant = {
+ let loaded = engine.loaded.as_mut().expect("loaded mission state");
+ let second = loaded
+ .behavior_distributors
+ .iter()
+ .find(|distributor| distributor.clan_index == 1)
+ .expect("clan 1 distributor");
+ let plant = second
+ .registered_objects
+ .iter()
+ .find(|object| object.class_flags == 0x8000_0010)
+ .expect("clan 1 plant")
+ .clone();
+ loaded
+ .control_device_tables
+ .retain(|table| table.handle != plant.handle);
+ plant
+ };
+ assert_eq!(second_plant.class_flags, 0x8000_0010);
+ let before_distributors = loaded_mission_behavior_distributors(&engine)
+ .expect("rollback distributor snapshot")
+ .to_vec();
+ let before_ore_states = loaded_mission_behavior_ore_states(&engine)
+ .expect("rollback ore snapshot")
+ .to_vec();
+ let before_controls = loaded_mission_control_device_tables(&engine)
+ .expect("rollback Control snapshot")
+ .to_vec();
+ let before_warm_starts = loaded_mission_script_bundles(&engine)
+ .expect("rollback bundles")
+ .iter()
+ .map(|bundle| bundle.behavior_warm_start)
+ .collect::<Vec<_>>();
+ let before_rng = engine.behavior_rng_state;
+ let error = advance_loaded_mission_resources(&mut engine, 102_000)
+ .expect_err("missing clan 1 plant Control table fails after clan 0 stages a tick");
+ assert!(matches!(
+ error,
+ EngineError::BehaviorDistributorTick { clan_index: 1, .. }
+ ));
+ assert_eq!(
+ loaded_mission_behavior_distributors(&engine),
+ Some(before_distributors.as_slice())
+ );
+ assert_eq!(
+ loaded_mission_behavior_ore_states(&engine),
+ Some(before_ore_states.as_slice())
+ );
+ assert_eq!(
+ loaded_mission_control_device_tables(&engine),
+ Some(before_controls.as_slice())
+ );
+ assert_eq!(
+ loaded_mission_script_bundles(&engine)
+ .expect("bundles after failed transaction")
+ .iter()
+ .map(|bundle| bundle.behavior_warm_start)
+ .collect::<Vec<_>>(),
+ before_warm_starts
+ );
+ assert_eq!(engine.behavior_rng_state, before_rng);
+ }
+
fn behavior_test_object(
slot: u32,
share: f32,
@@ -6075,6 +6917,237 @@ mod tests {
}
#[test]
+ fn behavior_allocation_matches_shortage_middle_surplus_and_equality_branches() {
+ let shortage = behavior_allocation(1.0, 6.0, 3.0).expect("shortage allocation");
+ assert_eq!(shortage.priority.to_bits(), 0x3eaa_aaab);
+ assert_eq!(shortage.residual.to_bits(), 0);
+ assert_eq!(shortage.consumption.to_bits(), 1.0_f32.to_bits());
+
+ let middle = behavior_allocation(0.25, 0.375, 0.1875).expect("middle allocation");
+ assert_eq!(middle.priority.to_bits(), 1.0_f32.to_bits());
+ assert_eq!(middle.residual.to_bits(), 0x3eaa_aaab);
+ assert_eq!(middle.consumption.to_bits(), 1.0_f32.to_bits());
+
+ let surplus = behavior_allocation(2.0, 0.375, 0.1875).expect("surplus allocation");
+ assert_eq!(surplus.priority.to_bits(), 1.0_f32.to_bits());
+ assert_eq!(surplus.residual.to_bits(), 1.0_f32.to_bits());
+ assert_eq!(surplus.consumption.to_bits(), 0x3e40_0000);
+
+ let exact = behavior_allocation(0.375, 0.375, 0.1875).expect("exact allocation");
+ assert_eq!(exact.priority.to_bits(), 1.0_f32.to_bits());
+ assert_eq!(exact.residual.to_bits(), 1.0_f32.to_bits());
+ assert_eq!(exact.consumption.to_bits(), 1.0_f32.to_bits());
+ }
+
+ fn behavior_tick_test_object(
+ world: &mut World,
+ original_id: u32,
+ class_flags: u32,
+ share: f32,
+ ) -> BehaviorRegisteredObject {
+ let original_id = OriginalObjectId(original_id);
+ let handle = construct_object(
+ world,
+ ObjectDraft {
+ original_id: Some(original_id),
+ },
+ )
+ .expect("construct Behavior tick object");
+ register_object(world, handle).expect("register Behavior tick object");
+ BehaviorRegisteredObject {
+ original_id,
+ handle,
+ selector: 0,
+ class_flags,
+ share,
+ native_tail: [0; 5],
+ }
+ }
+
+ fn behavior_tick_test_control_table(
+ original_id: u32,
+ handle: ObjectHandle,
+ ) -> MissionControlDeviceTableState {
+ let device = synthetic_effective_control_device(
+ 19,
+ 19,
+ 0.75_f32.to_bits(),
+ Some(0.5_f32.to_bits()),
+ None,
+ );
+ MissionControlDeviceTableState {
+ original_id: Some(OriginalObjectId(original_id)),
+ handle,
+ status: MissionControlDeviceTableStatus::Available(vec![device]),
+ node_provider_status: MissionControlNodeProviderTableStatus::Available(Vec::new()),
+ }
+ }
+
+ #[test]
+ fn behavior_power_source_also_contributes_ore_demand() {
+ let mut world = new_world(WorldConfig);
+ let producer = behavior_tick_test_object(&mut world, 1, 0x8000_0002, 0.5);
+ let recipient = behavior_tick_test_object(&mut world, 2, 0x8000_0001, 0.5);
+ let mut distributor = BehaviorDistributorState {
+ clan_index: 0,
+ super_ai_visible: true,
+ registered_objects: vec![producer.clone(), recipient.clone()],
+ };
+ let mut ore_states = [producer.clone(), recipient.clone()]
+ .into_iter()
+ .map(|object| BehaviorOreState {
+ original_id: object.original_id,
+ handle: object.handle,
+ class_flags: object.class_flags,
+ current_ore_bits: 1.0_f32.to_bits(),
+ maximum_ore_bits: 10.0_f32.to_bits(),
+ })
+ .collect::<Vec<_>>();
+ let profiles = [BehaviorProfileState {
+ original_id: OriginalObjectId(1),
+ handle: producer.handle,
+ class_flags: producer.class_flags,
+ profile_entry: None,
+ transfer_ore_off_board_bits: 0x40a0_0000,
+ transfer_power_out_bits: 4.0_f32.to_bits(),
+ }];
+ let mut control_tables = vec![
+ behavior_tick_test_control_table(1, producer.handle),
+ behavior_tick_test_control_table(2, recipient.handle),
+ ];
+
+ let totals = advance_behavior_distributor_tick(
+ &mut distributor,
+ 1.0,
+ &world,
+ &mut ore_states,
+ &profiles,
+ &mut control_tables,
+ )
+ .expect("tick supported power source and generic receiver");
+
+ assert_eq!(
+ totals[4],
+ 18.0_f32.to_bits(),
+ "both native classes compute the non-source ore demand"
+ );
+ }
+
+ #[test]
+ fn behavior_ore_source_also_contributes_power_demand() {
+ let mut world = new_world(WorldConfig);
+ let producer = behavior_tick_test_object(&mut world, 3, 0x8000_0004, 1.0);
+ let mut distributor = BehaviorDistributorState {
+ clan_index: 0,
+ super_ai_visible: true,
+ registered_objects: vec![producer.clone()],
+ };
+ let mut ore_states = [producer.clone()]
+ .into_iter()
+ .map(|object| BehaviorOreState {
+ original_id: object.original_id,
+ handle: object.handle,
+ class_flags: object.class_flags,
+ current_ore_bits: 0.25_f32.to_bits(),
+ maximum_ore_bits: 10.0_f32.to_bits(),
+ })
+ .collect::<Vec<_>>();
+ let profiles = [BehaviorProfileState {
+ original_id: OriginalObjectId(3),
+ handle: producer.handle,
+ class_flags: producer.class_flags,
+ profile_entry: None,
+ transfer_ore_off_board_bits: 4.0_f32.to_bits(),
+ transfer_power_out_bits: 0.0_f32.to_bits(),
+ }];
+ let mut ore_device = synthetic_effective_control_device(
+ 26,
+ 26,
+ 1.0_f32.to_bits(),
+ Some(1.0_f32.to_bits()),
+ None,
+ );
+ ore_device.key = 0;
+ let producer_table = MissionControlDeviceTableState {
+ original_id: Some(OriginalObjectId(3)),
+ handle: producer.handle,
+ status: MissionControlDeviceTableStatus::Available(vec![
+ synthetic_effective_control_device(
+ 19,
+ 19,
+ 0.75_f32.to_bits(),
+ Some(0.5_f32.to_bits()),
+ None,
+ ),
+ ore_device,
+ ]),
+ node_provider_status: MissionControlNodeProviderTableStatus::Available(vec![
+ synthetic_node_provider_row(0, 0, 1.0_f32.to_bits()),
+ ]),
+ };
+ let mut control_tables = vec![producer_table];
+
+ let totals = advance_behavior_distributor_tick(
+ &mut distributor,
+ 1.0,
+ &world,
+ &mut ore_states,
+ &profiles,
+ &mut control_tables,
+ )
+ .expect("tick supported ore source");
+
+ assert_eq!(
+ totals[3],
+ 0.375_f32.to_bits(),
+ "ore producers still query generic Control power demand"
+ );
+ }
+
+ #[test]
+ fn behavior_first_pass_clamps_tiny_deficits_and_overfull_stores() {
+ for (original_id, current, maximum, clamps) in [
+ (4, 0.995_f32, 1.0_f32, true),
+ (5, 1.25, 1.0, true),
+ (6, 0.0, f32::from_bits(0x3c23_d70a), false),
+ ] {
+ let mut world = new_world(WorldConfig);
+ let object = behavior_tick_test_object(&mut world, original_id, 0x8000_0001, 0.5);
+ let mut distributor = BehaviorDistributorState {
+ clan_index: 0,
+ super_ai_visible: true,
+ registered_objects: vec![object.clone()],
+ };
+ let mut ore_states = [BehaviorOreState {
+ original_id: object.original_id,
+ handle: object.handle,
+ class_flags: object.class_flags,
+ current_ore_bits: current.to_bits(),
+ maximum_ore_bits: maximum.to_bits(),
+ }];
+ let mut control_tables = [MissionControlDeviceTableState {
+ original_id: Some(object.original_id),
+ handle: object.handle,
+ status: MissionControlDeviceTableStatus::Available(Vec::new()),
+ node_provider_status: MissionControlNodeProviderTableStatus::Available(Vec::new()),
+ }];
+
+ advance_behavior_distributor_tick(
+ &mut distributor,
+ 1.0,
+ &world,
+ &mut ore_states,
+ &[],
+ &mut control_tables,
+ )
+ .expect("native low-deficit clamp path");
+
+ let expected = if clamps { maximum } else { current };
+ assert_eq!(ore_states[0].current_ore_bits, expected.to_bits());
+ }
+ }
+
+ #[test]
#[ignore = "requires licensed corpus"]
fn licensed_campaign_preview_keeps_unsupported_init_without_partial_writes() {
let root = licensed_root("IS");
diff --git a/crates/fparkan-runtime/tests/behavior_distributor_tick_native_oracle.cs b/crates/fparkan-runtime/tests/behavior_distributor_tick_native_oracle.cs
index 610e8db..4bf0e2b 100644
--- a/crates/fparkan-runtime/tests/behavior_distributor_tick_native_oracle.cs
+++ b/crates/fparkan-runtime/tests/behavior_distributor_tick_native_oracle.cs
@@ -18,6 +18,7 @@ internal static class BehaviorDistributorTickOracle {
private const string ExpectedControlSha256 = "bcb86318089028548a178b03a21accdce15df0cc85ddd91674cf3c2f55012c6e";
private const string ExpectedArealMapSha256 = "a25f9254ebb339d70e2e07c8121950191e9584ca0858d8e9c2e2b6c671edf6ea";
private const int TickRva = 0x19e80;
+ private const int DistributorScheduleRva = 0x1adb0;
private const int AddObjectRva = 0x1aac0;
private const int NormalizeRva = 0x1ac90;
private const int IndexedPropertySetRva = 0x0b470;
@@ -27,6 +28,7 @@ internal static class BehaviorDistributorTickOracle {
private const int BehaviorVarBlockConstructorRva = 0x22d90;
private const int BehaviorVarFieldRegisterRva = 0x22e20;
private const int GetSystemArealMapIatRva = 0x59008;
+ private const int GetQueueIatRva = 0x59110;
private const int ControlResourceDeviceGetterRva = 0x21d00;
private const int ControlResourceAggregateQueryRva = 0x2b410;
private const int ControlResourceAggregateSetRva = 0x2ba30;
@@ -66,6 +68,9 @@ internal static class BehaviorDistributorTickOracle {
[UnmanagedFunctionPointer(CallingConvention.Cdecl)] private delegate void X87ControlWordReader();
[UnmanagedFunctionPointer(CallingConvention.Cdecl)] private delegate void X87ControlWordWriter();
[UnmanagedFunctionPointer(CallingConvention.ThisCall)] private delegate void TickDelegate(IntPtr self, float deltaSeconds);
+ [UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate void NativeBehaviorSchedule(IntPtr self);
+ [UnmanagedFunctionPointer(CallingConvention.Cdecl)] private delegate IntPtr QueueGetter();
+ [UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate uint QueueClockGetter(IntPtr self);
[UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate void NativeAddObject(IntPtr self, uint key);
[UnmanagedFunctionPointer(CallingConvention.ThisCall)] private delegate void NativeNormalize(IntPtr self, uint key);
[UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate void VectorInsert(IntPtr self, IntPtr source, uint count, uint position);
@@ -100,6 +105,8 @@ internal static class BehaviorDistributorTickOracle {
[UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate void NativeControlNodeUpdateCallback(IntPtr self, uint nodeIndex, uint selector, uint valueBits);
private static readonly AreaMapGetter AreaMapGetterCallback = GetAreaMap;
+ private static readonly QueueGetter QueueGetterCallback = GetQueue;
+ private static readonly QueueClockGetter QueueClockGetterCallback = GetQueueTime;
private static readonly VectorInsert VectorInsertCallback = InsertVector;
private static readonly MapLookup MapLookupCallback = Lookup;
private static readonly ObjectState ObjectStateCallback = GetObjectState;
@@ -127,6 +134,7 @@ internal static class BehaviorDistributorTickOracle {
private static X87ControlWordWriter x87ControlWordWriter;
private static readonly NativeBehaviorProfileLoadCallback BehaviorProfileLoadCallback = CaptureBehaviorProfileLoad;
private static readonly List<BehaviorProfileSelection> behaviorProfileSelections = new List<BehaviorProfileSelection>();
+ private static Fixture activeQueueFixture;
private sealed class BehaviorProfileSelection {
public IntPtr Owner;
@@ -168,6 +176,9 @@ internal static class BehaviorDistributorTickOracle {
public IntPtr VectorVtable;
public IntPtr Manager;
public IntPtr ManagerVtable;
+ public IntPtr Queue;
+ public IntPtr QueueVtable;
+ public uint QueueTime;
public readonly List<IntPtr> Allocations = new List<IntPtr>();
public readonly Dictionary<uint, NativeObject> ByKey = new Dictionary<uint, NativeObject>();
public readonly List<string> Calls = new List<string>();
@@ -221,6 +232,8 @@ internal static class BehaviorDistributorTickOracle {
Marshal.WriteInt32(Distributor, 0x20, keys.Length);
Marshal.WriteInt32(Distributor, 0x24, capacity);
Marshal.WriteIntPtr(Distributor, 0x28, Entries);
+ Marshal.WriteInt16(Distributor, 0x18, 3);
+ Marshal.WriteInt16(Distributor, 0x1a, 1);
for (int i = 0; i < keys.Length; i++) {
IntPtr entry = IntPtr.Add(Entries, i * 0x1c);
Marshal.WriteInt32(entry, 0x00, unchecked((int)keys[i]));
@@ -233,8 +246,16 @@ internal static class BehaviorDistributorTickOracle {
Allocations.Add(value);
return value;
}
+ public void MakeQueue(uint time) {
+ QueueTime = time;
+ QueueVtable = Allocate(0x40);
+ Queue = Allocate(0x20);
+ Marshal.WriteIntPtr(Queue, 0, QueueVtable);
+ Marshal.WriteIntPtr(QueueVtable, 0x38, Marshal.GetFunctionPointerForDelegate(QueueClockGetterCallback));
+ }
public void Dispose() {
active = null;
+ if (activeQueueFixture == this) activeQueueFixture = null;
for (int i = Allocations.Count - 1; i >= 0; i--) Marshal.FreeHGlobal(Allocations[i]);
Allocations.Clear();
}
@@ -287,6 +308,16 @@ internal static class BehaviorDistributorTickOracle {
}
private static IntPtr GetAreaMap() { return active.Manager; }
+ private static IntPtr GetQueue() {
+ if (activeQueueFixture == null || activeQueueFixture.Queue == IntPtr.Zero)
+ throw new InvalidOperationException("native scheduler requested a queue without a fixture");
+ return activeQueueFixture.Queue;
+ }
+ private static uint GetQueueTime(IntPtr self) {
+ if (activeQueueFixture == null || self != activeQueueFixture.Queue)
+ throw new InvalidOperationException("native scheduler queried an unexpected queue");
+ return activeQueueFixture.QueueTime;
+ }
private static int OnArealMapEvent(IntPtr owner, uint message, uint subcode, IntPtr descriptor) {
ArealMapFixture fixture = activeArealMap;
if (fixture == null) return 0;
@@ -493,7 +524,9 @@ internal static class BehaviorDistributorTickOracle {
FreeLibrary(module); FreeLibrary(controlModule); return 12;
}
IntPtr import = IntPtr.Add(module, GetSystemArealMapIatRva);
+ IntPtr queueImport = IntPtr.Add(module, GetQueueIatRva);
IntPtr originalImport = Marshal.ReadIntPtr(import);
+ IntPtr originalQueueImport = Marshal.ReadIntPtr(queueImport);
uint oldProtection = 0;
bool protectionChanged = false;
bool thunksAllocated = false;
@@ -513,8 +546,9 @@ internal static class BehaviorDistributorTickOracle {
throw new InvalidOperationException("VirtualProtect(GetSystemArealMap IAT) failed: " + Marshal.GetLastWin32Error());
protectionChanged = true;
Marshal.WriteIntPtr(import, Marshal.GetFunctionPointerForDelegate(AreaMapGetterCallback));
+ Marshal.WriteIntPtr(queueImport, Marshal.GetFunctionPointerForDelegate(QueueGetterCallback));
RunSmokeCases(module, controlModule, arealMapModule);
- Console.WriteLine("original native Behavior/ArealMap/Control oracle passed (Behavior Add 0x1aac0, normalize 0x1ac90, tick 0x19e80; ArealMap UnitDAT projection 0x14b90; Control INTO override 0x2d890; only synthetic host callbacks, GetSystemArealMap IAT, and bounded vector insertion are substituted; this does not compare Rust parity).");
+ Console.WriteLine("original native Behavior/ArealMap/Control oracle passed (Behavior Add 0x1aac0, normalize 0x1ac90, scheduler 0x1adb0, tick 0x19e80; ArealMap UnitDAT projection 0x14b90; Control INTO override 0x2d890; synthetic host callbacks, GetSystemArealMap/GetQueue IAT slots, and bounded vector insertion are substituted; scheduler and tick machine code are original; this does not compare Rust parity).");
return 0;
}
catch (Exception error) {
@@ -524,10 +558,12 @@ internal static class BehaviorDistributorTickOracle {
finally {
if (protectionChanged) {
Marshal.WriteIntPtr(import, originalImport);
+ Marshal.WriteIntPtr(queueImport, originalQueueImport);
uint ignored;
VirtualProtect(import, new UIntPtr((uint)IntPtr.Size), oldProtection, out ignored);
}
- GC.KeepAlive(AreaMapGetterCallback); GC.KeepAlive(VectorInsertCallback); GC.KeepAlive(x87ControlWordReader); GC.KeepAlive(x87ControlWordWriter); GC.KeepAlive(MapLookupCallback);
+ GC.KeepAlive(AreaMapGetterCallback); GC.KeepAlive(QueueGetterCallback); GC.KeepAlive(QueueClockGetterCallback);
+ GC.KeepAlive(VectorInsertCallback); GC.KeepAlive(x87ControlWordReader); GC.KeepAlive(x87ControlWordWriter); GC.KeepAlive(MapLookupCallback);
GC.KeepAlive(ObjectStateCallback); GC.KeepAlive(ObjectClassCallback);
GC.KeepAlive(ObjectQueryCallback); GC.KeepAlive(ObjectRateCallback);
GC.KeepAlive(ObjectGetPropertyCallback); GC.KeepAlive(ObjectSetPropertyCallback);
@@ -565,6 +601,19 @@ internal static class BehaviorDistributorTickOracle {
}
RunNativeIndexedPropertyCases(module);
RunNativeOreInitializationCases(module);
+ ushort tickControlWord = CurrentX87ControlWord();
+ try {
+ SetX87ControlWord(0x007f);
+ Expect(CurrentX87ControlWord() == 0x007f, "Behavior resource-distributor tick uses the measured game x87 control word");
+ Console.WriteLine("native-behavior-tick-x87-control-word=0x" + CurrentX87ControlWord().ToString("x4"));
+ RunNativeBehaviorTickCases(module);
+ RunNativeBehaviorSchedulerCases(module);
+ } finally {
+ SetX87ControlWord(tickControlWord);
+ }
+ }
+
+ private static void RunNativeBehaviorTickCases(IntPtr module) {
TickDelegate tick = (TickDelegate)Marshal.GetDelegateForFunctionPointer(IntPtr.Add(module, TickRva), typeof(TickDelegate));
using (Fixture empty = NewFixture()) {
empty.MakeDistributor(); active = empty; tick(empty.Distributor, 0.0f);
@@ -579,6 +628,10 @@ internal static class BehaviorDistributorTickOracle {
RunObjectCase(tick, 0x80000008, 0.5f, 0.0f, 3.0f, 0, 2.0f, "ore-80000008");
RunMixedOreCase(tick, "mixed-ore-producer-recipient", 1.0f, 0.5f);
RunMixedOreCase(tick, "bounded-ore-store", 0.25f, 0.5f);
+ RunOreAllocationBranch(tick, "ore-allocation-middle", 0.25f, 2.0f, 0.25f, 0.625f, 1.75f, 0.5f);
+ RunOreAllocationBranch(tick, "ore-allocation-surplus", 2.0f, 3.0f, 0.25f, 0.625f, 2.625f, 0.625f);
+ RunOreAllocationBranch(tick, "ore-allocation-equality", 0.375f, 2.0f, 0.25f, 0.625f, 1.625f, 0.625f);
+ RunNativeOreClampCases(tick);
RunWeightedOreCase(tick);
RunMixedPowerCase(tick, "mixed-power-sufficient", 4.0f, 1.0f, 0.5f, 0.75f);
RunMixedPowerCase(tick, "mixed-power-shortage", 0.125f, 1.0f, 0.5f, 0.75f);
@@ -587,6 +640,62 @@ internal static class BehaviorDistributorTickOracle {
RunSkippedCase(tick);
}
+ private static void RunNativeBehaviorSchedulerCases(IntPtr module) {
+ NativeBehaviorSchedule schedule = (NativeBehaviorSchedule)Marshal.GetDelegateForFunctionPointer(
+ IntPtr.Add(module, DistributorScheduleRva), typeof(NativeBehaviorSchedule));
+ uint[] elapsedVectors = { 1, 1001, 16777217, 16777219, 0xffffffff };
+ uint[] expectedBits = { 0x3a83126f, 0x3f8020c5, 0x46831270, 0x46831271, 0x4a83126f };
+ for (int i = 0; i < elapsedVectors.Length; i++) {
+ uint elapsed = elapsedVectors[i];
+ uint now = unchecked(1u + elapsed);
+ RunNativeSchedulerSample(schedule, now, 1, 0, expectedBits[i], "elapsed-" + elapsed.ToString());
+ }
+
+ using (Fixture fixture = NewFixture()) {
+ NativeObject producer = fixture.AddObject(0x75, 0x80000002, 1.0f, 0.0f, 0.0f, 0);
+ fixture.MakeDistributor(producer.Key);
+ fixture.MakeQueue(10);
+ active = fixture;
+ activeQueueFixture = fixture;
+ Marshal.WriteInt32(fixture.Distributor, 0x10, 1);
+ Marshal.WriteInt32(fixture.Distributor, 0x14, 10);
+ Marshal.WriteInt32(fixture.Distributor, 0x30, unchecked((int)0x41200000));
+ schedule(fixture.Distributor);
+ Expect(fixture.LookupCount == 0 && unchecked((uint)Marshal.ReadInt32(fixture.Distributor, 0x30)) == 0x41200000,
+ "scheduler equality with the deadline performs no resource tick or totals write");
+
+ fixture.QueueTime = 11;
+ schedule(fixture.Distributor);
+ uint deadlineTotal = unchecked((uint)Marshal.ReadInt32(fixture.Distributor, 0x30));
+ Expect(fixture.LookupCount == 2 && deadlineTotal == 0x3c23d70b,
+ "scheduler ticks only after the deadline is strictly passed (lookups=" + fixture.LookupCount +
+ ", total=" + Hex(deadlineTotal) + ")");
+ Console.WriteLine("scheduler-deadline: equality=skip; now=11 delta=0.01; lookups=" + fixture.LookupCount);
+ }
+
+ RunNativeSchedulerSample(schedule, 0, 0xffffffff, 0, 0x3a83126f, "wrapped-elapsed-1");
+ GC.KeepAlive(schedule);
+ }
+
+ private static void RunNativeSchedulerSample(
+ NativeBehaviorSchedule schedule, uint now, uint firstTime, uint deadline, uint expectedTotalBits, string label) {
+ using (Fixture fixture = NewFixture()) {
+ NativeObject producer = fixture.AddObject(0x74, 0x80000002, 1.0f, 0.0f, 0.0f, 0);
+ fixture.MakeDistributor(producer.Key);
+ fixture.MakeQueue(now);
+ active = fixture;
+ activeQueueFixture = fixture;
+ Marshal.WriteInt32(fixture.Distributor, 0x10, unchecked((int)firstTime));
+ Marshal.WriteInt32(fixture.Distributor, 0x14, unchecked((int)deadline));
+ schedule(fixture.Distributor);
+ uint actual = unchecked((uint)Marshal.ReadInt32(fixture.Distributor, 0x30));
+ Expect(actual == expectedTotalBits,
+ label + " native qword-to-f32 scheduler delta expected " + Hex(expectedTotalBits) + " got " + Hex(actual));
+ Console.WriteLine("native-scheduler-" + label + ": now=" + now.ToString("x8") + " first=" + firstTime.ToString("x8") +
+ " total=" + Hex(actual) + " lookups=" + fixture.LookupCount);
+ }
+ }
+
private static void RunNativeControlResourceDeviceCase(IntPtr module) {
Expect(CurrentX87ControlWord() == 0x007f, "Control selector 0x300 uses x87 control word 0x007f");
const uint key = 2;
@@ -1641,6 +1750,58 @@ internal static class BehaviorDistributorTickOracle {
}
}
+ private static void RunOreAllocationBranch(
+ TickDelegate tick, string label, float rate, float stock, float recipientCurrent, float recipientMaximum,
+ float expectedProducerRemaining, float expectedRecipientResult) {
+ using (Fixture fixture = NewFixture()) {
+ NativeObject producer = fixture.AddObject(0x46, 0x80000004, 0.0f, rate, stock, 0);
+ producer.PropertyMetadata = FloatBits(10.0f);
+ NativeObject recipient = fixture.AddObject(0x47, 0x80000001, 0.0f, 0.0f, recipientCurrent, 0);
+ recipient.PropertyMetadata = FloatBits(recipientMaximum);
+ recipient.InterfaceSelector1 = 0.5f;
+ recipient.InterfaceSelector2 = 0.0f;
+ fixture.MakeDistributor(producer.Key, recipient.Key);
+ Marshal.WriteInt32(fixture.Entries, 0x04, FloatBits(1.0f));
+ Marshal.WriteInt32(fixture.Entries, 0x1c + 0x04, FloatBits(0.5f));
+ active = fixture;
+ tick(fixture.Distributor, 1.0f);
+ Console.WriteLine(label + ": totals=[" + Float(ReadFloat(fixture.Distributor, 0x30)) + "," +
+ Float(ReadFloat(fixture.Distributor, 0x34)) + "," + Float(ReadFloat(fixture.Distributor, 0x38)) + "," +
+ Float(ReadFloat(fixture.Distributor, 0x3c)) + "," + Float(ReadFloat(fixture.Distributor, 0x40)) +
+ "]; stored=[" + Float(producer.Property) + "," + Float(recipient.Property) + "] reads=" + producer.OreRateReads);
+ Expect(ReadFloat(fixture.Distributor, 0x34) == Math.Min(rate, stock) &&
+ ReadFloat(fixture.Distributor, 0x40) == recipientMaximum - recipientCurrent &&
+ producer.Property == expectedProducerRemaining && recipient.Property == expectedRecipientResult &&
+ producer.OreRateReads == 2 && producer.Writes == 1 && recipient.Writes == 1 && fixture.LookupCount == 4,
+ label + " native allocation branch totals and two-pass reread");
+ }
+ }
+
+ private static void RunNativeOreClampCases(TickDelegate tick) {
+ float[][] states = {
+ new float[] { 0.995f, 1.0f, 1.0f },
+ new float[] { 1.25f, 1.0f, 1.0f },
+ new float[] { 0.0f, 0.01f, 0.0f }
+ };
+ foreach (float[] state in states) {
+ float current = state[0];
+ float maximum = state[1];
+ float expected = state[2];
+ using (Fixture fixture = NewFixture()) {
+ NativeObject item = fixture.AddObject(0x48, 0x80000001, 0.0f, 0.0f, current, 0);
+ item.PropertyMetadata = FloatBits(maximum);
+ item.InterfaceSelector2 = 0.0f;
+ fixture.MakeDistributor(item.Key);
+ active = fixture;
+ tick(fixture.Distributor, 1.0f);
+ Expect(item.Property == expected && item.Writes > 0 && fixture.LookupCount == 2,
+ "native first-pass ore clamp for CurrentOre=" + Float(current));
+ Console.WriteLine("native-ore-clamp: current=" + Float(current) + " maximum=" + Float(maximum) + " result=" +
+ Float(item.Property) + " writes=" + item.Writes);
+ }
+ }
+ }
+
private static void RunMixedPowerCase(TickDelegate tick, string label, float powerRate, float recipientProperty, float selector1, float selector2) {
using (Fixture fixture = NewFixture()) {
NativeObject producer = fixture.AddObject(0x61, 0x80000002, powerRate, 0.0f, 1.0f, 0);
diff --git a/docs/appendices/knowledge-boundaries.md b/docs/appendices/knowledge-boundaries.md
index 3744d84..b9bbf27 100644
--- a/docs/appendices/knowledge-boundaries.md
+++ b/docs/appendices/knowledge-boundaries.md
@@ -325,17 +325,28 @@ sidecar недоступен, запрос `0xe00` сообщает это отÐ
Rust query обращается к загруженному объекту и поддерживает `0xe00` только для
текущего descriptor tag `26` с factory tag `26`; другие активные typed tags и
-factory paths остаются явными границами. Snapshot показывает состояние сразу
-после native-конструкторов, но он не обновляется при Control tick-е. Native
-`FUN_10010f30` (RVA `0x10f30`) изменяет и ограничивает provider amount, а
-связанные callbacks переносят его между строками; их общий переход в Rust ещё
-не реализован. Поэтому вызов нельзя считать живым ресурсным симулятором.
+factory paths остаются явными границами. Этот запрос возвращает начальный
+снимок provider amount: Native `FUN_10010f30` (RVA `0x10f30`) изменяет и
+ограничивает количество, а связанные callbacks переносят его между строками;
+этот переход в Rust ещё не реализован.
+
+Отдельный API `advance_loaded_mission_resources` принимает явное время очереди
+и обновляет представленные поля `CurrentOre`, строк распределителя и Control
+selector `1`. Его граница — статические снимки профиля и provider-значений:
+динамическое распространение Control amount, смена профилей, special
+object-state gate и жизненный цикл созданных/удалённых объектов здесь не
+моделируются. Если обязательный запрос позднего объекта не поддержан,
+транзакция возвращает ошибку и не применяет подготовленные изменения. API не
+подключён к игровому циклу; AutoDemo-тест подтверждает связь настоящих профилей
+с этим шагом, но не полный паритет миссии. Отдельный aggregate getter Behavior
+RVA `0xa490` в oracle не исполнен.
+
Behavior selectors `0x1002` и `0x1005` используют значения выбранного
профиля из `behpsp.res`, разобранного до создания нового мира. `0x1002` складывает
только текущие descriptor tag `26` запросы `0xe00`, затем применяет
`Transfer_Ore_OffBoard`; `0x1005` возвращает `Transfer_Power_Out`. Это начальный
-снимок: он не отражает последующие изменения provider-строк, Control tick-а или
-профиля. Полная загрузка сохраняет результат у `ObjectHandle` и возвращает
+снимок профиля и provider-строк. Полная загрузка сохраняет результат у
+`ObjectHandle` и возвращает
ошибку, если известный код класса не имеет корректной записи; класс,
отсутствующий в таблице выбора, сохраняет начальные значения конструктора.
Preview и объекты без полного Unit DAT не получают профильное состояние.
diff --git a/docs/appendices/script-vm.md b/docs/appendices/script-vm.md
index c15b208..99c448f 100644
--- a/docs/appendices/script-vm.md
+++ b/docs/appendices/script-vm.md
@@ -373,10 +373,17 @@ nearest-even `FISTP qword`, младший DWORD, преобразование D
deadline `+0x14` по формуле `время + 3*64 + jitter`, где `jitter` лежит в
`0..63` и получен одним шагом глобального MSVCRT LCG. В этой ветви она также
обнуляет пять слов `+0x30..+0x40`. При повторном вызове до deadline ненулевой
-`+0x10` оставляет deadline прежним, не расходует новое случайное число и не
-очищает эти слова. Поведение после истечения deadline этим опытом не проверено.
-Если само время очереди равно нулю, `+0x10` остаётся нулевым, и повторный вызов
-снова проходит ветвь начальной подготовки.
+`+0x10` оставляет срок прежним, не расходует новое случайное число и не
+очищает эти слова. Если само время очереди равно нулю, `+0x10` остаётся
+нулевым, и повторный вызов снова проходит ветвь начальной подготовки. После
+срока scheduler продолжает при нулевом deadline или при беззнаковом
+`now > deadline`; равенство ненулевому deadline ещё ждёт. Он считает
+`u32(now - first_time)` с переполнением по модулю `2^32`, переводит миллисекунды в секунды через x87
+`FILD`/`FMUL`/`FSTP` и планирует следующий срок от текущего времени. Шаг
+интервала равен `3 * 64 + jitter`: один шаг LCG `state = state * 214013 +
+2531011` выдаёт значение `random = (state >> 16) & 0x7fff`, а
+`jitter = ((random & 0xff) * 64) >> 8`. Native oracle проверяет
+равенство и проход срока, обёртку и большие интервалы с округлением времени.
Путь host callback в проверенной паре DLL теперь статически известен. В
`iron3d.dll` функция `FUN_1005ff40` (RVA `0x5ff40`) сначала вызывает
@@ -400,9 +407,11 @@ callback-точку входа и порядок внутри неё, но не
bundle, но остальные потребители исходного глобального RNG не моделируются.
В Rust также нет значения аргумента в `AI+0x3fc`, recursion guard `AI+0x78`
или одноразового latch `AI+0x8a8`. Поэтому это связанный начальный поднабор, а
-не полная активация SuperAI. Восстановленный ниже distributor tick проверен на
-исходной DLL, но пока не подключён к Rust игровому циклу: у runtime нет
-ArealMap-объектов и интерфейсов, которые нужны этому вызову. При
+не полная активация SuperAI. После полной загрузки узкая Rust-реализация
+вызывается явно через `advance_loaded_mission_resources(engine, queue_time_ms)`;
+runtime не читает системную очередь, а приложение пока не вызывает API из
+игрового цикла. Шаг использует разрешённые handles и представленные snapshots
+профилей и Control, поэтому не воспроизводит отсутствующие в них callbacks. При
ошибке ограниченного `Init` Rust отклоняет полную загрузку и сохраняет прежний
мир и состояние генератора; такая политика отката принадлежит Rust loader-у.
@@ -428,9 +437,33 @@ DWORD по смещению `+0x14` как `f32`; если выходной ук
пока не получило доменного имени. Идентификаторы и границы вызовов не
задают полную семантику свойств.
-Изолированный x86 oracle вызывает исходный tick с подменой только IAT-слота
-`GetSystemArealMap`; синтетические vtables записывают последовательность
-вызовов и ответы. Для смешанного примера два прохода нашли объекты в порядке
+Раздача считает доступный за этот шаг объём `A`, полный спрос `D` и взвешенный
+спрос `W = Σ(demand × share)`. Из них выводятся коэффициенты приоритетной доли
+`P`, остатка `R` и расхода `C`. В таблице ниже показан исходный порядок
+проверок: он важен, когда нестандартные доли дают `W > D`.
+
+| Первое совпавшее условие (при `A > 0`, `D > 0`) | `P` | `R` | `C` |
+| --- | ---: | ---: | ---: |
+| `A ≤ W` | `A / W` | `0` | `1` |
+| `W < A < D` | `1` | `(A − W) / (D − W)` | `1` |
+| `A ≥ D` | `1` | `1` | `D / A` |
+
+При нулевом доступном количестве или спросе native path не выделяет
+положительное значение. Строка с долей `share` получает коэффициент
+`(1 − share) × R + share × P`, который сочетается с её спросом или доступной
+вместимостью. `C` задаёт долю отбора руды у источников; для источников энергии
+этот коэффициент вычисляется, но native-код не применяет его к производству.
+У объектов в ветви приёма руды (не источников руды) native-код ограничивает `CurrentOre`:
+если `MaximumOre − CurrentOre < 0.01`, значение становится `MaximumOre`.
+Сравнение строгое: при разнице ровно `0.01` значение не меняется.
+В x86-коде это константа `0x3c23d70a`; сравнение и округление проверены при
+игровом x87 control word `0x007f`.
+
+Изолированный x86 oracle вызывает исходный scheduler RVA `0x1adb0`, который
+сам вызывает исходный tick RVA `0x19e80`. Для синтетического времени он
+подменяет IAT-слот `GetQueue`; tick подменяет `GetSystemArealMap`, а синтетические
+vtables записывают последовательность вызовов и ответы. Для смешанного примера
+два прохода нашли объекты в порядке
`41,42,41,42`. Производитель руды с начальным значением `1` и скоростью `4`
вернул при следующем чтении скорость `1`; получатель с начальным значением `6`
получил `7`, а агрегаты distributor равны `[0,1,1,0.375,6]`. При запасе
@@ -441,11 +474,13 @@ selector `1` на интерфейсе получателя становится
`0x3f2aaaab`). Эти векторы проверяют арифметику исходной функции, но не
распределение реальной карты.
-Полная загрузка Rust теперь собирает этот список из runtime `ObjectHandle` и
-сохраняет веса вместе с пятью исходными DWORD хвоста каждой записи. Членство
-строится только для полного режима; preview остаётся статическим. Это пока не
-даёт ресурсных полей и интерфейсов ArealMap для `FUN_10019e80`, а
-`step_headless` по-прежнему шагает только `World`.
+Полная загрузка Rust собирает этот список из runtime `ObjectHandle` и сохраняет
+веса и поля строк, а также начальные ore-свойства объектов. Членство строится
+только для полного режима; preview остаётся статическим. Явный API
+`advance_loaded_mission_resources` использует очередь времени, расписание,
+профили и представленные Control-таблицы, чтобы исполнить этот ограниченный
+шаг над загруженным состоянием. `step_headless` по-прежнему шагает только
+`World`.
### Добавление и нормализация долей
@@ -520,17 +555,21 @@ exit $LASTEXITCODE
Oracle проверяет SHA-256 оригинального `Behavior.dll`:
`ddfbdbde07832358fe6e35e01c8dba9b58e7313789498b6049ed51d4ed9baf99`. Harness
-явно устанавливает x87 CW `0x007f` для вызовов Add (`0x1aac0`) и normalize
-(`0x1ac90`), проверяет CW до и после каждого вызова и восстанавливает прежнее
-значение перед tick suite. Для этих двух методов подменяется только bounded
-вставка синтетического vector; их машинный код не патчится. Для tick helper
-подменяет только IAT-слот `GetSystemArealMap` и вызывает RVA `0x19e80`.
-Проверяются нулевой
-шаг, обе ветви селекторов скорости, пропуск состояния `0xfffe`, missing lookup,
-динамическое повторное чтение `0x1002`, ограниченный запас руды, разные веса,
-достаточное и недостаточное значение мощности. Это синтетические ArealMap
-объекты; исполнение оригинальной функции проверяет векторы oracle, но не
-подменяет сравнение Rust и интеграционную проверку миссии в игре.
+явно устанавливает x87 CW `0x007f` для Add (`0x1aac0`), normalize (`0x1ac90`)
+и scheduler/tick (`0x1adb0`/`0x19e80`), проверяя слово перед набором вызовов
+и восстанавливая прежнее значение после каждого набора. Для Add и normalize
+подменяется только bounded вставка синтетического vector; их машинный код не
+патчится. Scheduler и tick тоже исполняются оригинальными: подменяются лишь
+IAT-слоты `GetQueue` и `GetSystemArealMap`, а synthetic vtables задают часы и
+ответы объектов. Проверяются равенство и проход срока, переполнение времени
+и точные `f32`-биты elapsed seconds (`1 → 0x3a83126f`, `1001 → 0x3f8020c5`,
+`16777217 → 0x46831270`, `16777219 → 0x46831271`, `u32::MAX → 0x4a83126f`).
+Tick-векторы проверяют нулевой шаг, обе ветви селекторов скорости, пропуск
+состояния `0xfffe`, отсутствующий объект, повторное чтение `0x1002`, ограниченный
+запас руды, порог `0.01`, ветви дефицита/частичного/избыточного предложения и
+равенство спросу, разные веса и достаточную/недостаточную мощность. Это
+синтетические ArealMap объекты: oracle исполняет оригинальные scheduler и tick,
+но не сравнивает паритет Rust и не заменяет проверку полной миссии в игре.
Caller oracle проверяет AutoDemo пару `(500.2857, 751.8217)`, четыре режима
x87 на tie-векторах, границу `10000` и младший DWORD. AI oracle отдельно
diff --git a/docs/tomes/06-behavior.md b/docs/tomes/06-behavior.md
index bcb7320..b3dd8d0 100644
--- a/docs/tomes/06-behavior.md
+++ b/docs/tomes/06-behavior.md
@@ -326,8 +326,48 @@ Resource Distributor работает со списком зарегистрир
записях при игровом x87 control word `0x007f`: проверены добавление, повторный
ключ, закреплённая запись, нулевая сумма и округление. Это позволяет Rust
сохранять начальный список, но пока не подтверждает веса реальных объектов в
-живой миссии. Для регулярного шага по-прежнему не хватает интерфейсов ArealMap.
-Остальные ограничения собраны в [границах знания](../appendices/knowledge-boundaries.md).
+живой миссии.
+
+Узкая часть регулярного шага уже связана с загруженным состоянием движка.
+`advance_loaded_mission_resources(engine, queue_time_ms)` принимает явную
+метку времени общей 32-битной очереди. Для каждого видимого Behavior clan он
+проверяет срок запуска, выполняет два прохода по списку и сохраняет пять
+итогов: доступную энергию и руду, буфер руды, потребление энергии и потребление
+руды. В обоих проходах объекты разрешаются заново по исходному TMA ID. Первый
+проход измеряет поставки и потребность, второй повторно читает представленные
+профильные и Control-значения перед применением выделения. Нативный код также
+запрашивает интерфейсы во втором проходе, но динамические getter-callbacks в
+этом снимке Rust не воспроизводятся.
+
+Планировщик использует беззнаковое сравнение времени: равенство ненулевому
+сроку ещё не запускает шаг, а нулевой срок не задерживает его. Переполнение
+вычитания даёт 32-битную длительность. Затем
+длительность переводится в секунды с округлением, подтверждённым x87-путём
+оригинальной DLL. Нативный oracle проверяет его на длинных интервалах, включая
+значения около границы точного целого `f32`, а также на равенстве и строгом
+проходе срока. Формула запуска, native vectors и команда воспроизведения
+описаны в технической главе [script VM](../appendices/script-vm.md).
+
+Шаг работает только с уже созданными полными объектами миссии и снимками тех
+профилей и Control-таблиц, чьи запросы и setters представлены в runtime. Он
+обновляет загруженные `CurrentOre`, поля строк распределителя и поддержанный
+Control selector `1`; неподдержанное свойство, запрос Control или невозможное
+арифметическое значение возвращает ошибку. Обновления нескольких кланов, их
+расписания и RNG фиксируются одной транзакцией: если обязательный запрос
+позднего клана не разрешён, ранее подготовленные изменения остаются
+неприменёнными. Приложение пока не вызывает
+этот API из игрового цикла, а динамические callbacks, которые переносят
+количество между Control provider-строками, ещё не моделируются. Поэтому это
+исполняемый загруженный resource step, а не полный симулятор миссии.
+
+Для настоящих ресурсов AutoDemo тест проходит несколько временных точек:
+генераторы `ObjectId 6` и `ObjectId 7` читают `Transfer_Power_Out = 10` из
+`prof_generator.var`; после шага в 500 мс каждый сообщает 5 единиц доступной
+энергии. Это подтверждает связь загруженного профиля с runtime-расчётом, но не
+сравнение полной миссии с оригинальной игрой. Native oracle сверяет исходные
+планировщик и распределитель GOG `Behavior.dll`; техническая процедура и
+проверяемые векторы описаны в [script VM](../appendices/script-vm.md). Остальные ограничения собраны в
+[границах знания](../appendices/knowledge-boundaries.md).
Первый часто встречающийся table entry с side effect — `Handler(2)` (176
records в corpus). Он берёт active instruction, разрешает семь slots через