rl_ball_sym
Rust implementation of Rocket League’s ball physics; Inspired by Samuel P. Mish’s C++ utils called RLUtilities with accuracy improvements from RocketSim and other miscellaneous performance improvements.
Running
Make sure you have Rust/Cargo installed, then just run cargo test --release
in the terminal.
Example implementations
Check out the examples folder! If you want to run them and don’t know how:
cargo run --example example_name
For example, to run the example basic.rs
:
cargo run --example basic
Performance numbers
Numbers are from a system running Ubuntu 23.10 with a Ryzen 9 5900X and 3600MHz CL18 RAM.
Numbers will vary depending on your system. Only default features are enabled.
load_standard
: Loads 8028 triangles, executes in around655µs
load_hoops
: Loads 15732 triangles, executes in around1.35ms
load_dropshot
: Loads 3616 triangles, executes in around300µs
load_standard_throwback
: Loads 9272 triangles, executes in around815µs
get_ball_prediction_struct_for_time
: standard + 8 seconds, executes in around180µs
get_ball_prediction
: standard + 6 seconds, executes in around145µs
get_ball_prediction
: Hoops + 6 seconds, executes in around140µs
get_ball_prediction
: Dropshot + 6 seconds, executes in around115µs
get_ball_prediction
: standard + Throwback Stadium + 6 seconds, executes in around145µs
Features
standard
: Enable loading the standard maphoops
: Enable loading the hoops mapdropshot
: Enable loading the dropshot mapthrowback
: Enable loading the throwback map (with standard game rules)compression
: Minimize the size of the produced binaries by compressing the binary field data at compile time. Will slightly slow download_x()
functions.