use super::*;
const FLICK_MAX_DODGE_TO_TOUCH_SECONDS: f32 = 0.32;
const FLICK_MAX_CONTROL_TO_DODGE_SECONDS: f32 = 0.08;
const FLICK_MAX_SETUP_STALE_SECONDS: f32 = 0.35;
const FLICK_MIN_SETUP_SECONDS: f32 = 0.30;
const FLICK_MIN_BALL_SPEED_CHANGE: f32 = 450.0;
const FLICK_HIGH_CONFIDENCE: f32 = 0.80;
const FLICK_MIN_CONFIDENCE: f32 = 0.55;
const FLICK_MAX_CONTROL_BALL_Z: f32 = 700.0;
const FLICK_MAX_CONTROL_HORIZONTAL_GAP: f32 = BALL_RADIUS_Z * 1.7;
const FLICK_MIN_CONTROL_VERTICAL_GAP: f32 = 35.0;
const FLICK_MAX_CONTROL_VERTICAL_GAP: f32 = 280.0;
const FLICK_MIN_LOCAL_Z: f32 = 20.0;
const FLICK_MAX_LOCAL_X_BEHIND: f32 = 95.0;
const FLICK_MAX_LOCAL_X_FRONT: f32 = 210.0;
const FLICK_MAX_LOCAL_Y: f32 = 170.0;
const FLICK_MIN_IMPULSE_AWAY_ALIGNMENT: f32 = 0.15;
#[derive(Debug, Clone, PartialEq, Serialize, ts_rs::TS)]
#[ts(export)]
pub struct FlickEvent {
pub time: f32,
pub frame: usize,
pub sample_time: f32,
pub sample_frame: usize,
#[ts(as = "crate::ts_bindings::RemoteIdTs")]
pub player: PlayerId,
pub is_team_0: bool,
pub dodge_time: f32,
pub dodge_frame: usize,
pub time_since_dodge: f32,
pub setup_start_time: f32,
pub setup_start_frame: usize,
pub setup_duration: f32,
pub setup_touch_count: u32,
pub average_horizontal_gap: f32,
pub average_vertical_gap: f32,
pub ball_speed_change: f32,
pub ball_impulse: [f32; 3],
pub impulse_away_alignment: f32,
pub vertical_impulse: f32,
pub confidence: f32,
}
#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize, ts_rs::TS)]
#[ts(export)]
pub struct FlickStats {
pub count: u32,
pub high_confidence_count: u32,
pub is_last_flick: bool,
pub last_flick_time: Option<f32>,
pub last_flick_frame: Option<usize>,
pub time_since_last_flick: Option<f32>,
pub frames_since_last_flick: Option<usize>,
pub last_confidence: Option<f32>,
pub best_confidence: f32,
pub cumulative_confidence: f32,
pub cumulative_setup_duration: f32,
pub cumulative_ball_speed_change: f32,
#[serde(default, skip_serializing_if = "LabeledCounts::is_empty")]
pub labeled_event_counts: LabeledCounts,
}
impl FlickStats {
pub fn average_confidence(&self) -> f32 {
if self.count == 0 {
0.0
} else {
self.cumulative_confidence / self.count as f32
}
}
pub fn average_setup_duration(&self) -> f32 {
if self.count == 0 {
0.0
} else {
self.cumulative_setup_duration / self.count as f32
}
}
pub fn average_ball_speed_change(&self) -> f32 {
if self.count == 0 {
0.0
} else {
self.cumulative_ball_speed_change / self.count as f32
}
}
fn record_event(&mut self, event: &FlickEvent) {
self.labeled_event_counts.increment([confidence_band_label(
event.confidence >= FLICK_HIGH_CONFIDENCE,
)]);
self.sync_legacy_counts();
self.last_flick_time = Some(event.time);
self.last_flick_frame = Some(event.frame);
self.last_confidence = Some(event.confidence);
self.best_confidence = self.best_confidence.max(event.confidence);
self.cumulative_confidence += event.confidence;
self.cumulative_setup_duration += event.setup_duration;
self.cumulative_ball_speed_change += event.ball_speed_change;
}
pub fn event_count_with_labels(&self, labels: &[StatLabel]) -> u32 {
self.labeled_event_counts.count_matching(labels)
}
pub fn complete_labeled_event_counts(&self) -> LabeledCounts {
LabeledCounts::complete_from_label_sets(
&[&CONFIDENCE_BAND_LABELS],
&self.labeled_event_counts,
)
}
fn sync_legacy_counts(&mut self) {
self.count = self.labeled_event_counts.total();
self.high_confidence_count = self.event_count_with_labels(&[confidence_band_label(true)]);
}
}
#[derive(Debug, Clone, Copy, PartialEq)]
struct FlickControlObservation {
horizontal_gap: f32,
vertical_gap: f32,
}
#[derive(Debug, Clone, PartialEq)]
struct ActiveFlickSetup {
is_team_0: bool,
start_time: f32,
start_frame: usize,
last_time: f32,
last_frame: usize,
duration: f32,
horizontal_gap_integral: f32,
vertical_gap_integral: f32,
touch_count: u32,
}
#[derive(Debug, Clone, PartialEq)]
struct FlickSetupSummary {
is_team_0: bool,
start_time: f32,
start_frame: usize,
last_time: f32,
last_frame: usize,
duration: f32,
average_horizontal_gap: f32,
average_vertical_gap: f32,
touch_count: u32,
}
#[derive(Debug, Clone, PartialEq)]
struct RecentDodgeStart {
time: f32,
frame: usize,
setup: FlickSetupSummary,
}
#[derive(Debug, Clone, Default, PartialEq)]
pub struct FlickCalculator {
player_stats: HashMap<PlayerId, FlickStats>,
events: Vec<FlickEvent>,
active_setups: HashMap<PlayerId, ActiveFlickSetup>,
recent_setups: HashMap<PlayerId, FlickSetupSummary>,
recent_dodge_starts: HashMap<PlayerId, RecentDodgeStart>,
previous_dodge_active: HashMap<PlayerId, bool>,
previous_ball_velocity: Option<glam::Vec3>,
current_last_flick_player: Option<PlayerId>,
}
impl FlickCalculator {
pub fn new() -> Self {
Self::default()
}
pub fn player_stats(&self) -> &HashMap<PlayerId, FlickStats> {
&self.player_stats
}
pub fn events(&self) -> &[FlickEvent] {
&self.events
}
fn normalize_score(value: f32, min_value: f32, max_value: f32) -> f32 {
if max_value <= min_value {
return 0.0;
}
((value - min_value) / (max_value - min_value)).clamp(0.0, 1.0)
}
fn begin_sample(&mut self, frame: &FrameInfo) {
for stats in self.player_stats.values_mut() {
stats.is_last_flick = false;
stats.time_since_last_flick = stats
.last_flick_time
.map(|time| (frame.time - time).max(0.0));
stats.frames_since_last_flick = stats
.last_flick_frame
.map(|last_frame| frame.frame_number.saturating_sub(last_frame));
}
if let Some(player_id) = self.current_last_flick_player.as_ref() {
if let Some(stats) = self.player_stats.get_mut(player_id) {
stats.is_last_flick = true;
}
}
}
fn ball_impulse(
frame: &FrameInfo,
ball: &BallFrameState,
previous_ball_velocity: Option<glam::Vec3>,
) -> glam::Vec3 {
const BALL_GRAVITY_Z: f32 = -650.0;
let Some(ball) = ball.sample() else {
return glam::Vec3::ZERO;
};
let Some(previous_ball_velocity) = previous_ball_velocity else {
return glam::Vec3::ZERO;
};
let expected_linear_delta = glam::Vec3::new(0.0, 0.0, BALL_GRAVITY_Z * frame.dt.max(0.0));
ball.velocity() - previous_ball_velocity - expected_linear_delta
}
fn control_observation(
ball: &BallSample,
player: &PlayerSample,
controlling_player: Option<&PlayerId>,
) -> Option<FlickControlObservation> {
if controlling_player != Some(&player.player_id) {
return None;
}
let player_rigid_body = player.rigid_body.as_ref()?;
let player_position = player.position()?;
let ball_position = ball.position();
if !(BALL_CARRY_MIN_BALL_Z..=FLICK_MAX_CONTROL_BALL_Z).contains(&ball_position.z) {
return None;
}
let horizontal_gap = player_position
.truncate()
.distance(ball_position.truncate());
if horizontal_gap > FLICK_MAX_CONTROL_HORIZONTAL_GAP {
return None;
}
let vertical_gap = ball_position.z - player_position.z;
if !(FLICK_MIN_CONTROL_VERTICAL_GAP..=FLICK_MAX_CONTROL_VERTICAL_GAP)
.contains(&vertical_gap)
{
return None;
}
let local_ball_position =
quat_to_glam(&player_rigid_body.rotation).inverse() * (ball_position - player_position);
if local_ball_position.x < -FLICK_MAX_LOCAL_X_BEHIND
|| local_ball_position.x > FLICK_MAX_LOCAL_X_FRONT
|| local_ball_position.y.abs() > FLICK_MAX_LOCAL_Y
|| local_ball_position.z < FLICK_MIN_LOCAL_Z
{
return None;
}
Some(FlickControlObservation {
horizontal_gap,
vertical_gap,
})
}
fn setup_summary(setup: &ActiveFlickSetup) -> FlickSetupSummary {
FlickSetupSummary {
is_team_0: setup.is_team_0,
start_time: setup.start_time,
start_frame: setup.start_frame,
last_time: setup.last_time,
last_frame: setup.last_frame,
duration: setup.duration,
average_horizontal_gap: setup.horizontal_gap_integral
/ setup.duration.max(f32::EPSILON),
average_vertical_gap: setup.vertical_gap_integral / setup.duration.max(f32::EPSILON),
touch_count: setup.touch_count,
}
}
fn setup_qualifies(setup: &FlickSetupSummary) -> bool {
setup.duration >= FLICK_MIN_SETUP_SECONDS
}
fn store_recent_setup(&mut self, player_id: PlayerId, setup: FlickSetupSummary) {
if Self::setup_qualifies(&setup) {
self.recent_setups.insert(player_id, setup);
}
}
fn finish_setup(&mut self, player_id: &PlayerId) {
let Some(setup) = self.active_setups.remove(player_id) else {
return;
};
self.store_recent_setup(player_id.clone(), Self::setup_summary(&setup));
}
fn recent_setup_for_player(
&self,
player_id: &PlayerId,
current_time: f32,
) -> Option<FlickSetupSummary> {
if let Some(active) = self.active_setups.get(player_id) {
return Some(Self::setup_summary(active));
}
self.recent_setups
.get(player_id)
.filter(|setup| current_time - setup.last_time <= FLICK_MAX_SETUP_STALE_SECONDS)
.cloned()
}
fn update_control_setups(
&mut self,
frame: &FrameInfo,
ball: &BallFrameState,
players: &PlayerFrameState,
touch_events: &[TouchEvent],
controlling_player: Option<&PlayerId>,
) {
let Some(ball) = ball.sample() else {
let player_ids: Vec<_> = self.active_setups.keys().cloned().collect();
for player_id in player_ids {
self.finish_setup(&player_id);
}
return;
};
let mut observed_players = HashSet::new();
for player in &players.players {
let Some(observation) = Self::control_observation(ball, player, controlling_player)
else {
continue;
};
observed_players.insert(player.player_id.clone());
let setup = self
.active_setups
.entry(player.player_id.clone())
.or_insert_with(|| ActiveFlickSetup {
is_team_0: player.is_team_0,
start_time: (frame.time - frame.dt).max(0.0),
start_frame: frame.frame_number.saturating_sub(1),
last_time: frame.time,
last_frame: frame.frame_number,
duration: frame.dt.max(0.0),
horizontal_gap_integral: observation.horizontal_gap * frame.dt.max(0.0),
vertical_gap_integral: observation.vertical_gap * frame.dt.max(0.0),
touch_count: 0,
});
if setup.last_frame != frame.frame_number {
setup.last_time = frame.time;
setup.last_frame = frame.frame_number;
setup.duration += frame.dt.max(0.0);
setup.horizontal_gap_integral += observation.horizontal_gap * frame.dt.max(0.0);
setup.vertical_gap_integral += observation.vertical_gap * frame.dt.max(0.0);
}
}
for touch_event in touch_events {
let Some(player_id) = touch_event.player.as_ref() else {
continue;
};
if let Some(setup) = self.active_setups.get_mut(player_id) {
setup.touch_count += 1;
}
}
let active_ids: Vec<_> = self.active_setups.keys().cloned().collect();
for player_id in active_ids {
if !observed_players.contains(&player_id) {
self.finish_setup(&player_id);
}
}
}
fn track_dodge_starts(&mut self, frame: &FrameInfo, players: &PlayerFrameState) {
for player in &players.players {
let was_dodge_active = self
.previous_dodge_active
.insert(player.player_id.clone(), player.dodge_active)
.unwrap_or(false);
if !player.dodge_active || was_dodge_active {
continue;
}
let Some(setup) = self.recent_setup_for_player(&player.player_id, frame.time) else {
continue;
};
if !Self::setup_qualifies(&setup) {
continue;
}
if frame.time - setup.last_time > FLICK_MAX_CONTROL_TO_DODGE_SECONDS {
continue;
}
self.recent_dodge_starts.insert(
player.player_id.clone(),
RecentDodgeStart {
time: frame.time,
frame: frame.frame_number,
setup,
},
);
}
}
fn prune_recent_state(&mut self, current_time: f32) {
self.recent_setups
.retain(|_, setup| current_time - setup.last_time <= FLICK_MAX_SETUP_STALE_SECONDS);
self.recent_dodge_starts
.retain(|_, dodge| current_time - dodge.time <= FLICK_MAX_DODGE_TO_TOUCH_SECONDS);
}
fn candidate_event(
&self,
ball: &BallFrameState,
player: &PlayerSample,
touch_event: &TouchEvent,
dodge_start: &RecentDodgeStart,
ball_impulse: glam::Vec3,
) -> Option<FlickEvent> {
let ball = ball.sample()?;
let player_position = player.position()?;
let time_since_dodge = touch_event.time - dodge_start.time;
if !(0.0..=FLICK_MAX_DODGE_TO_TOUCH_SECONDS).contains(&time_since_dodge) {
return None;
}
let ball_speed_change = ball_impulse.length();
if ball_speed_change < FLICK_MIN_BALL_SPEED_CHANGE {
return None;
}
let to_ball = (ball.position() - player_position).normalize_or_zero();
let impulse_direction = ball_impulse.normalize_or_zero();
if to_ball.length_squared() <= f32::EPSILON
|| impulse_direction.length_squared() <= f32::EPSILON
{
return None;
}
let impulse_away_alignment = impulse_direction.dot(to_ball);
if impulse_away_alignment < FLICK_MIN_IMPULSE_AWAY_ALIGNMENT {
return None;
}
let vertical_impulse = ball_impulse.z.max(0.0);
let setup = &dodge_start.setup;
let timing_score =
1.0 - (time_since_dodge / FLICK_MAX_DODGE_TO_TOUCH_SECONDS).clamp(0.0, 1.0);
let setup_duration_score =
Self::normalize_score(setup.duration, FLICK_MIN_SETUP_SECONDS, 0.75);
let horizontal_control_score =
1.0 - (setup.average_horizontal_gap / FLICK_MAX_CONTROL_HORIZONTAL_GAP).clamp(0.0, 1.0);
let vertical_control_score = 1.0
- ((setup.average_vertical_gap - 110.0).abs() / FLICK_MAX_CONTROL_VERTICAL_GAP)
.clamp(0.0, 1.0);
let impulse_score =
Self::normalize_score(ball_speed_change, FLICK_MIN_BALL_SPEED_CHANGE, 1450.0);
let away_score = Self::normalize_score(
impulse_away_alignment,
FLICK_MIN_IMPULSE_AWAY_ALIGNMENT,
0.85,
);
let vertical_score = Self::normalize_score(vertical_impulse, 100.0, 750.0);
let confidence = 0.16 * timing_score
+ 0.19 * setup_duration_score
+ 0.12 * horizontal_control_score
+ 0.10 * vertical_control_score
+ 0.22 * impulse_score
+ 0.15 * away_score
+ 0.06 * vertical_score;
if confidence < FLICK_MIN_CONFIDENCE {
return None;
}
Some(FlickEvent {
time: touch_event.time,
frame: touch_event.frame,
sample_time: touch_event.time,
sample_frame: touch_event.frame,
player: player.player_id.clone(),
is_team_0: player.is_team_0,
dodge_time: dodge_start.time,
dodge_frame: dodge_start.frame,
time_since_dodge,
setup_start_time: setup.start_time,
setup_start_frame: setup.start_frame,
setup_duration: setup.duration,
setup_touch_count: setup.touch_count,
average_horizontal_gap: setup.average_horizontal_gap,
average_vertical_gap: setup.average_vertical_gap,
ball_speed_change,
ball_impulse: ball_impulse.to_array(),
impulse_away_alignment,
vertical_impulse,
confidence,
})
}
fn apply_event(&mut self, frame: &FrameInfo, mut event: FlickEvent) {
event.sample_time = frame.time;
event.sample_frame = frame.frame_number;
let stats = self.player_stats.entry(event.player.clone()).or_default();
stats.record_event(&event);
stats.is_last_flick = true;
stats.time_since_last_flick = Some((frame.time - event.time).max(0.0));
stats.frames_since_last_flick = Some(frame.frame_number.saturating_sub(event.frame));
self.current_last_flick_player = Some(event.player.clone());
self.events.push(event);
}
fn apply_touch_events(
&mut self,
frame: &FrameInfo,
ball: &BallFrameState,
players: &PlayerFrameState,
touch_events: &[TouchEvent],
) {
let ball_impulse = Self::ball_impulse(frame, ball, self.previous_ball_velocity);
for touch_event in touch_events {
let Some(player_id) = touch_event.player.as_ref() else {
continue;
};
let Some(player) = players
.players
.iter()
.find(|player| &player.player_id == player_id)
else {
continue;
};
let Some(dodge_start) = self.recent_dodge_starts.get(player_id) else {
continue;
};
let Some(event) =
self.candidate_event(ball, player, touch_event, dodge_start, ball_impulse)
else {
continue;
};
self.apply_event(frame, event);
}
if let Some(player_id) = self.current_last_flick_player.as_ref() {
if let Some(stats) = self.player_stats.get_mut(player_id) {
stats.is_last_flick = true;
}
}
}
fn reset_live_play_state(&mut self, ball: &BallFrameState) {
self.current_last_flick_player = None;
self.active_setups.clear();
self.recent_setups.clear();
self.recent_dodge_starts.clear();
self.previous_dodge_active.clear();
self.previous_ball_velocity = ball.velocity();
}
pub fn update(
&mut self,
frame: &FrameInfo,
ball: &BallFrameState,
players: &PlayerFrameState,
touch_state: &TouchState,
live_play_state: &LivePlayState,
) -> SubtrActorResult<()> {
if !live_play_state.is_live_play {
self.reset_live_play_state(ball);
return Ok(());
}
self.begin_sample(frame);
self.prune_recent_state(frame.time);
self.update_control_setups(
frame,
ball,
players,
&touch_state.touch_events,
touch_state.last_touch_player.as_ref(),
);
self.track_dodge_starts(frame, players);
self.apply_touch_events(frame, ball, players, &touch_state.touch_events);
self.previous_ball_velocity = ball.velocity();
Ok(())
}
}
#[cfg(test)]
#[path = "flick_tests.rs"]
mod tests;