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 2.3.0 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.	0.8.0
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.	0.8.0
love.physics.getMeter	Returns the meter scale factor.	0.8.0
love.physics.newBody	Creates a new body.
love.physics.newChainShape	Creates a new ChainShape.	0.8.0
love.physics.newCircleShape	Creates a new CircleShape.
love.physics.newDistanceJoint	Creates a DistanceJoint between two bodies.
love.physics.newEdgeShape	Creates a new EdgeShape.	0.8.0
love.physics.newFixture	Creates and attaches a fixture.	0.8.0
love.physics.newFrictionJoint	A FrictionJoint applies friction to a body.	0.8.0
love.physics.newGearJoint	Create a GearJoint connecting two Joints.
love.physics.newMotorJoint	Creates a joint between two bodies which controls the relative motion between them.	0.9.0
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 rectangular 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.	0.8.0
love.physics.newWeldJoint	A WeldJoint essentially glues two bodies together.	0.8.0
love.physics.newWheelJoint	Creates a wheel joint.	0.8.0
love.physics.newWorld	Creates a new World.
love.physics.setMeter	Sets the meter scale factor.	0.8.0

Enums

BodyType	The types of a Body.
JointType	Different types of joints.
ShapeType	The different types of Shapes, as returned by Shape:getType.

See Also

• love
• Tutorial:Physics
• Tutorial:PhysicsCollisionCallbacks

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info