Matter Js

a 2D rigid body physics engine for the web ▲● ■
Alternatives To Matter Js
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Matter Js14,381275822 months ago19December 15, 2021201mitJavaScript
a 2D rigid body physics engine for the web ▲● ■
58a year agoFebruary 22, 2021150mitJavaScript
Physics plugin for Three.js
Comfortable Motion.vim456
5 years ago18mitVim script
Brings physics-based smooth scrolling to the Vim world!
Awesome Phaser329
3 years ago1
A curated list of awesome Phaser libraries, resources and shiny things.
2 years ago1apache-2.0GDScript
A GPU powered Terrain editor and renderer for Godot Engine
2 years ago4otherC++
Machinery Modelling Toolkit is a plugin for UE4
2 years ago4otherC++
Machinery Modelling Toolkit (Plugin for UE4)
Phaser Arcade Slopes120
12 years ago9August 17, 20217mitJavaScript
:triangular_ruler: A Phaser CE plugin that brings sloped tile collision handling to the Arcade Physics engine
Phaser Grid Physics107
3 years ago6mitJavaScript
The Grid Physics plugin is to Arcade physics what Arcade physics is to MatterJS.
Matter Attractors77656 years ago6May 15, 20179mitJavaScript
an attractors plugin for matter.js
Alternatives To Matter Js
Select To Compare

Alternative Project Comparisons

Matter.js is a JavaScript 2D rigid body physics engine for the web


Build Status



See how others are using matter.js physics


  • 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
  • Plugins
  • 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 and Node.js support (Chrome, Firefox, Safari, IE8+)
  • Mobile-compatible (touch, responsive)
  • An original JavaScript physics implementation (not a port)


You can install using package managers npm and Yarn using:

npm install matter-js

Alternatively you can download a stable release or try the latest experimental alpha build (master) and include the script in your web page:

<script src="matter.js" type="text/javascript"></script>

Performance with other tools (e.g. Webpack, Vue etc.)

Bundlers and frameworks may reduce real-time performance when using their default configs, especially in development modes.

When using Webpack, the default sourcemap config can have a large impact, for a solution see issue.

When using Vue.js, watchers can have a large impact, for a solution see issue.


Visit the Getting started wiki page for a minimal usage example which should work in both browsers and Node.js.
Also see the Running and Rendering wiki pages, which show how to use your own game and rendering loops.


See the list of tutorials.


See the examples directory which contains the source for all demos.
There are even more examples on codepen.


The engine can be extended through plugins, see these resources:


See the API Documentation and the wiki

Building and Contributing

To build you must first install node.js, then run

npm install

This will install the required build dependencies, then run

npm run dev

to spawn a development server. For information on contributing see


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.

Popular Physics Projects
Popular Plugin Projects
Popular Science Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Game Engine
Physics Engine