adjust playback speed with arrow keys

.cargo/config.toml

@@ -0,0 +1,2 @@
+[registries.strafesnet]
+index = "sparse+https://git.itzana.me/api/packages/strafesnet/cargo/"

.rustfmt.toml

@@ -0,0 +1 @@
+hard_tabs=true

Cargo.toml

@@ -2,12 +2,18 @@
 members = [
 	"lib",
 	"native-player",
+	"ratio_from_float",
 	"wasm-module"
 ]
 resolver = "3"
 
+[profile.release]
+# lto = true
+strip = true
+codegen-units = 1
+
 [workspace.dependencies]
-strafesnet_common = { version = "0.8.0", registry = "strafesnet" }
-strafesnet_graphics = { version = "0.0.1", registry = "strafesnet" }
-strafesnet_roblox_bot_file = { version = "0.8.1", registry = "strafesnet" }
+strafesnet_common = { version = "0.8.1", registry = "strafesnet" }
+strafesnet_graphics = { version = "0.0.2", registry = "strafesnet" }
+strafesnet_roblox_bot_file = { version = "0.9.0", registry = "strafesnet" }
 strafesnet_snf = { version = "0.3.2", registry = "strafesnet" }

README.md

@@ -0,0 +1,20 @@
+This respository uses git lfs for large file storage.  You will need to run `git lfs pull` after cloning.
+
+How to build the wasm module:
+```
+cd wasm-module
+wasm-pack build --target web --out-dir ../web-demo/pkg
+```
+
+How to serve the web demo (requires wasm module):
+```
+cd web-demo
+python3 -m http.server
+```
+
+How to run the native player:
+```
+cd native-player
+cargo run --release -- ../web-demo/bhop_marble_5692093612.snfm ../web-demo/bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d.qbot
+```
+You can drag and drop map files and bot files to load them.

lib/Cargo.toml

@@ -4,7 +4,8 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
+glam = "0.31.0"
 strafesnet_common.workspace = true
 strafesnet_graphics.workspace = true
 strafesnet_roblox_bot_file.workspace = true
-strafesnet_snf.workspace = true
+wgpu = "28.0.0"

lib/src/bot.rs

@@ -0,0 +1,47 @@
+use strafesnet_roblox_bot_file::v0;
+use strafesnet_common::physics::{Time as PhysicsTime};
+
+/// A loaded bot file.
+pub struct CompleteBot{
+	//Instructions
+	timelines:v0::Block,
+	time_base:PhysicsTime,
+	duration:PhysicsTime,
+}
+impl CompleteBot{
+	pub(crate) const CAMERA_OFFSET:glam::Vec3=glam::vec3(0.0,2.0,0.0);
+	pub fn new(
+		timelines:v0::Block,
+	)->Self{
+		let first=timelines.output_events.first().unwrap();
+		let last=timelines.output_events.last().unwrap();
+		Self{
+			time_base:crate::time::from_float(first.time).unwrap(),
+			duration:crate::time::from_float(last.time-first.time).unwrap(),
+			timelines,
+		}
+	}
+	pub const fn time_base(&self)->PhysicsTime{
+		self.time_base
+	}
+	pub const fn duration(&self)->PhysicsTime{
+		self.duration
+	}
+	pub const fn timelines(&self)->&v0::Block{
+		&self.timelines
+	}
+	pub fn run_duration(&self,mode_id:v0::ModeID)->Option<PhysicsTime>{
+		let mut it=self.timelines.run_events.iter().rev();
+		let end=it.find_map(|event|match &event.event{
+			v0::RunEvent::Finish(run_start_event) if run_start_event.mode==mode_id=>Some(event.time),
+			_=>None,
+		})?;
+		let start=it.find_map(|event|match &event.event{
+			v0::RunEvent::Start(run_start_event) if run_start_event.mode==mode_id=>Some(event.time),
+			_=>None,
+		})?;
+		let start=crate::time::from_float(start).unwrap();
+		let end=crate::time::from_float(end).unwrap();
+		Some(end-start)
+	}
+}

lib/src/graphics.rs

@@ -0,0 +1,51 @@
+use strafesnet_graphics::graphics::GraphicsState;
+
+/// The graphics state, essentially a handle to all the information on the GPU.
+pub struct Graphics{
+	graphics:GraphicsState,
+	config:wgpu::SurfaceConfiguration,
+	device:wgpu::Device,
+	queue:wgpu::Queue,
+}
+impl Graphics{
+	pub fn new(device:wgpu::Device,queue:wgpu::Queue,config:wgpu::SurfaceConfiguration)->Self{
+		let mut graphics=strafesnet_graphics::graphics::GraphicsState::new(&device,&queue,&config);
+		graphics.resize(&device,&config,glam::Vec2::ONE);
+		Self{
+			graphics,
+			device,
+			queue,
+			config,
+		}
+	}
+	pub fn change_map(&mut self,map:&strafesnet_common::map::CompleteMap){
+		self.graphics.clear();
+		self.graphics.generate_models(&self.device,&self.queue,map);
+	}
+	pub fn resize(&mut self,surface:&wgpu::Surface<'_>,size:glam::UVec2){
+		self.config.width=size.x.max(1);
+		self.config.height=size.y.max(1);
+		surface.configure(&self.device,&self.config);
+		self.graphics.resize(&self.device,&self.config,glam::Vec2::ONE);
+	}
+	pub fn render(&mut self,surface:&wgpu::Surface<'_>,pos:glam::Vec3,angles:glam::Vec2){
+		//this has to go deeper somehow
+		let frame=match surface.get_current_texture(){
+			Ok(frame)=>frame,
+			Err(_)=>{
+				surface.configure(&self.device,&self.config);
+				surface
+					.get_current_texture()
+					.expect("Failed to acquire next surface texture!")
+			}
+		};
+		let view=frame.texture.create_view(&wgpu::TextureViewDescriptor{
+			format:Some(self.config.view_formats[0]),
+			..wgpu::TextureViewDescriptor::default()
+		});
+
+		self.graphics.render(&view,&self.device,&self.queue,strafesnet_graphics::graphics::view_inv(pos,angles));
+
+		frame.present();
+	}
+}

lib/src/head.rs

