Loading repository data…
Loading repository data…
liabru / repository
a 2D rigid body physics engine for the web ▲● ■
Matter.js is a JavaScript 2D rigid body physics engine for the web
Demos ・ Gallery ・ Features ・ Plugins ・ Install ・ Usage ・ Examples ・ Docs ・ Wiki ・ References ・ License
See how others are using matter.js physics
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>
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
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 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.