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 24.04 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 around 6ms
• load_hoops: Loads 15732 triangles, executes in around 7.5ms
• load_dropshot: Loads 3616 triangles, executes in around 6.5ms
• load_standard_throwback: Loads 9272 triangles, executes in around 7ms
• get_ball_prediction_struct_for_time: standard + 8 seconds, executes in around 110µs
• get_ball_prediction: standard + 6 seconds, executes in around 90µs
• get_ball_prediction: Hoops + 6 seconds, executes in around 90µs
• get_ball_prediction: Dropshot + 6 seconds, executes in around 75µs
• get_ball_prediction: standard + Throwback Stadium + 6 seconds, executes in around 80µs

Features

• standard: Enable loading the standard map
• hoops: Enable loading the hoops map
• dropshot: Enable loading the dropshot map
• throwback: Enable loading the throwback map (with standard game rules)
• heatseeker: Enable calculate the heatseeker ball path on any map