{"data":{"kind":"file","path":"README.md","version_id":"kcxh8f8h63vyvmqs0bocq6md","entry":{"name":"README.md","path":"README.md","is_directory":false,"size":2071,"modified_at":"2026-08-04T14:15:39.939000","content_hash":"f8cc8499a1a193105bcf921be652cb2538c2f785b9a29920c9a4d8c0ac6c175e"},"entries":[],"content":"# Flappy Bird Physics\n\nA verifiers environment that evaluates LLM understanding of 2D projectile physics\nthrough the lens of Flappy Bird game mechanics.\n\n## What It Tests\n\nThis environment presents 5 categories of physics problems drawn from Flappy Bird:\n\n1. **Trajectory Prediction** — Given initial position and velocity, predict the bird's\n   y-position after N frames under gravity.\n\n2. **Collision Detection** — Determine whether a bird will pass through a pipe gap\n   given its current trajectory (no further flaps).\n\n3. **Optimal Flap Timing** — Given one flap to use across N frames, find the frame\n   that positions the bird closest to the gap center.\n\n4. **Multi-Pipe Navigation** — Analyze whether a bird can survive multiple consecutive\n   pipes without flapping.\n\n5. **Required Velocity Calculation** — Compute the exact initial velocity needed to\n   reach a target y-position in a given number of frames.\n\n## Physics Model\n\n| Parameter       | Value                |\n|----------------|----------------------|\n| Gravity         | 0.5 px/frame^2       |\n| Flap velocity   | -8.0 px/frame        |\n| Pipe speed      | 3.0 px/frame         |\n| Pipe gap        | 120 px               |\n| Bird radius     | 12 px                |\n| Screen          | 288 x 512 px         |\n\nUses standard kinematic equations: `y(t) = y₀ + vy·t + ½·g·t²`\n\n## Rubric\n\n| Metric               | Weight | Description                                      |\n|----------------------|--------|--------------------------------------------------|\n| exact_number_match   | 1.0    | Numeric answer within tolerance                   |\n| yes_no_match         | 1.0    | Correct yes/no verdict                            |\n| integer_match        | 1.0    | Integer answer match (frame numbers)              |\n| physics_reasoning    | 0.3    | Quality of step-by-step physics explanation       |\n\n## Usage\n\n```python\nimport verifiers as vf\nenv = vf.load_environment(\"mahar/flappy-bird-physics\")\n```\n\n## Tags\n\n`physics` `game` `trajectory` `simulation` `kinematics` `flappy-bird`\n","encoding":"utf-8","truncated":false,"total_bytes":2071},"status":null}