Can simulate 2D rigid body physics in a realistic manner. This module is based on Box2D, and this API corresponds to the Box2D API as closely as possible.

O.png love.physics is not lightweight, and not even remotely simple to use. It's a ten-ton hammer designed for heavy-lifting (er...hammer...lifting?)

If you are just trying to make a character jump around on blocks or the likes, then move along, nothing to see here.



BodyBodies are objects with velocity and position.
ContactContacts are objects created to manage collisions in worlds.
FixtureFixtures attach shapes to bodies.Added since 0.8.0
JointAttach multiple bodies together to interact in unique ways.
ShapeShapes are objects used to control mass and collisions.
WorldA world is an object that contains all bodies and joints.


love.physics.getDistanceReturns the two closest points between two fixtures and their distance.Added since 0.8.0
love.physics.getMeterReturns the meter scale factor.Added since 0.8.0
love.physics.newBodyCreates a new body.
love.physics.newChainShapeCreates a new ChainShape.Added since 0.8.0
love.physics.newCircleShapeCreates a new CircleShape.
love.physics.newDistanceJointCreates a DistanceJoint between two bodies.
love.physics.newEdgeShapeCreates a new EdgeShape.Added since 0.8.0
love.physics.newFixtureCreates and attaches a fixture.Added since 0.8.0
love.physics.newFrictionJointA FrictionJoint applies friction to a body.Added since 0.8.0
love.physics.newGearJointCreate a GearJoint connecting two Joints.
love.physics.newMouseJointCreate a joint between a body and the mouse.
love.physics.newPolygonShapeCreates a new PolygonShape.
love.physics.newPrismaticJointCreates a PrismaticJoint between two bodies.
love.physics.newPulleyJointCreates a PulleyJoint to join two bodies to each other and the ground.
love.physics.newRectangleShapeShorthand for creating rectangluar PolygonShapes.
love.physics.newRevoluteJointCreates a pivot joint between two bodies.
love.physics.newRopeJointCreates a joint between two bodies that enforces a max distance between them.Added since 0.8.0
love.physics.newWeldJointA WeldJoint essentially glues two bodies together.Added since 0.8.0
love.physics.newWheelJointCreates a wheel joint.Added since 0.8.0
love.physics.newWorldCreates a new World.
love.physics.setMeterSets the meter scale factor.Added since 0.8.0


See Also

Other Languages

Personal tools