Matter.js is a JavaScript 2D rigid body physics engine for the web
Demos - Gallery - Features - Install - Usage - Examples - Docs - Wiki - References - License
See how others are using matter.js physics
- Magic Keyboard by Feross
- Obie Awards by Athletics
- Leg Work Studio by Leg Work
- Goblins and Grottos by Psychic Software
- Les métamorphoses de Mr. Kalia by Lab212 for Google
- Pablo The Flamingo by Nathan Gordon et al
- #GIFMYLIVE by Bonhomme for Arte
- Adobe Analytics Live Stream by Rain for Adobe
- Blood Sweat & Tools Interactive by Jam3 for Discovery
- Hype by Tumult
- Trophy Smasher by Kyle Stetz for Grind Select
- Pelada by Gabriel Gianordoli
- Labyrinth Game by Jaume Sanchez Elias
- Powermate and Physics by Jaume Sanchez Elias
- masQueLaCara by Zach Lieberman for Art Blocks Houston
- Rigid bodies
- Compound bodies
- Composite bodies
- Concave and convex hulls
- Physical properties (mass, area, density etc.)
- Restitution (elastic and inelastic collisions)
- Collisions (broad-phase, mid-phase and narrow-phase)
- Stable stacking and resting
- Conservation of momentum
- Friction and resistance
- Events
- Constraints
- Gravity
- Sleeping and static bodies
- Rounded corners (chamfering)
- Views (translate, zoom)
- Collision queries (raycasting, region tests)
- Time scaling (slow-mo, speed-up)
- Canvas renderer (supports vectors and textures)
- MatterTools for creating, testing and debugging worlds
- World state serialisation (requires resurrect.js)
- Cross-browser (Chrome, Firefox, Safari, IE8+)
- Mobile-compatible (touch, responsive)
- An original JavaScript physics implementation (not a port)
Download the edge build (master) or get a stable release and include the script in your web page:
<script src="matter.js" type="text/javascript"></script>
You can also install using the package managers Bower and NPM.
bower install matter-js
npm install matter-js
Visit the Getting started wiki page for a minimal usage example.
Also see the Rendering wiki page, which also shows how to use your own game loop.
See the examples directory which contains the source for all demos.
There are even more examples on codepen.
See the API Documentation and the wiki
To build you must first install node.js and gulp, then run
npm install
This will install the required build dependencies, then run
gulp dev
to spawn a development server. For information on contributing see CONTRIBUTING.md.
To see what's new or changed in the latest version, see the changelog.
See the wiki page on References.
Matter.js is licensed under The MIT License (MIT)
Copyright (c) 2014 Liam Brummitt
This license is also supplied with the release and source code.
As stated in the license, absolutely no warranty is provided.