Box2D in Love2D: Angry Birds Mechanics, Joints & Collisions

The classic Angry Birds experience relies on realistic projectile motion and destructible structures. Early prototypes often used simple axis‑aligned bounding boxes (AABB) for collision detection, but that approach quickly reaches its limits when modeling complex, interconnected objects. Switching to the Box2D library brings a full rigid‑body physics engine into Love2D, allowing developers to simulate gravity, collisions, and joint constraints with far greater fidelity.

Box2D Fundamentals

Box2D centers every object around its own midpoint, unlike Love2D’s default top‑left coordinate system. All bodies live inside a World container, which advances the simulation each frame through world:update(dt). The library distinguishes three body types:

• Static bodies remain fixed in space and never move.
• Dynamic bodies are fully subject to forces, gravity, and collisions.
• Kinematic bodies move under explicit velocity settings but ignore external forces and gravity.

Fixtures attach shapes to bodies and define physical attributes such as friction and restitution. By setting UserData on a fixture, developers can tag objects (e.g., “player”, “obstacle”) for later identification during collision callbacks.

Implementation Details

Mouse Input and Trajectory Prediction

When the player drags the mouse, the game records an initial impulse vector. To show where the bird will travel, the code simulates gravity over 90 frames, repeatedly applying the impulse to a temporary body. Each iteration updates velocity, computes a new position, and draws a point, producing a visual arc that guides the launch.

Collision Callbacks

Box2D provides four callbacks: BeginContact, EndContact, PreSolve, and PostSolve. The most critical for gameplay is BeginContact. Inside this callback the system reads the UserData of the two colliding fixtures. If the player's linear velocity magnitude exceeds 20, the obstacle’s fixture is flagged for removal.

Objects must not be destroyed directly inside callbacks. As one lecturer warned, “You're not supposed to do this in the callbacks because as the way it internally does physics calculations you want to do all the removals after all of the callbacks have resolved.” Instead, flagged objects are cleaned up in a post‑update phase, preventing memory or stack errors.

Sprite Rotation

Because Box2D works with center‑point coordinates, sprite drawing must account for rotation around the body’s center. The code calls body:getAngle() and renders the quad relative to its midpoint (e.g., (17.5, 17.5) for a 35 × 35 pixel sprite), ensuring the visual matches the physics orientation.

Advanced Physics: Joints

Joint types extend the range of possible structures:

• Weld joints permanently fuse two bodies; breaking them enables crumbling walls.
• Pulley joints connect bodies with a virtual rope, enforcing distance constraints that mimic real pulleys.
• Revolute joints create pivot points for rotation, useful for pendulums or swinging platforms.
• Rope joints act as flexible tethers, limiting movement within a defined radius.

These joints allow designers to craft intricate, destructible environments that react naturally to player actions.

Assignment Requirements

The course project builds on the lecture material:

• Multi‑bird spawning lets players launch several projectiles in a single level.
• Material‑based durability assigns hit points to objects—Glass breaks after 1 hit, Wood after 2, and Metal after 3.
• Joint integration requires students to incorporate weld, pulley, revolute, or rope joints into their level designs, creating structures that can collapse or swing under impact.

By combining Box2D’s physics simulation, collision logic, and joint systems, students can recreate the satisfying, physics‑driven gameplay that made Angry Birds a landmark title.