Struct EngineSim 

pub struct EngineSim<G: GameDef> {
    pub cfg: EngineConfig,
    pub world: PhysicsWorld,
    pub map: Option<GameMap>,
    pub nav: Option<NavigationSystem>,
    pub spatial: SpatialGrid,
    pub rng: Rng,
    pub events: Vec<CoreEvent>,
    pub sim: G::Sim,
    /* private fields */
}

Движковый каркас симуляции: физический мир, карта, нав-граф/сетка ботов, PRNG, аккумулятор фиксированного шага, очередь удаления тел, события. Игровая логика (участники/оружие/снапшот-блоки) вынесена в G::Sim (см. core/src/sim.rs) — движок зовёт её только через on_fixed_step/on_contacts/on_before_destroy/on_ai_tick, не зная деталей конкретной игры. Конкретная игра (тип G, дефолт для GameState-алиасов — забота game-crate) не импортируется движком.

Fields

cfg: EngineConfig

world: PhysicsWorld

map: Option<GameMap>

nav: Option<NavigationSystem>

spatial: SpatialGrid

rng: Rng

events: Vec<CoreEvent>

sim: G::Sim

Implementations

impl<G: GameDef> EngineSim<G>

pub fn new(cfg: EngineConfig, game_cfg: &G::Config) -> Self

pub fn load_map(&mut self, json: &str) -> Result<(), String>

Создаёт карту из JSON (масштабирование внутри) и нав-граф ботов.

pub fn map_info_json(&self) -> String

Информация о загруженной карте: setId, масштабированные респауны, размеры мира (JSON) — ‘null’, если карта не загружена.

pub fn spawn_actor( &mut self, game_id: u32, model_name: &str, team_id: u8, x: f32, y: f32, angle_deg: f32, ) -> Result<(), String>

pub fn remove_actor(&mut self, game_id: u32)

pub fn reset_actor( &mut self, game_id: u32, team_id: u8, x: f32, y: f32, angle_deg: f32, )

pub fn reset_all_vitals(&mut self)

pub fn spawn_scripted_actor( &mut self, game_id: u32, model_name: &str, team_id: u8, x: f32, y: f32, angle_deg: f32, ) -> Result<(), String>

pub fn remove_scripted_actor(&mut self, game_id: u32)

pub fn apply_input( &mut self, game_id: u32, seq: u32, action: &str, key_name: &str, )

pub fn apply_aim(&mut self, game_id: u32, seq: u32, x: f32, y: f32, flags: u32)

Ввод указателем: мировая точка + биты состояния (см. GameSim::apply_aim).

pub fn last_input_seq(&self, game_id: u32) -> u32

pub fn take_events_json(&mut self) -> String

События за тик (kill/health/ammo/weapon/shake) одной JSON-строкой; буфер очищается.

pub fn is_alive(&self, game_id: u32) -> bool

pub fn actor_position(&self, game_id: u32) -> Option<[f32; 2]>

pub fn prediction_state(&self, game_id: u32) -> Option<([f32; 8], bool)>

pub fn alive_players_flat(&self) -> Vec<f32>

pub fn players_json(&self) -> String

Полный снапшот игроков (Game.getPlayersData), не дренируя накопители событий — для первого кадра (FIRST_SHOT_DATA).

pub fn step(&mut self, dt: f32)

Обновляет физику фиксированными шагами (Game.updateData), затем ИИ скриптовых участников (VIMP._onShotTick).

pub fn build_snapshot_blocks(&mut self) -> Vec<(String, Block)>

Собирает блоки тела снапшота, дренируя накопители событий. Вызывается на каждый отправляемый кадр (throttle — забота JS).

pub fn body_has_events(&self) -> bool

Содержал ли последний собранный body событийные блоки — для классификации канала WebRTC (meta reliable / state unreliable).

pub fn remove_players_and_shots(&mut self) -> Vec<String>

Удаляет всех игроков и снаряды, возвращает имена для очистки полотна клиентов (Game.removePlayersAndShots).

pub fn clear(&mut self)

Полная очистка игрового мира (Game.clear + сброс ботов).

pub fn debug_json(&self) -> String

Курированный дамп мира (тела, коллайдеры, карта, нав-граф, spatial-сетка, rng, аккумулятор фикс-шага) — читаемая альтернатива сырому serialize_state (см. crate::debug).

pub fn serialize_state(&self) -> Result<Vec<u8>, String>

Сериализует состояние симуляции для эстафетной передачи между инстансами WASM. Накопители снапшота должны быть дренированы (pack_body) перед вызовом.

pub fn deserialize_state(&mut self, data: &[u8]) -> Result<(), String>

Восстанавливает состояние из дампа. Конфиг ядра должен совпадать с конфигом инстанса, создавшего дамп.