rlbot 0.6.0

Rust bindings for the RLBot framework, allowing you to write bots for Rocket League in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

use rlbot::{
    RLBotConnection,
    agents::{ScriptAgent, run_script_agent},
    flat::{
        DesiredCarState, DesiredGameState, DesiredPhysics, FieldInfo, GamePacket,
        MatchConfiguration, MatchPhase, Vector3Partial,
    },
    util::{AgentEnvironment, PacketQueue},
};

#[allow(dead_code)]
struct MyScript {
    agent_id: String,
    name: String,
    prev_jumps: Vec<bool>,
}

impl ScriptAgent for MyScript {
    fn new(
        agent_id: String,
        match_config: MatchConfiguration,
        _field_info: FieldInfo,
        _packet_queue: &mut PacketQueue,
    ) -> Self {
        let name = match_config
            .script_configurations
            .iter()
            .find_map(|script| {
                if script.agent_id == agent_id {
                    Some(script.name.clone())
                } else {
                    None
                }
            })
            .unwrap();

        Self {
            agent_id,
            name,
            prev_jumps: vec![false; match_config.player_configurations.len()],
        }
    }

    fn tick(&mut self, game_packet: GamePacket, packet_queue: &mut PacketQueue) {
        if game_packet.match_info.match_phase != MatchPhase::Active {
            return;
        }

        if self.prev_jumps.len() != game_packet.players.len() {
            self.prev_jumps.resize(game_packet.players.len(), false);
        }

        let mut car_states = Vec::with_capacity(game_packet.players.len());

        for (player, prev_jump) in game_packet.players.iter().zip(self.prev_jumps.iter_mut()) {
            if player.last_input.jump && !*prev_jump {
                let mut physics: Box<DesiredPhysics> = Box::default();
                let mut velocity: Box<Vector3Partial> = Box::default();
                velocity.z = Some(rlbot::flat::Float {
                    // make cars jump super high!
                    val: player.physics.velocity.z + 1000.0,
                });
                physics.velocity = Some(velocity);

                car_states.push(DesiredCarState {
                    physics: Some(physics),
                    ..Default::default()
                });
            } else {
                car_states.push(DesiredCarState::default());
            }

            *prev_jump = player.last_input.jump;
        }

        packet_queue.push(DesiredGameState {
            car_states,
            ..Default::default()
        });
    }
}

fn main() {
    let AgentEnvironment {
        server_addr,
        agent_id,
    } = AgentEnvironment::from_env();
    let agent_id = agent_id.unwrap_or_else(|| "rlbot/rust-example/high_jump_script".into());
    let rlbot_connection = RLBotConnection::new(&server_addr).expect("connection");

    // Blocking.
    run_script_agent::<MyScript>(agent_id.clone(), true, true, rlbot_connection)
        .expect("run_script_agent crashed");

    println!("Script with agent_id `{agent_id}` exited nicely");
}