@@ -0,0 +1,118 @@
+use glam::Vec3Swizzles;
+use strafesnet_common::timer::{Scaled,Timer,TimerState};
+use strafesnet_common::session::{Time as SessionTime,TimeInner as SessionTimeInner};
+use strafesnet_common::physics::{Time as PhysicsTime,TimeInner as PhysicsTimeInner};
+use strafesnet_roblox_bot_file::v0::{EventType,Head,Timed};
+
+use crate::bot::CompleteBot;
+use crate::state::PlaybackState;
+
+fn vector3_to_glam(v:&strafesnet_roblox_bot_file::v0::Vector3)->glam::Vec3{
+	glam::vec3(v.x,v.y,v.z)
+}
+
+/// A playback context.  Advance time and then generate a camera position to pass to the renderer.
+pub struct PlaybackHead{
+	head:Head,
+	loop_offset:PhysicsTime,
+	timer:Timer<Scaled<SessionTimeInner,PhysicsTimeInner>>,
+	state:PlaybackState,
+}
+const HEAD_NO_CRASH:Head={
+	let mut head=Head::new();
+	// push one output event so that output-1 doesn't underflow
+	head.push(EventType::Output);
+	head
+};
+impl PlaybackHead{
+	pub fn new(time:SessionTime)->Self{
+		let timer=Timer::unpaused(time,PhysicsTime::ZERO);
+		Self{
+			head:HEAD_NO_CRASH,
+			loop_offset:PhysicsTime::ZERO,
+			timer,
+			state:PlaybackState::new(),
+		}
+	}
+	pub const fn state(&self)->&PlaybackState{
+		&self.state
+	}
+	pub fn time(&self,bot:&CompleteBot,time:SessionTime)->PhysicsTime{
+		bot.time_base()+self.timer.time(time)+self.loop_offset
+	}
+	pub fn next_event(&self,bot:&CompleteBot)->Option<Timed<EventType>>{
+		self.head.next_event(bot.timelines())
+	}
+	pub fn process_event(&mut self,bot:&CompleteBot,event_type:EventType){
+		self.state.process_event(bot,event_type,self.head.get_event_index(event_type));
+		self.head.push(event_type);
+	}
+	pub fn set_paused(&mut self,time:SessionTime,paused:bool){
+		_=self.timer.set_paused(time,paused);
+	}
+	pub fn seek_backward(&mut self,time:SessionTime){
+		let (mut state,paused)=self.timer.clone().into_state();
+		let offset=state.get_offset()-time.coerce();
+		state.set_offset(offset);
+		self.timer=Timer::from_state(state,paused);
+		// reset head
+		self.head=HEAD_NO_CRASH;
+	}
+	pub fn seek_forward(&mut self,time:SessionTime){
+		let (mut state,paused)=self.timer.clone().into_state();
+		let offset=state.get_offset()+time.coerce();
+		state.set_offset(offset);
+		self.timer=Timer::from_state(state,paused);
+	}
+	pub fn set_scale(&mut self,time:SessionTime,new_scale:strafesnet_common::integer::Ratio64){
+		self.timer.set_scale(time,new_scale);
+	}
+	pub fn advance_time(&mut self,bot:&CompleteBot,time:SessionTime){
+		let mut simulation_time=self.time(bot,time);
+		let mut time_float=simulation_time.get() as f64/PhysicsTime::ONE_SECOND.get() as f64;
+		loop{
+			match self.next_event(bot){
+				Some(next_event)=>{
+					if next_event.time<time_float{
+						self.process_event(bot,next_event.event);
+					}else{
+						break;
+					}
+				},
+				None=>{
+					//reset playback
+					self.head=HEAD_NO_CRASH;
+					self.loop_offset-=bot.duration();
+					simulation_time-=bot.duration();
+					time_float=simulation_time.get() as f64/PhysicsTime::ONE_SECOND.get() as f64;
+				},
+			}
+		}
+	}
+	pub fn get_position_angles(&self,bot:&CompleteBot,time:SessionTime)->(glam::Vec3,glam::Vec2){
+		let time=self.time(bot,time);
+		let event0=&bot.timelines().output_events[self.head.get_event_index(EventType::Output)-1];
+		let event1=&bot.timelines().output_events[self.head.get_event_index(EventType::Output)];
+		let p0=vector3_to_glam(&event0.event.position);
+		let p1=vector3_to_glam(&event1.event.position);
+		// let v0=vector3_to_glam(&event0.event.velocity);
+		// let v1=vector3_to_glam(&event1.event.velocity);
+		// let a0=vector3_to_glam(&event0.event.acceleration);
+		// let a1=vector3_to_glam(&event1.event.acceleration);
+		let t0=event0.time;
+		let t1=event1.time;
+		let time_float=time.get() as f64/PhysicsTime::ONE_SECOND.get() as f64;
+		let t=((time_float-t0)/(t1-t0)) as f32;
+		let p=p0.lerp(p1,t);
+		// let v=v0.lerp(v1,t);
+		// let a=a0.lerp(a1,t);
+
+		//println!("position={:?}",p);
+
+		let angles0=vector3_to_glam(&event0.event.angles);
+		let angles1=vector3_to_glam(&event1.event.angles);
+		let angles=angles0.lerp(angles1,t);
+
+		(p+CompleteBot::CAMERA_OFFSET,angles.yx())
+	}
+}

lib/src/lib.rs

@@ -0,0 +1,15 @@
+pub mod bot;
+pub mod head;
+pub mod time;
+pub mod state;
+// pub mod surface;
+pub mod graphics;
+
+// Create Surface
+// Create Graphics from map file and with surface as sample
+// Create bot from bot file
+// Create playback head
+// loop{
+// 		advance head
+// 		render frame
+// }

lib/src/state.rs

@@ -0,0 +1,210 @@
+use std::collections::HashMap;
+
+use strafesnet_common::run;
+use strafesnet_common::physics::Time as PhysicsTime;
+use strafesnet_roblox_bot_file::v0;
+
+use crate::bot::CompleteBot;
+
+pub struct Run{
+	run:run::RunState,
+	flag_reason:Option<v0::FlagReason>,
+}
+impl Run{
+	fn new()->Self{
+		Self{
+			run:run::RunState::Created,
+			flag_reason:None,
+		}
+	}
+	fn flag(&mut self,flag_reason:v0::FlagReason){
+		if self.flag_reason.is_none(){
+			self.flag_reason=Some(flag_reason);
+		}
+	}
+	pub fn time(&self,time:PhysicsTime)->run::Time{
+		self.run.time(time)
+	}
+	pub fn is_invalid(&self)->bool{
+		self.flag_reason.is_some()
+	}
+	pub fn is_in_progress(&self)->bool{
+		matches!(&self.run,run::RunState::Started{..})
+	}
+	pub fn is_finished(&self)->bool{
+		matches!(&self.run,run::RunState::Finished{..})
+	}
+	pub fn get_flag_reason_text(&self)->Option<&'static str>{
+		Some(match self.flag_reason{
+			Some(v0::FlagReason::Anticheat)=>"Passed through anticheat zone.",
+			Some(v0::FlagReason::StyleChange)=>"Changed style.",
+			Some(v0::FlagReason::Clock)=>"Incorrect clock.  (This can be caused by internet hiccups)",
+			Some(v0::FlagReason::Pause)=>"Pausing is not allowed in this style.",
+			Some(v0::FlagReason::Flying)=>"Flying is not allowed in this style.",
+			Some(v0::FlagReason::Gravity)=>"Gravity modification is not allowed in this style.",
+			Some(v0::FlagReason::Timescale)=>"Timescale is not allowed in this style.",
+			Some(v0::FlagReason::Timetravel)=>"Time travel is not allowed in this style.",
+			Some(v0::FlagReason::Teleport)=>"Illegal teleport.",
+			Some(v0::FlagReason::Practice)=>"Practice mode triggers invalidation.",
+			None=>return None,
+		})
+	}
+}
+
+pub struct PlaybackState{
+	// EventType::Input
+	game_controls:v0::GameControls,
+	mouse_pos:v0::Vector2,
+	// EventType::Output
+	jump_count:u32,
+	// EventType::Sound
+	// EventType::World
+	// EventType::Gravity
+	gravity:v0::Vector3,
+	// EventType::Run
+	runs:HashMap<v0::ModeID,Run>,
+	style:v0::Style,
+	// EventType::Camera
+	// TODO: camera punch
+	// EventType::Setting
+	absolute_sensitivity_enabled:bool,
+	fov_y:f64,
+	sens_x:f64,
+	vertical_sensitivity_multipler:f64,
+	turn_speed:f64,
+}
+impl PlaybackState{
+	pub fn new()->Self{
+		Self{
+			game_controls:v0::GameControls::empty(),
+			mouse_pos:v0::Vector2{x:0.0,y:0.0},
+			jump_count:0,
+			gravity:v0::Vector3{x:0.0,y:0.0,z:0.0},
+			runs:HashMap::new(),
+			style:v0::Style::Autohop,
+			absolute_sensitivity_enabled:false,
+			fov_y:1.0,
+			sens_x:1.0,
+			vertical_sensitivity_multipler:1.0,
+			turn_speed:1.0,
+		}
+	}
+	pub fn get_run(&self,mode:v0::ModeID)->Option<&Run>{
+		self.runs.get(&mode)
+	}
+	fn push_output(&mut self,event:&v0::OutputEvent){
+		if event.tick_info.contains(v0::TickInfo::Jump){
+			self.jump_count+=1;
+		}
+	}
+	fn push_input(&mut self,event:&v0::InputEvent){
+		self.game_controls=event.game_controls;
+		self.mouse_pos=event.mouse_pos;
+	}
+	fn push_gravity(&mut self,event:&v0::GravityEvent){
+		self.gravity=event.gravity;
+	}
+	fn push_run(&mut self,event:&v0::Timed<v0::RunEvent>){
+		match &event.event{
+			v0::RunEvent::Prepare(run_event_prepare)=>{
+				self.runs.insert(run_event_prepare.mode,Run::new());
+				self.style=run_event_prepare.style;
+			},
+			v0::RunEvent::Start(run_event_zone)=>{
+				let time=PhysicsTime::raw((event.time*PhysicsTime::ONE_SECOND.get() as f64) as i64);
+				if let Some(run)=self.runs.get_mut(&run_event_zone.mode){
+					_=run.run.start(time);
+				}
+			},
+			v0::RunEvent::Finish(run_event_zone)=>{
+				let time=PhysicsTime::raw((event.time*PhysicsTime::ONE_SECOND.get() as f64) as i64);
+				if let Some(run)=self.runs.get_mut(&run_event_zone.mode){
+					_=run.run.finish(time);
+				}
+			},
+			v0::RunEvent::Clear(run_event_clear)=>{
+				match run_event_clear.mode{
+					v0::ModeSpec::Exactly(mode_id)=>{
+						self.runs.remove(&mode_id);
+					},
+					v0::ModeSpec::All=>{
+						self.runs.clear();
+					},
+					v0::ModeSpec::Invalid=>{
+						self.runs.retain(|_,run|!run.is_invalid());
+					},
+					v0::ModeSpec::InProgress=>{
+						self.runs.retain(|_,run|!run.is_in_progress());
+					},
+				}
+			},
+			v0::RunEvent::Flag(run_event_flag)=>{
+				match run_event_flag.mode{
+					v0::ModeSpec::Exactly(mode_id)=>{
+						if let Some(run)=self.runs.get_mut(&mode_id){
+							run.flag(run_event_flag.flag_reason);
+						}
+					},
+					v0::ModeSpec::All=>{
+						for run in self.runs.values_mut(){
+							run.flag(run_event_flag.flag_reason);
+						}
+					},
+					v0::ModeSpec::Invalid=>{
+						for run in self.runs.values_mut(){
+							if run.is_invalid(){
+								run.flag(run_event_flag.flag_reason);
+							}
+						}
+					},
+					v0::ModeSpec::InProgress=>{
+						for run in self.runs.values_mut(){
+							if run.is_in_progress(){
+								run.flag(run_event_flag.flag_reason);
+							}
+						}
+					},
+				}
+			},
+			// these should never appear in a uploaded bot file,
+			// they are just part of the network protocol for spectating
+			// someone in practice mode.
+			//
+			// Yes, this is a design mistake.
+			// I didn't understand Session vs Simulation when I rewrote bhop in 2022
+			v0::RunEvent::LoadState(_run_event_practice)=>{},
+			v0::RunEvent::SaveState(_run_event_practice)=>{},
+		}
+	}
+	fn push_setting(&mut self,event:&v0::SettingEvent){
+		match event{
+			v0::SettingEvent::FieldOfView(setting_event_field_of_view)=>{
+				self.fov_y=setting_event_field_of_view.fov;
+			},
+			v0::SettingEvent::Sensitivity(setting_event_sensitivity)=>{
+				self.sens_x=setting_event_sensitivity.sensitivity;
+			},
+			v0::SettingEvent::VerticalSensitivityMultiplier(setting_event_vertical_sensitivity_multiplier)=>{
+				self.vertical_sensitivity_multipler=setting_event_vertical_sensitivity_multiplier.multiplier;
+			},
+			v0::SettingEvent::AbsoluteSensitivity(setting_event_absolute_sensitivity)=>{
+				self.absolute_sensitivity_enabled=setting_event_absolute_sensitivity.enabled;
+			},
+			v0::SettingEvent::TurnSpeed(setting_event_turn_speed)=>{
+				self.turn_speed=setting_event_turn_speed.turn_speed;
+			},
+		}
+	}
+	pub(crate) fn process_event(&mut self,bot:&CompleteBot,event_type:v0::EventType,event_index:usize){
+		match event_type{
+			v0::EventType::Input=>self.push_input(&bot.timelines().input_events[event_index].event),
+			v0::EventType::Output=>self.push_output(&bot.timelines().output_events[event_index].event),
+			v0::EventType::Sound=>{},
+			v0::EventType::World=>{},
+			v0::EventType::Gravity=>self.push_gravity(&bot.timelines().gravity_events[event_index].event),
+			v0::EventType::Run=>self.push_run(&bot.timelines().run_events[event_index]),
+			v0::EventType::Camera=>{},
+			v0::EventType::Setting=>self.push_setting(&bot.timelines().setting_events[event_index].event),
+		}
+	}
+}

lib/src/surface.rs

