F1 Game Library Models 25

I built this library primarily to learn about Rust package management on crates.io and the various CI/CD tools available for Rust on Github, so the library shouldn't be used for anything you need to rely on - I nevertheless hope you find it useful.

This is part of a larger project I have to do some interesting things with the UDP telemetry data the F1 video game series spits out during races or during the menus.

It is based on the UDP Specification for the F1-2025 video game. Previous versions are not supported.

This project defines the data types and various utility methods you might want or need.

Example Usage

use f1_game_library_models_25::telemetry_data::F1Data;

#[tokio::main]
async fn main() {
    let socket = tokio
        ::net
        ::UdpSocket
        ::bind("127.0.0.1:54345") // Configure this to match game   
        .await.unwrap();          // settings
    
    let mut buf = [0u8; 2048];

    loop {
        let (len, _) = socket.recv_from(&mut buf).await.unwrap();
        let packet =            
            f1_game_library_models_25::
                deserialise_udp_packet_from_bytes(&buf[..len])
                .expect("Failed to parse packet");
        
        // Do cool stuff
        match packet {
            F1Data::TelemetryData(data) => println!("Telemetry: {:?}", data),
            F1Data::LapData(data) => println!("Lap: {:?}", data),
            _ => {}
        }
    }
}

Contributing

Feel free to submit a PR if something is wrong or you'd like to offer enhancements! See CONTRIBUTING.md for details.

⚠️ Disclaimer

This project is not affiliated with, endorsed by, or associated with Formula 1, the FIA, any official F1 teams, or the developers and publishers of the F1 video game series.

All team names and references (e.g., Mercedes, Ferrari, Red Bull Racing) are used solely for the purposes of data interoperability and representation, based on publicly observable or inferred values from the official F1 game's telemetry specification. These names may be trademarks of their respective owners.

The enums, structs, and identifiers provided in this crate are derived from the F1 game's published or reverse-engineered telemetry specification, and are intended to support community tools and data analysis.

Their use in this project is purely informational and does not imply any endorsement or ownership. If you are a rights holder and have concerns, please contact the maintainer.