love.physics
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.
![]() |
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. |
Types
Body | Bodies are objects with velocity and position. | ||
Contact | Contacts are objects created to manage collisions in worlds. | ||
Fixture | Fixtures attach shapes to bodies. |
![]() |
|
Joint | Attach multiple bodies together to interact in unique ways. | ||
Shape | Shapes are objects used to control mass and collisions. | ||
World | A world is an object that contains all bodies and joints. |
Functions
love.physics.getDistance | Returns the two closest points between two fixtures and their distance. |
![]() |
|
love.physics.getMeter | Returns the meter scale factor. |
![]() |
|
love.physics.newBody | Creates a new body. | ||
love.physics.newChainShape | Creates a new ChainShape. |
![]() |
|
love.physics.newCircleShape | Creates a new CircleShape. | ||
love.physics.newDistanceJoint | Creates a DistanceJoint between two bodies. | ||
love.physics.newEdgeShape | Creates a new EdgeShape. |
![]() |
|
love.physics.newFixture | Creates and attaches a fixture. |
![]() |
|
love.physics.newFrictionJoint | A FrictionJoint applies friction to a body. |
![]() |
|
love.physics.newGearJoint | Create a GearJoint connecting two Joints. | ||
love.physics.newMouseJoint | Create a joint between a body and the mouse. | ||
love.physics.newPolygonShape | Creates a new PolygonShape. | ||
love.physics.newPrismaticJoint | Creates a PrismaticJoint between two bodies. | ||
love.physics.newPulleyJoint | Creates a PulleyJoint to join two bodies to each other and the ground. | ||
love.physics.newRectangleShape | Shorthand for creating rectangluar PolygonShapes. | ||
love.physics.newRevoluteJoint | Creates a pivot joint between two bodies. | ||
love.physics.newRopeJoint | Creates a joint between two bodies that enforces a max distance between them. |
![]() |
|
love.physics.newWeldJoint | A WeldJoint essentially glues two bodies together. |
![]() |
|
love.physics.newWheelJoint | Creates a wheel joint. |
![]() |
|
love.physics.newWorld | Creates a new World. | ||
love.physics.setMeter | Sets the meter scale factor. |
![]() |
Enums
See Also
Category: