55 Commits

Author SHA1 Message Date
c807fd98e6 v0.9.4 Head::partition_point 2026-03-18 09:00:31 -07:00
d108697552 new Head constructor 2026-03-18 08:58:20 -07:00
0cd02fbb75 v0.9.3 fix Head::after_time 2026-02-27 08:33:57 -08:00
3674bb38b3 slightly wrong 2026-02-27 08:33:40 -08:00
3323b0109a v0.9.2 fix Head::after_Time 2026-02-27 07:31:18 -08:00
8c776f29b0 plain wrong 2026-02-27 07:30:51 -08:00
87ba477f63 v0.9.1 Head fns 2026-02-27 06:42:10 -08:00
508a0db66f add functions to Head 2026-02-27 06:39:19 -08:00
e88d62c3ea v0.9.0 event enum un-unification + exposed Head 2026-02-20 07:06:32 -08:00
1b6b02ef5a expose Head mechanism for bot player 2026-02-20 07:04:14 -08:00
dc87100e91 impl Copy for Vector types 2026-02-20 07:03:44 -08:00
224a873d89 un-unify setting event to name fields 2026-02-13 10:06:47 -08:00
3cf39032cc const trey float convert 2026-02-13 10:05:25 -08:00
0c896f3ee1 doc RunPrepareEvent 2026-02-13 07:21:32 -08:00
17edf88e05 un-unify camera event to name fields 2026-02-13 07:17:40 -08:00
42e91e3627 v0.8.1 serializer 2025-12-15 15:09:51 -08:00
f9c5ef7b44 Implement Serializer (#3)
Add an algorithm to generate a bot file from a set of timelines.

Reviewed-on: #3
Co-authored-by: Rhys Lloyd <krakow20@gmail.com>
Co-committed-by: Rhys Lloyd <krakow20@gmail.com>
2025-12-15 23:09:21 +00:00
b9aaf9d30f v0.8.0 drop itertools 2025-12-15 15:07:49 -08:00
8b365a0579 explicitly note that timelines must be sorted 2025-12-15 14:52:37 -08:00
71685468b6 reexport binrw::Error and make it appear in fn signatures 2025-12-15 14:48:43 -08:00
9ace707bbb refactor tests 2025-12-15 14:41:41 -08:00
7cb66719b0 add InvalidBlockId error 2025-12-15 14:41:24 -08:00
27aa3fb5d1 drop itertools dep (temporarily) 2025-12-15 14:30:07 -08:00
a6c10eab21 use correct trait bound 2025-12-14 11:42:44 -08:00
4ef063a474 merge impl blocks 2025-12-13 10:58:53 -08:00
03b5b8c239 v0.7.0 fix RunClear 2025-12-13 08:39:43 -08:00
488ce55990 fix RunClear 2025-12-13 08:37:56 -08:00
fe98210d10 v0.6.0 fix RunEvent 2025-12-13 08:05:25 -08:00
2eb282dfe2 update deps 2025-12-13 08:05:02 -08:00
c8ec986a2b Fix RunEvent (#2)
It was really wrong!

Reviewed-on: #2
Co-authored-by: Rhys Lloyd <krakow20@gmail.com>
Co-committed-by: Rhys Lloyd <krakow20@gmail.com>
2025-12-13 15:57:26 +00:00
a6ce331682 un-nest example code 2025-12-09 16:05:09 -08:00
6a6849ec79 update readme 2025-11-06 13:09:14 -08:00
8b52f0765f tweak test to remove cfg macro 2025-11-06 10:39:06 -08:00
8030308310 update readme 2025-11-06 10:20:35 -08:00
67bb41fa5e FileHeader::block_timelines_info 2025-11-06 10:20:35 -08:00
7659e941b9 read_offline_to_block + read_realtime_to_block 2025-11-06 10:08:27 -08:00
fd9ddd9ca8 v0.5.4 asymmetric Timed Ord 2025-11-06 16:37:17 +01:00
7f86d0edaf allow Ord comparison between different inner Timed types 2025-11-06 16:36:25 +01:00
6021177364 reduce verbosity in readme (feature is enabled by default) 2025-11-05 16:10:14 -08:00
eb26ba0593 move FileHeader magic 2025-11-05 15:01:48 -08:00
d4e94ab0da binrw tech 2025-11-05 10:56:41 -08:00
cdbb5e6b01 v0.5.3 tweak inner types + add more documentation 2025-11-05 10:56:41 -08:00
240a8798cd document more 2025-11-05 10:56:40 -08:00
7e0cb86a32 BlockInfo extends Range 2025-11-05 10:36:54 -08:00
9fdaf34df3 BlockPosition struct never used in a public interface 2025-11-05 10:24:31 -08:00
cc67966743 unused derives 2025-11-05 10:24:31 -08:00
9af3f4e6cf v0.5.2 derive more traits + relax Timed Ord 2025-11-05 09:56:24 -08:00
95b8fb2d95 add #[derive(Debug,Clone)] to everything 2025-11-05 09:54:08 -08:00
503710aa95 impl PartialEq & PartialOrd for all Timed events 2025-11-05 09:49:46 -08:00
fd59928644 v0.5.1 update deps 2025-11-05 09:29:54 -08:00
873ea5e9da update deps 2025-11-05 09:29:19 -08:00
f3768af543 v0.5.0 refactor 2025-11-05 09:26:43 -08:00
91d1ba68d4 refactor 2025-11-05 09:04:10 -08:00
3a13ae1642 v0.4.0 support multiple bonuses 2025-11-03 18:59:42 +01:00
f21b5f8c40 support multiple bonuses 2025-11-03 18:57:14 +01:00
6 changed files with 712 additions and 175 deletions

38
Cargo.lock generated
View File

@@ -10,9 +10,9 @@ checksum = "3d62b7694a562cdf5a74227903507c56ab2cc8bdd1f781ed5cb4cf9c9f810bfc"
[[package]]
name = "binrw"
version = "0.14.1"
version = "0.15.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7d4bca59c20d6f40c2cc0802afbe1e788b89096f61bdf7aeea6bf00f10c2909b"
checksum = "81419ff39e6ed10a92a7f125290859776ced35d9a08a665ae40b23e7ca702f30"
dependencies = [
"array-init",
"binrw_derive",
@@ -21,9 +21,9 @@ dependencies = [
[[package]]
name = "binrw_derive"
version = "0.14.1"
version = "0.15.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d8ba42866ce5bced2645bfa15e97eef2c62d2bdb530510538de8dd3d04efff3c"
checksum = "376404e55ec40d0d6f8b4b7df3f87b87954bd987f0cf9a7207ea3b6ea5c9add4"
dependencies = [
"either",
"owo-colors",
@@ -34,15 +34,15 @@ dependencies = [
[[package]]
name = "bitflags"
version = "2.9.0"
version = "2.10.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5c8214115b7bf84099f1309324e63141d4c5d7cc26862f97a0a857dbefe165bd"
checksum = "812e12b5285cc515a9c72a5c1d3b6d46a19dac5acfef5265968c166106e31dd3"
[[package]]
name = "bytemuck"
version = "1.22.0"
version = "1.24.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6b1fc10dbac614ebc03540c9dbd60e83887fda27794998c6528f1782047d540"
checksum = "1fbdf580320f38b612e485521afda1ee26d10cc9884efaaa750d383e13e3c5f4"
[[package]]
name = "either"
@@ -61,31 +61,31 @@ dependencies = [
[[package]]
name = "owo-colors"
version = "3.5.0"
version = "4.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c1b04fb49957986fdce4d6ee7a65027d55d4b6d2265e5848bbb507b58ccfdb6f"
checksum = "9c6901729fa79e91a0913333229e9ca5dc725089d1c363b2f4b4760709dc4a52"
[[package]]
name = "proc-macro2"
version = "1.0.94"
version = "1.0.103"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a31971752e70b8b2686d7e46ec17fb38dad4051d94024c88df49b667caea9c84"
checksum = "5ee95bc4ef87b8d5ba32e8b7714ccc834865276eab0aed5c9958d00ec45f49e8"
dependencies = [
"unicode-ident",
]
[[package]]
name = "quote"
version = "1.0.40"
version = "1.0.42"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
dependencies = [
"proc-macro2",
]
[[package]]
name = "strafesnet_roblox_bot_file"
version = "0.3.1"
version = "0.9.4"
dependencies = [
"binrw",
"bitflags",
@@ -94,9 +94,9 @@ dependencies = [
[[package]]
name = "syn"
version = "1.0.109"
version = "2.0.111"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
checksum = "390cc9a294ab71bdb1aa2e99d13be9c753cd2d7bd6560c77118597410c4d2e87"
dependencies = [
"proc-macro2",
"quote",
@@ -105,6 +105,6 @@ dependencies = [
[[package]]
name = "unicode-ident"
version = "1.0.18"
version = "1.0.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"

View File

@@ -1,10 +1,10 @@
[package]
name = "strafesnet_roblox_bot_file"
version = "0.3.1"
edition = "2021"
version = "0.9.4"
edition = "2024"
[dependencies]
binrw = "0.14.1"
binrw = "0.15.0"
bitflags = "2.6.0"
itertools = { version = "0.14.0", optional = true }

View File

@@ -3,7 +3,7 @@ Roblox Bhop/Surf Bot File Format
## Example
Read the whole file with the itertools feature enabled:
Read the whole file and print each position:
```rust
use strafesnet_roblox_bot_file::v0::read_all_to_block;
@@ -11,6 +11,10 @@ let file=std::fs::read("bot_file")?;
let mut input=std::io::Cursor::new(file);
let block=read_all_to_block(&mut input)?;
for output_event in &block.output_events{
println!("{:?}",output_event.event.position);
}
```
Or decode individual blocks using block location info:
```rust
@@ -19,21 +23,25 @@ use strafesnet_roblox_bot_file::v0::{Block,BlockTimelines,FileHeader};
let file=std::fs::read("bot_file")?;
let mut input=std::io::Cursor::new(file);
// FileHeader is the first 16 bytes of the file.
let header=FileHeader::from_reader(&mut input)?;
// BlockTimelines is an index of the blocks within the file.
let timelines=BlockTimelines::from_reader(&header,&mut input)?;
// offline blocks include the following event types:
// World, Gravity, Run, Camera, Setting
for timed in timelines.offline_blocks(){
let block_info=timelines.block_info(timed.event)?;
let block=Block::from_reader(block_info.take_seek(&mut input)?)?;
let block_reader=block_info.take_seek(&mut input)?;
let block=Block::from_reader(block_reader)?;
}
// realtime blocks include the following event types:
// Input, Output, Sound
for timed in timelines.realtime_blocks(){
let block_info=timelines.block_info(timed.event)?;
let block=Block::from_reader(block_info.take_seek(&mut input)?)?;
let block_reader=block_info.take_seek(&mut input)?;
let block=Block::from_reader(block_reader)?;
}
```

View File

@@ -1,3 +1,5 @@
pub use binrw::Error as BinrwError;
pub mod v0;
#[cfg(test)]

View File

@@ -1,42 +1,41 @@
use crate::v0::{Block,BlockTimelines,FileHeader,Timed};
use crate::v0;
use crate::v0::{Block,BlockTimelines,FileHeader};
#[test]
fn _1(){
fn deserialize_manual()->Result<(),binrw::Error>{
let file=std::fs::read("files/bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d").unwrap();
let mut input=std::io::Cursor::new(file);
let header=FileHeader::from_reader(&mut input).unwrap();
let timelines=BlockTimelines::from_reader(&header,&mut input).unwrap();
println!("header={:?}",header);
for &Timed{time,event:block_id} in timelines.offline_blocks(){
println!("offline time={} block_id={:?}",time,block_id);
let take_seek=timelines.block_info(block_id).unwrap().take_seek(&mut input).unwrap();
let _block=Block::from_reader(take_seek).unwrap();
// offline blocks include the following event types:
// World, Gravity, Run, Camera, Setting
let header=FileHeader::from_reader(&mut input)?;
let timelines=BlockTimelines::from_reader(&header,&mut input)?;
for block in timelines.offline_blocks(){
let block_info=timelines.block_info(block.event).unwrap();
let block_reader=block_info.take_seek(&mut input)?;
let _block=Block::from_reader(block_reader)?;
}
for &Timed{time,event:block_id} in timelines.realtime_blocks(){
println!("realtime time={} block_id={:?}",time,block_id);
let take_seek=timelines.block_info(block_id).unwrap().take_seek(&mut input).unwrap();
let _block=Block::from_reader(take_seek).unwrap();
// realtime blocks include the following event types:
// Input, Output, Sound
for block in timelines.realtime_blocks(){
let block_info=timelines.block_info(block.event).unwrap();
let block_reader=block_info.take_seek(&mut input)?;
let _block=Block::from_reader(block_reader)?;
}
}
#[cfg(feature="itertools")]
use crate::v0::{read_all_to_block,Error};
#[test]
#[cfg(feature="itertools")]
fn _2()->Result<(),Error>{
let file=std::fs::read("files/bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d").unwrap();
let t0=std::time::Instant::now();
let _block=read_all_to_block(std::io::Cursor::new(file))?;
println!("{:?}",t0.elapsed());
Ok(())
}
// TODO: file serialization test
#[test]
fn deserialize_all()->Result<(),v0::Error>{
let file=std::fs::read("files/bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d").unwrap();
let _block=v0::read_all_to_block(std::io::Cursor::new(file))?;
Ok(())
}
#[test]
#[cfg(feature="itertools")]
fn serialize_round_trip()->Result<(),binrw::Error>{
let file=std::fs::read("files/bhop_marble_7cf33a64-7120-4514-b9fa-4fe29d9523d").unwrap();
let block=v0::read_all_to_block(std::io::Cursor::new(file.as_slice())).unwrap();
let mut data=Vec::with_capacity(file.len());
v0::serialize(&block,&mut std::io::Cursor::new(&mut data))?;
// TODO: It encodes, but is it equal? Test something! PartialEq?
Ok(())
}

762
src/v0.rs

File diff suppressed because it is too large Load Diff