Docs
Progressive Pass

Progressive Pass

Rewarding Game-Changing Ball Movement

The Progressive Pass System is designed to identify and reward passes that significantly advance the ball down the field. By recognizing key moments in ball progression, this system highlights the contributions of players who help their team move closer to scoring opportunities.


What Is a Progressive Pass?

A progressive pass is a completed pass that:

  1. Covers a significant distance (greater than 13.3 yards).
  2. Ends in an advantageous field position (beyond the halfway line or a relative improvement compared to previous passes).
  3. Meets all other completion criteria.

Key Concepts of the Progressive Pass System

Pass Length

The distance covered by the pass is calculated as:

  • If the passLength is greater than the Progressive Pass Threshold (13.3 yards), it qualifies as a candidate for being progressive.

Pass Completion

A pass must have an outcome of "complete" to be considered progressive. Incomplete passes are excluded from evaluation.


End Location

To qualify as a progressive pass, the pass must end in a meaningful offensive position:

  • Absolute Rule: The pass ends in a location where end_x > 60.
  • Relative Rule: If there are previous passes in the possession, the pass must end at least 13.3 yards further downfield than the furthest end_x of prior passes.

How It Works

Pass Evaluation Logic

Step 1: Initial Check

  • If the player_id, end_x, or outcome of the pass is invalid, the pass is ignored.

Step 2: Progressive Pass Criteria

The system evaluates whether the pass qualifies as progressive based on:

  1. Pass Length: The pass must cover a distance greater than 13.3 yards.
  2. Completion: The pass must have an outcome of "complete".
  3. End Location:
    • For the first pass in a possession, end_x > 60.
    • For subsequent passes, end_x must exceed the furthest previous end_x by at least 13.3 yards.

Step 3: Logging and Feedback

  • Detailed debug logs are generated to track pass evaluation, including:
    • Pass length.
    • Comparison with prior passes in the possession.
    • Whether the pass satisfies progressive pass criteria.

Step 4: Assign Reward

  • If the pass qualifies as progressive, it is rewarded with the ProgressivePass type. If not, no reward is assigned.