@@ -0,0 +1,2 @@
+/// A render surface configuration, containing information such as resolution and pixel format
+pub struct Surface{}

lib/src/time.rs

@@ -0,0 +1,32 @@
+use strafesnet_common::integer::Time;
+
+#[derive(Debug)]
+pub enum Error{
+	Underflow,
+	Overflow,
+	Nan,
+}
+impl std::fmt::Display for Error{
+	fn fmt(&self,f:&mut std::fmt::Formatter<'_>)->std::fmt::Result{
+		write!(f,"{self:?}")
+	}
+}
+impl std::error::Error for Error{}
+
+pub fn from_float<T>(time:f64)->Result<Time<T>,Error>{
+	match time.classify(){
+		core::num::FpCategory::Nan=>Err(Error::Nan),
+		core::num::FpCategory::Zero=>Ok(Time::ZERO),
+		core::num::FpCategory::Infinite
+		|core::num::FpCategory::Subnormal
+		|core::num::FpCategory::Normal=>{
+			if time<Time::<T>::MIN.get() as f64{
+				return Err(Error::Underflow);
+			}
+			if (Time::<T>::MAX.get() as f64)<time{
+				return Err(Error::Overflow);
+			}
+			Ok(Time::raw((time*Time::<T>::ONE_SECOND.get() as f64) as i64))
+		}
+	}
+}

native-player/Cargo.toml

@@ -4,4 +4,13 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
+ratio_from_float = { version = "0.1.0", path = "../ratio_from_float" }
 strafesnet_roblox_bot_player = { version = "0.1.0", path = "../lib" }
+pollster = "0.4.0"
+wgpu = "28.0.0"
+winit = "0.30.12"
+strafesnet_common.workspace = true
+strafesnet_graphics.workspace = true
+strafesnet_roblox_bot_file.workspace = true
+strafesnet_snf.workspace = true
+glam = "0.31.0"

native-player/src/app.rs

@@ -0,0 +1,68 @@
+use crate::window::Instruction;
+use strafesnet_common::integer;
+use strafesnet_common::instruction::TimedInstruction;
+use crate::window::WindowContext;
+
+pub struct App<'a>{
+	root_time:std::time::Instant,
+	window_thread:WindowContext<'a>,
+}
+impl<'a> App<'a>{
+	pub fn new(
+		root_time:std::time::Instant,
+		window_thread:WindowContext<'a>,
+	)->App<'a>{
+		Self{
+			root_time,
+			window_thread,
+		}
+	}
+	fn send_timed_instruction(&mut self,instruction:Instruction){
+		let time=integer::Time::from_nanos(self.root_time.elapsed().as_nanos() as i64);
+		self.window_thread.send(TimedInstruction{time,instruction});
+	}
+}
+impl winit::application::ApplicationHandler for App<'_>{
+	fn resumed(&mut self,_event_loop:&winit::event_loop::ActiveEventLoop){
+		//
+	}
+
+	fn window_event(
+		&mut self,
+		event_loop:&winit::event_loop::ActiveEventLoop,
+		_window_id:winit::window::WindowId,
+		event:winit::event::WindowEvent,
+	){
+		match event{
+			winit::event::WindowEvent::KeyboardInput{
+				event:winit::event::KeyEvent{
+					logical_key:winit::keyboard::Key::Named(winit::keyboard::NamedKey::Escape),
+					state:winit::event::ElementState::Pressed,
+					..
+				},
+				..
+			}
+			|winit::event::WindowEvent::CloseRequested=>{
+				event_loop.exit();
+			},
+			_=>(),
+		}
+		self.send_timed_instruction(Instruction::WindowEvent(event));
+	}
+
+	fn device_event(
+		&mut self,
+		_event_loop:&winit::event_loop::ActiveEventLoop,
+		_device_id:winit::event::DeviceId,
+		event:winit::event::DeviceEvent,
+	){
+		self.send_timed_instruction(Instruction::DeviceEvent(event));
+	}
+
+	fn about_to_wait(
+		&mut self,
+		_event_loop:&winit::event_loop::ActiveEventLoop
+	){
+		self.send_timed_instruction(Instruction::WindowEvent(winit::event::WindowEvent::RedrawRequested));
+	}
+}

native-player/src/file.rs

@@ -0,0 +1,68 @@
+use std::io::Read;
+
+#[expect(dead_code)]
+#[derive(Debug)]
+pub enum ReadError{
+	StrafesNET(strafesnet_snf::Error),
+	StrafesNETMap(strafesnet_snf::map::Error),
+	RobloxBot(strafesnet_roblox_bot_file::v0::Error),
+	Io(std::io::Error),
+	UnknownFileFormat,
+}
+impl std::fmt::Display for ReadError{
+	fn fmt(&self,f:&mut std::fmt::Formatter<'_>)->std::fmt::Result{
+		write!(f,"{self:?}")
+	}
+}
+impl std::error::Error for ReadError{}
+
+pub enum ReadFormat{
+	SNFM(strafesnet_common::map::CompleteMap),
+	QBOT(strafesnet_roblox_bot_file::v0::Block),
+}
+
+pub fn read<R:Read+std::io::Seek>(input:R)->Result<ReadFormat,ReadError>{
+	let mut buf=std::io::BufReader::new(input);
+	let peek=std::io::BufRead::fill_buf(&mut buf).map_err(ReadError::Io)?[0..4].to_owned();
+	// reading the entire file is way faster than round tripping the disk constantly
+	let mut entire_file=Vec::new();
+	buf.read_to_end(&mut entire_file).map_err(ReadError::Io)?;
+	let cursor=std::io::Cursor::new(entire_file);
+	match peek.as_slice(){
+		b"SNFM"=>Ok(ReadFormat::SNFM(
+			strafesnet_snf::read_map(cursor).map_err(ReadError::StrafesNET)?
+			.into_complete_map().map_err(ReadError::StrafesNETMap)?
+		)),
+		b"qbot"=>Ok(ReadFormat::QBOT(
+			strafesnet_roblox_bot_file::v0::read_all_to_block(cursor).map_err(ReadError::RobloxBot)?
+		)),
+		_=>Err(ReadError::UnknownFileFormat),
+	}
+}
+
+#[expect(dead_code)]
+#[derive(Debug)]
+pub enum LoadError{
+	ReadError(ReadError),
+	File(std::io::Error),
+}
+impl std::fmt::Display for LoadError{
+	fn fmt(&self,f:&mut std::fmt::Formatter<'_>)->std::fmt::Result{
+		write!(f,"{self:?}")
+	}
+}
+impl std::error::Error for LoadError{}
+
+pub enum LoadFormat{
+	Map(strafesnet_common::map::CompleteMap),
+	Bot(strafesnet_roblox_bot_file::v0::Block),
+}
+
+pub fn load<P:AsRef<std::path::Path>>(path:P)->Result<LoadFormat,LoadError>{
+	//blocking because it's simpler...
+	let file=std::fs::File::open(path).map_err(LoadError::File)?;
+	match read(file).map_err(LoadError::ReadError)?{
+		ReadFormat::QBOT(bot)=>Ok(LoadFormat::Bot(bot)),
+		ReadFormat::SNFM(map)=>Ok(LoadFormat::Map(map)),
+	}
+}

