rocketsim 0.2.0

Simulate Rocket League games at maximum efficiency
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
97
98
99
100
101
102
103
104
105
106

use glam::Vec3A;

use crate::RaycastHitInfo;

/// Ball touched a static surface this tick (wall, floor, ceiling, goal mesh).
///
/// `contact_point` is in uu, `contact_normal` points off the surface.
#[derive(Debug, Copy, Clone)]
pub struct BallHitWorldEvent {
    pub contact_point: Vec3A,
    pub contact_normal: Vec3A,
}

/// A car touched the ball this tick.
///
/// `extra_hit_vel` (uu/s) is the additional velocity from the car's hit
/// impulse (on top of the physics-solver bounce). Zero when the contact
/// added no extra impulse (e.g. repeated-contact guard).
#[derive(Debug, Copy, Clone)]
pub struct CarHitBallEvent {
    pub car_idx: usize,
    pub contact_point: Vec3A,
    pub extra_hit_vel: Vec3A,
}

/// Two cars collided this tick (tested both directions).
///
/// `is_demo == true` means the victim was demolished; otherwise a bump
/// impulse was cached for the victim. See [`crate::MutatorConfig`] demo rules.
#[derive(Debug, Copy, Clone)]
pub struct CarHitCarEvent {
    pub bumper_car_idx: usize,
    pub victim_car_idx: usize,
    pub contact_point: Vec3A,
    pub is_demo: bool,
}

/// A car touched a static surface; also stored as
/// `CarState::world_contact_normal` for that tick.
#[derive(Debug, Copy, Clone)]
pub struct CarHitWorldEvent {
    pub car_idx: usize,
    pub contact_point: Vec3A,
    pub contact_normal: Vec3A,
}

/// A car collected a boost pad (`boost_pad_idx` matches
/// `Arena::get_boost_pad_config` order).
#[derive(Debug, Copy, Clone)]
pub struct CarPickupBoostEvent {
    pub car_idx: usize,
    pub boost_pad_idx: usize,
}

/// A car's `is_on_ground` flipped `false` → `true` this tick.
///
/// `wheels` is a copy of [`crate::CarState::wheels_with_contact`] at landing
/// (at least 3 entries are `Some`; the rest are airborne wheels).
#[derive(Debug, Copy, Clone)]
pub struct CarLandedEvent {
    pub car_idx: usize,
    pub wheels: [Option<RaycastHitInfo>; 4],
}

/// One tick's contact/pickup notifications.
///
/// Returned by [`crate::Arena::step_tick`] and
/// [`crate::Arena::get_last_step_events`]; valid only until the next tick.
#[derive(Debug, Copy, Clone)]
pub enum ArenaEvent {
    BallHitWorld(BallHitWorldEvent),
    CarHitBall(CarHitBallEvent),
    CarHitCar(CarHitCarEvent),
    CarHitWorld(CarHitWorldEvent),
    CarPickupBoost(CarPickupBoostEvent),
    CarLanded(CarLandedEvent),
}

//////////////////////////////////////

#[derive(Debug, Clone)]
pub(crate) struct ArenaEventList {
    events: Vec<ArenaEvent>,
}

impl ArenaEventList {
    const STARTING_CAPACITY: usize = 12;

    pub fn new() -> Self {
        Self {
            events: Vec::with_capacity(Self::STARTING_CAPACITY),
        }
    }

    pub fn push(&mut self, event: ArenaEvent) {
        self.events.push(event);
    }

    pub fn events(&self) -> &[ArenaEvent] {
        &self.events
    }

    pub fn clear(&mut self) {
        self.events.clear();
    }
}