OPOpenPlay Football

Explore OpenPlay

A structured language for describing football players, assignments, timing, and decisions. Demo Schema v0.1 is experimental.

01

Getting Started

OpenPlay is a structured JSON language for describing educational football plays independent of rendering or simulation.

02

Document Structure

Every document uses a common envelope plus offense-specific or defense-specific sections.

03

Coordinates

Field-relative coordinates keep records independent from screen size. X is 0–53.3 yards. Y is 0–100 yards from the offense's end zone.

04

Players and Alignments

Player records provide stable identities, positions, labels, initial coordinates, and team side.

05

Assignments

Discriminated records connect one player to a route, block, rush, coverage, handoff, or supporting job.

06

Routes

Route assignments are ordered semantic path segments, not renderer-specific drawing commands.

07

Blocking

Blocking assignments encode pass protection and run responsibilities without tying them to a diagram library.

08

Defensive Coverages

Defensive documents combine player-level jobs with a whole-call description of front, coverage, pressure, and disguise.

09

Timeline

Timeline events provide ordered semantic moments for animation without embedding animation-library code.

10

Decision Points

An offensive decision point pauses a concept at a meaningful read and presents bounded football choices.

11

Narratives

Narrative fields make each record useful even when no diagram is running.

12

Examples

The canonical offensive and defensive playbooks in this repository are the executable examples for version 0.1.

13

Future Vision

The long-term commitment is to publish the schema, documentation, and a reference renderer under stated open licenses.