native-player/src/main.rs

@@ -1 +1,12 @@
-fn main() {}
+mod app;
+mod file;
+mod player;
+mod setup;
+mod window;
+
+
+const TITLE:&'static str=concat!("Roblox Bot Player v",env!("CARGO_PKG_VERSION"));
+
+fn main(){
+	pollster::block_on(setup::setup_and_start(TITLE));
+}

native-player/src/player.rs

@@ -0,0 +1,79 @@
+use strafesnet_common::instruction::TimedInstruction;
+use strafesnet_common::session::Time as SessionTime;
+use strafesnet_roblox_bot_player::{bot::CompleteBot,graphics::Graphics,head::PlaybackHead};
+
+pub enum SessionControlInstruction{
+	SetPaused(bool),
+	SkipForward,
+	SkipBack,
+	DecreaseTimescale,
+	IncreaseTimescale,
+}
+
+pub enum Instruction{
+	SessionControl(SessionControlInstruction),
+	Render,
+	Resize(winit::dpi::PhysicalSize<u32>),
+	ChangeMap(strafesnet_common::map::CompleteMap),
+	LoadReplay(strafesnet_roblox_bot_file::v0::Block),
+}
+
+pub struct PlayerWorker<'a>{
+	surface:wgpu::Surface<'a>,
+	graphics_thread:Graphics,
+	bot:Option<CompleteBot>,
+	playback_head:PlaybackHead,
+	playback_speed:i8,
+}
+impl<'a> PlayerWorker<'a>{
+	pub fn new(
+		surface:wgpu::Surface<'a>,
+		graphics_thread:Graphics,
+	)->Self{
+		let playback_head=PlaybackHead::new(SessionTime::ZERO);
+		Self{
+			surface,
+			graphics_thread,
+			bot:None,
+			playback_head,
+			playback_speed:0,
+		}
+	}
+	pub fn send(&mut self,ins:TimedInstruction<Instruction,SessionTime>){
+		match ins.instruction{
+			Instruction::SessionControl(SessionControlInstruction::SetPaused(paused))=>{
+				self.playback_head.set_paused(ins.time,paused);
+			},
+			Instruction::SessionControl(SessionControlInstruction::SkipForward)=>{
+				self.playback_head.seek_forward(SessionTime::from_secs(5));
+			},
+			Instruction::SessionControl(SessionControlInstruction::SkipBack)=>{
+				self.playback_head.seek_backward(SessionTime::from_secs(5));
+			},
+			Instruction::SessionControl(SessionControlInstruction::DecreaseTimescale)=>{
+				self.playback_speed=self.playback_speed.saturating_sub(1).max(-48);
+				let speed=2.0f64.powf(self.playback_speed as f64/3.0);
+				self.playback_head.set_scale(ins.time,ratio_from_float::ratio_from_f64(speed).unwrap());
+			},
+			Instruction::SessionControl(SessionControlInstruction::IncreaseTimescale)=>{
+				self.playback_speed=self.playback_speed.saturating_add(1).min(48);
+				let speed=2.0f64.powf(self.playback_speed as f64/3.0);
+				self.playback_head.set_scale(ins.time,ratio_from_float::ratio_from_f64(speed).unwrap());
+			},
+			Instruction::Render=>if let Some(bot)=&self.bot{
+				self.playback_head.advance_time(bot,ins.time);
+				let (pos,angles)=self.playback_head.get_position_angles(bot,ins.time);
+				self.graphics_thread.render(&self.surface,pos,angles);
+			},
+			Instruction::Resize(physical_size)=>{
+				self.graphics_thread.resize(&self.surface,glam::uvec2(physical_size.width,physical_size.height));
+			},
+			Instruction::ChangeMap(complete_map)=>{
+				self.graphics_thread.change_map(&complete_map);
+			},
+			Instruction::LoadReplay(bot)=>{
+				self.bot=Some(CompleteBot::new(bot));
+			},
+		}
+	}
+}

native-player/src/setup.rs

@@ -0,0 +1,51 @@
+use strafesnet_graphics::setup;
+
+fn create_window(title:&str,event_loop:&winit::event_loop::EventLoop<()>)->Result<winit::window::Window,winit::error::OsError>{
+	let mut attr=winit::window::WindowAttributes::default();
+	attr=attr.with_title(title);
+	event_loop.create_window(attr)
+}
+
+pub async fn setup_and_start(title:&str){
+	let event_loop=winit::event_loop::EventLoop::new().unwrap();
+
+	let window=create_window(title,&event_loop).unwrap();
+
+	println!("Initializing the surface...");
+
+	let instance=setup::step1::create_instance();
+
+	let surface=setup::step2::create_surface(&instance,&window).unwrap();
+
+	let adapter=setup::step3::pick_adapter(&instance,&surface).await.expect("No suitable GPU adapters found on the system!");
+
+	let (device,queue)=setup::step4::request_device(&adapter).await;
+
+	let size=window.inner_size();
+	let config=setup::step5::configure_surface(&adapter,&device,&surface,(size.width,size.height));
+
+	//dedicated thread to ping request redraw back and resize the window doesn't seem logical
+
+	//the thread that spawns the physics thread
+	let mut window_thread=crate::window::WindowContext::new(
+		&window,
+		device,
+		queue,
+		surface,
+		config,
+	);
+
+	for arg in std::env::args().skip(1){
+		window_thread.send(strafesnet_common::instruction::TimedInstruction{
+			time:strafesnet_common::integer::Time::ZERO,
+			instruction:crate::window::Instruction::WindowEvent(winit::event::WindowEvent::DroppedFile(arg.into())),
+		});
+	};
+
+	println!("Entering event loop...");
+	let mut app=crate::app::App::new(
+		std::time::Instant::now(),
+		window_thread
+	);
+	event_loop.run_app(&mut app).unwrap();
+}

native-player/src/window.rs

@@ -0,0 +1,138 @@
+use strafesnet_common::instruction::TimedInstruction;
+use strafesnet_common::session::Time as SessionTime;
+use strafesnet_common::physics::{MiscInstruction,SetControlInstruction};
+use crate::file::LoadFormat;
+use crate::player::{PlayerWorker,Instruction as PhysicsWorkerInstruction,SessionControlInstruction};
+
+pub enum Instruction{
+	WindowEvent(winit::event::WindowEvent),
+	DeviceEvent(winit::event::DeviceEvent),
+}
+
+//holds thread handles to dispatch to
+pub struct WindowContext<'a>{
+	simulation_paused:bool,
+	screen_size:glam::UVec2,
+	window:&'a winit::window::Window,
+	physics_thread:PlayerWorker<'a>,
+}
+
+impl WindowContext<'_>{
+	fn window_event(&mut self,time:SessionTime,event:winit::event::WindowEvent){
+		match event{
+			winit::event::WindowEvent::DroppedFile(path)=>{
+				match crate::file::load(path.as_path()){
+					Ok(LoadFormat::Map(map))=>self.physics_thread.send(TimedInstruction{time,instruction:PhysicsWorkerInstruction::ChangeMap(map)}),
+					Ok(LoadFormat::Bot(bot))=>self.physics_thread.send(TimedInstruction{time,instruction:PhysicsWorkerInstruction::LoadReplay(bot)}),
+					Err(e)=>println!("Failed to load file: {e}"),
+				}
+			},
+			winit::event::WindowEvent::Focused(state)=>{
+				// don't unpause if manually paused
+				if self.simulation_paused{
+					return;
+				}
+				//pause unpause
+				self.physics_thread.send(TimedInstruction{
+					time,
+					instruction:PhysicsWorkerInstruction::SessionControl(SessionControlInstruction::SetPaused(!state)),
+				});
+				//recalculate pressed keys on focus
+			},
+			winit::event::WindowEvent::KeyboardInput{
+				event:winit::event::KeyEvent{state,logical_key,repeat:false,..},
+				..
+			}=>{
+				match (logical_key,state){
+					(winit::keyboard::Key::Named(winit::keyboard::NamedKey::F11),winit::event::ElementState::Pressed)=>{
+						if self.window.fullscreen().is_some(){
+							self.window.set_fullscreen(None);
+						}else{
+							self.window.set_fullscreen(Some(winit::window::Fullscreen::Borderless(None)));
+						}
+					},
+					(keycode,state)=>{
+						let s=state.is_pressed();
+
+						macro_rules! session_ctrl{
+							($variant:ident,$state:expr)=>{
+								s.then_some(PhysicsWorkerInstruction::SessionControl(SessionControlInstruction::$variant))
+							};
+						}
+
+						if let Some(instruction)=match keycode{
+							winit::keyboard::Key::Named(winit::keyboard::NamedKey::Space)=>if s{
+								let paused=!self.simulation_paused;
+								self.simulation_paused=paused;
+								Some(PhysicsWorkerInstruction::SessionControl(SessionControlInstruction::SetPaused(paused)))
+							}else{None},
+							winit::keyboard::Key::Named(winit::keyboard::NamedKey::ArrowUp)=>session_ctrl!(IncreaseTimescale,s),
+							winit::keyboard::Key::Named(winit::keyboard::NamedKey::ArrowDown)=>session_ctrl!(DecreaseTimescale,s),
+							winit::keyboard::Key::Named(winit::keyboard::NamedKey::ArrowLeft)=>session_ctrl!(SkipBack,s),
+							winit::keyboard::Key::Named(winit::keyboard::NamedKey::ArrowRight)=>session_ctrl!(SkipForward,s),
+							_=>None,
+						}{
+							self.physics_thread.send(TimedInstruction{
+								time,
+								instruction,
+							});
+						}
+					},
+				}
+			},
+			winit::event::WindowEvent::Resized(size)=>{
+				self.physics_thread.send(
+					TimedInstruction{
+						time,
+						instruction:PhysicsWorkerInstruction::Resize(size)
+					}
+				);
+			},
+			winit::event::WindowEvent::RedrawRequested=>{
+				self.window.request_redraw();
+				self.physics_thread.send(
+					TimedInstruction{
+						time,
+						instruction:PhysicsWorkerInstruction::Render
+					}
+				);
+			},
+			_=>(),
+		}
+	}
+
+	fn device_event(&mut self,time:SessionTime,event:winit::event::DeviceEvent){
+	}
+
+	pub fn send(&mut self,ins:TimedInstruction<Instruction,SessionTime>){
+		match ins.instruction{
+			Instruction::WindowEvent(window_event)=>{
+				self.window_event(ins.time,window_event);
+			},
+			Instruction::DeviceEvent(device_event)=>{
+				self.device_event(ins.time,device_event);
+			},
+		}
+	}
+
+	pub fn new<'a>(
+		window:&'a winit::window::Window,
+		device:wgpu::Device,
+		queue:wgpu::Queue,
+		surface:wgpu::Surface<'a>,
+		config:wgpu::SurfaceConfiguration,
+	)->WindowContext<'a>{
+		let screen_size=glam::uvec2(config.width,config.height);
+		let graphics=strafesnet_roblox_bot_player::graphics::Graphics::new(device,queue,config);
+		WindowContext{
+			simulation_paused:false,
+			//make sure to update this!!!!!
+			screen_size,
+			window,
+			physics_thread:crate::player::PlayerWorker::new(
+				surface,
+				graphics,
+			),
+		}
+	}
+}

ratio_from_float/Cargo.toml

@@ -0,0 +1,7 @@
+[package]
+name = "ratio_from_float"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+strafesnet_common.workspace = true

ratio_from_float/src/lib.rs

