##### Views

- Page
- Discussion
- View source
- History

# 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. | 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.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. | 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

## 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

Retrieved from "https://www.love2d.org/wiki/love.physics"
Category: Modules

##### Personal tools

- Log in

##### Search

##### Toolbox

- What links here
- Related changes
- Special pages
- Printable version
- Permanent link
- Browse properties