@@ -0,0 +1,128 @@
+use strafesnet_common::integer::Ratio64;
+
+/// Convert an `f64` to a `Ratio64`.
+///
+/// Returns `None` for NaN, infinities, or when the exact fraction would overflow `i64`/`u64`.
+/// The result is always reduced to lowest terms.
+pub fn ratio_from_f64(x: f64) -> Option<Ratio64> {
+	// Handle special values first
+	match x.classify() {
+		core::num::FpCategory::Nan | core::num::FpCategory::Infinite => return None,
+		core::num::FpCategory::Zero => return Ratio64::new(0, 1),
+		core::num::FpCategory::Subnormal | core::num::FpCategory::Normal => {
+			if x < i64::MIN as f64 {
+				return None;
+			}
+			if (i64::MAX as f64) < x {
+				return None;
+			}
+		}
+	}
+
+	// 2️⃣ Pull out the raw bits
+	let bits: u64 = x.to_bits();
+	let sign: i64 = if (bits >> 63) != 0 { -1 } else { 1 };
+	let exp_raw: u32 = ((bits >> 52) & 0x7FF) as u32;
+	let mant: u64 = bits & 0xFFFFFFFFFFFFF; // 52 bits
+
+	// 3️⃣ Normalise exponent and mantissa
+	let (exp, mant) = if exp_raw == 0 {
+		// subnormal
+		(1 - 1023, mant) // unbiased exponent = -1022
+	} else {
+		// normal
+		((exp_raw as i32) - 1023, mant | (1 << 52)) // implicit leading 1
+	};
+
+	// value = sign * mant * 2^(exp-52)
+	let shift = exp - 52; // may be negative
+
+	// 4️⃣ Build numerator / denominator as 64‑bit values
+	// ────────────────────────────────────────
+	// If shift is positive → numerator = mant << shift
+	// If shift is negative → denominator = 1 << (-shift)
+	// We use the checked arithmetic helpers to catch overflow.
+	let (mut num, den) = if shift >= 0 {
+		// shift <= 63 because 53‑bit mantissa * 2^shift must fit in i64
+		let s = shift as u32;
+		let n = (mant as i64).checked_shl(s)?;
+		(n, 1)
+	} else {
+		// shift is negative
+		let s = (-shift) as u32;
+		if s > 63 {
+			// 2^s would not fit in a u64 → underflow
+			return Ratio64::new(0, 1);
+		}
+		(mant as i64, 1u64 << s)
+	};
+
+	// 5️⃣ Apply the sign
+	num *= sign;
+
+	Ratio64::new(num, den)
+}
+
+#[cfg(test)]
+mod tests {
+	use super::*;
+
+	#[test]
+	fn basic() {
+		let r = ratio_from_f64(1.5).unwrap();
+		assert_eq!(r.num(), 3);
+		assert_eq!(r.den(), 2);
+
+		let r = ratio_from_f64(0.1).unwrap();
+		// 0.1 = 3602879701896397 / 36028797018963968
+		assert_eq!(r.num(), 3602879701896397);
+		assert_eq!(r.den(), 36028797018963968);
+
+		let r = ratio_from_f64(-3.141592653589793).unwrap();
+		assert_eq!(r.num(), -884279719003555);
+		assert_eq!(r.den(), 281474976710656);
+
+		// NaN / Infinity → None
+		assert!(ratio_from_f64(f64::NAN).is_none());
+		assert!(ratio_from_f64(f64::INFINITY).is_none());
+	}
+
+	#[test]
+	fn overflow() {
+		// value that would need > 64‑bit numerator
+		let f = (i64::MAX as f64) * 2.0; // just above i64::MAX
+		assert!(ratio_from_f64(f).is_none());
+
+		// subnormal: denominator would need 2^1074 > u64::MAX
+		let sub = f64::MIN_POSITIVE / 2.0; // 2.22507e‑308 / 2 = 1.1125e‑308
+		assert_eq!(ratio_from_f64(sub).unwrap().num(), 0);
+	}
+
+	#[test]
+	fn test() {
+		let numbers = [
+			0.0,
+			-0.0,
+			1.0,
+			-1.0,
+			3.141592653589793,
+			1.5,
+			0.1,
+			2.225073858507201e-308, // subnormal
+			1.7976931348623157e308, // max normal
+		];
+
+		for f in numbers {
+			match ratio_from_f64(f) {
+				Some(r) => println!(
+					"{:>15} → {:>15} / {:>15}   (≈ {:.20})",
+					f,
+					r.num(),
+					r.den(),
+					f
+				),
+				None => println!("{:>15} → overflow / NaN / infinite", f),
+			}
+		}
+	}
+}

wasm-module/Cargo.toml

@@ -3,10 +3,20 @@ name = "strafesnet_roblox_bot_player_wasm_module"
 version = "0.1.0"
 edition = "2024"
 
+[lib]
+crate-type = ["cdylib"]
+
 [dependencies]
+ratio_from_float = { version = "0.1.0", path = "../ratio_from_float" }
 strafesnet_roblox_bot_player = { version = "0.1.0", path = "../lib" }
-wasm-bindgen = "0.2.108"
 strafesnet_common.workspace = true
 strafesnet_graphics.workspace = true
 strafesnet_roblox_bot_file.workspace = true
 strafesnet_snf.workspace = true
+wasm-bindgen = "0.2.108"
+wasm-bindgen-futures = "0.4.58"
+web-sys = { version = "0.3.85", features = ["HtmlCanvasElement"] }
+wgpu = "28.0.0"
+
+[package.metadata.wasm-pack.profile.release]
+wasm-opt = ["-Oz", "--enable-bulk-memory","--enable-nontrapping-float-to-int"]

wasm-module/src/lib.rs

@@ -0,0 +1,138 @@
+use wasm_bindgen::prelude::wasm_bindgen;
+use wasm_bindgen::JsValue;
+use strafesnet_roblox_bot_file::v0;
+use strafesnet_roblox_bot_player::{bot,head,time,graphics};
+use strafesnet_graphics::setup;
+use strafesnet_common::physics::Time as PhysicsTime;
+
+// Hack to keep the code compiling,
+// SurfaceTarget::Canvas is not available in IDE for whatever reason.
+struct ToSurfaceTarget(web_sys::HtmlCanvasElement);
+impl From<ToSurfaceTarget> for wgpu::SurfaceTarget<'static>{
+	fn from(ToSurfaceTarget(canvas):ToSurfaceTarget)->Self{
+		#[cfg(target_arch = "wasm32")]
+		let target=wgpu::SurfaceTarget::Canvas(canvas);
+		#[expect(unused)]
+		#[cfg(not(target_arch = "wasm32"))]
+		let target=panic!("{canvas:?}");
+		#[allow(unused)]
+		target
+	}
+}
+
+#[wasm_bindgen]
+pub struct Graphics{
+	graphics:graphics::Graphics,
+	surface:wgpu::Surface<'static>,
+}
+#[wasm_bindgen]
+pub async fn setup_graphics(canvas:web_sys::HtmlCanvasElement)->Graphics{
+	let size=(canvas.width(),canvas.height());
+
+	let instance=setup::step1::create_instance();
+	let surface=setup::step2::create_surface(&instance,ToSurfaceTarget(canvas)).unwrap();
+	let adapter=setup::step3::pick_adapter(&instance,&surface).await.expect("No suitable GPU adapters found on the system!");
+	let (device,queue)=setup::step4::request_device(&adapter).await;
+	let config=setup::step5::configure_surface(&adapter,&device,&surface,size);
+	Graphics{
+		graphics:graphics::Graphics::new(device,queue,config),
+		surface:surface,
+	}
+}
+#[wasm_bindgen]
+impl Graphics{
+	#[wasm_bindgen]
+	pub fn render(&mut self,bot:&CompleteBot,head:&PlaybackHead,time:f64){
+		let time=time::from_float(time).unwrap();
+		let (pos,angles)=head.head.get_position_angles(&bot.bot,time);
+		self.graphics.render(&self.surface,pos,angles);
+	}
+	#[wasm_bindgen]
+	pub fn resize(&mut self,width:u32,height:u32){
+		self.graphics.resize(&self.surface,[width,height].into());
+	}
+	#[wasm_bindgen]
+	pub fn change_map(&mut self,map:&CompleteMap){
+		self.graphics.change_map(&map.map);
+	}
+}
+
+#[wasm_bindgen]
+pub struct CompleteBot{
+	bot:bot::CompleteBot,
+}
+#[wasm_bindgen]
+impl CompleteBot{
+	#[wasm_bindgen(constructor)]
+	pub fn new(data:&[u8])->Result<Self,JsValue>{
+		let timelines=v0::read_all_to_block(std::io::Cursor::new(data)).map_err(|e|JsValue::from_str(&e.to_string()))?;
+		Ok(Self{
+			bot:bot::CompleteBot::new(timelines),
+		})
+	}
+	#[wasm_bindgen]
+	pub fn duration(&self)->f64{
+		self.bot.duration().get() as f64/PhysicsTime::ONE_SECOND.get() as f64
+	}
+	#[wasm_bindgen]
+	pub fn run_duration(&self,mode_id:u32)->Option<f64>{
+		let mode=v0::ModeID(mode_id);
+		Some(self.bot.run_duration(mode)?.get() as f64/PhysicsTime::ONE_SECOND.get() as f64)
+	}
+}
+
+#[wasm_bindgen]
+pub struct CompleteMap{
+	map:strafesnet_common::map::CompleteMap,
+}
+#[wasm_bindgen]
+impl CompleteMap{
+	#[wasm_bindgen(constructor)]
+	pub fn new(data:&[u8])->Result<Self,JsValue>{
+		let map=strafesnet_snf::read_map(std::io::Cursor::new(data))
+			.map_err(|e|JsValue::from_str(&e.to_string()))?
+			.into_complete_map()
+			.map_err(|e|JsValue::from_str(&e.to_string()))?;
+		Ok(Self{
+			map,
+		})
+	}
+}
+
+#[wasm_bindgen]
+pub struct PlaybackHead{
+	head:head::PlaybackHead,
+}
+#[wasm_bindgen]
+impl PlaybackHead{
+	#[wasm_bindgen(constructor)]
+	pub fn new(time:f64)->Result<Self,JsValue>{
+		let time=time::from_float(time).unwrap();
+		Ok(Self{
+			head:head::PlaybackHead::new(time),
+		})
+	}
+	#[wasm_bindgen]
+	pub fn advance_time(&mut self,bot:&CompleteBot,time:f64){
+		let time=time::from_float(time).unwrap();
+		self.head.advance_time(&bot.bot,time);
+	}
+	#[wasm_bindgen]
+	pub fn get_run_time(&self,bot:&CompleteBot,time:f64,mode_id:u32)->Option<f64>{
+		let time=time::from_float(time).unwrap();
+		let time=self.head.time(&bot.bot,time);
+		let mode=v0::ModeID(mode_id);
+		let run_time=self.head.state().get_run(mode)?.time(time);
+		Some(run_time.get() as f64/strafesnet_common::run::Time::ONE_SECOND.get() as f64)
+	}
+	#[wasm_bindgen]
+	pub fn is_run_in_progress(&self,mode_id:u32)->Option<bool>{
+		let mode=v0::ModeID(mode_id);
+		Some(self.head.state().get_run(mode)?.is_in_progress())
+	}
+	#[wasm_bindgen]
+	pub fn is_run_finished(&self,mode_id:u32)->Option<bool>{
+		let mode=v0::ModeID(mode_id);
+		Some(self.head.state().get_run(mode)?.is_finished())
+	}
+}

web-demo/.gitattributes

@@ -0,0 +1,2 @@
+bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d.qbot filter=lfs diff=lfs merge=lfs -text
+bhop_marble_5692093612.snfm filter=lfs diff=lfs merge=lfs -text

web-demo/iframe-helper.js

@@ -0,0 +1,13 @@
+if (window.frameElement) {
+	const body = document.body;
+	const observer = new ResizeObserver(() => {
+		window.parent.postMessage({
+			cmd: "resize",
+			data: {
+				width: body.scrollWidth,
+				height: body.scrollHeight,
+			},
+		});
+	});
+	observer.observe(body);
+}

web-demo/index.html

@@ -0,0 +1,54 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta
+			name="viewport"
+			content="width=device-width, initial-scale=1, shrink-to-fit=no"
+		/>
+		<title>StrafesNET Roblox Bot Player Demo</title>
+		<style>
+			:root {
+				color-scheme: light dark;
+			}
+			html,
+			body {
+				margin: 0px;
+				width: 100%;
+				height: 100%;
+				overflow: hidden;
+			}
+			canvas {
+				margin: 0;
+				width: 100%;
+				height: 100%;
+			}
+			.hud {
+				position: fixed;
+				bottom: 10px;
+				left: 10px;
+				display: flex;
+				flex-direction: column; /* stack vertically */
+				gap: 4px; /* space between timers */
+			}
+
+			.timer {
+				background: #000;
+				color: #fff;
+				padding: 4px 8px;
+				font-family: sans-serif;
+				font-size: 14px;
+				border-radius: 3px;
+			}
+		</style>
+		<script defer src="player.js" type="module"></script>
+		<script defer type="module" src="iframe-helper.js"></script>
+	</head>
+	<body>
+		<canvas id="viewport"> </canvas>
+		<div class="hud">
+			<div id="duration" class="timer">00:00:00</div>
+			<div id="timer" class="timer">00:00:00</div>
+		</div>
+	</body>
+</html>

web-demo/player.js

@@ -0,0 +1,63 @@
+import init, {
+	setup_graphics,
+	CompleteBot,
+	CompleteMap,
+	PlaybackHead,
+} from "./pkg/strafesnet_roblox_bot_player_wasm_module.js";
+
+await init(); // load the wasm module
+
+const b = await fetch("bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d.qbot");
+const m = await fetch("bhop_marble_5692093612.snfm");
+
+const canvas = document.getElementById("viewport");
+
+const graphics = await setup_graphics(canvas);
+const bot = new CompleteBot(new Uint8Array(await b.arrayBuffer()));
+const map = new CompleteMap(new Uint8Array(await m.arrayBuffer()));
+const playback = new PlaybackHead(0);
+
+graphics.change_map(map);
+
+const startTime = performance.now();
+const timer = document.getElementById("timer");
+const duration = document.getElementById("duration");
+const MODE_MAIN = 0;
+
+function timer_text(t) {
+	const h = Math.floor(t / 3600);
+	const m = Math.floor((t % 3600) / 60);
+	const s = Math.floor(t % 60);
+	const ms = Math.floor((t % 1) * 1000);
+	return `${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}.${String(ms).padStart(3, "0")}`;
+}
+
+duration.textContent = timer_text(bot.run_duration(MODE_MAIN));
+
+function animate(now) {
+	const elapsedMs = now - startTime;
+	const elapsedSec = elapsedMs / 1000; // wasm expects seconds
+
+	// Advance the playback head to the current time
+	playback.advance_time(bot, elapsedSec);
+
+	// update the timer text
+	const time = playback.get_run_time(bot, elapsedSec, MODE_MAIN);
+	timer.textContent = timer_text(time);
+
+	// Render the frame that the bot is at that time
+	graphics.render(bot, playback, elapsedSec);
+
+	// Keep the loop going
+	requestAnimationFrame(animate);
+}
+
+requestAnimationFrame(animate);
+
+function resize() {
+	canvas.width = canvas.clientWidth;
+	canvas.height = canvas.clientHeight;
+	graphics.resize(canvas.width, canvas.height);
+}
+window.addEventListener("resize", resize);
+resize();