liabru /matter-js

a 2D rigid body physics engine for the web ▲● ■

★ 18,640⑂ 2,002👁 236⑃ 157● 1,194▤ 0
JavaScriptMITCreated 2014-02-19
+11
日增长
18,640
stars
2,002
forks
236
watchers
157
prs
1,194
issues
0
releases

README

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

brm.io/matter-js

Demos ・ Gallery ・ Features ・ Plugins ・ Install ・ Usage ・ Examples ・ Docs ・ Wiki ・ References ・ License

 Demos


  
    
      
        Mixed Shapes
        Solid Shapes
        Concave SVG Paths
        Concave Terrain
        Concave Bodies
        Compound Bodies
        Newton's Cradle
        Wrecking Ball
        Slingshot Game
        Rounded Corners
        Views
        Time Scaling
        Body Manipulation
        Composite Manipulation
      
    
    
      
        Raycasting
        Sprites
        Pyramid
        Car
        Catapult
        Reverse Gravity
        Bridge
        Avalanche
        Basic Soft Bodies
        Cloth
        Events
        Collision Filtering
        Chains
        Ball Pool
      
    
    
      
        Stack
        Circle Stack
        Compound Stack
        Restitution
        Friction
        Air Friction
        Static Friction
        Sleeping
        Beach Balls
        Stress 1
        Stress 2
        Sensors
      
      
    
  


 Gallery

See how others are using matter.js physics

- Patrick Heng by Patrick Heng
- USELESS by Nice and Serious
- Secret 7 by Goodness
- New Company by New Company
- Game of The Year by Google
- Pablo The Flamingo by Nathan Gordon
- Les métamorphoses de Mr. Kalia by Lab212
- Phaser by Photon Storm
- Sorry I Have No Filter by Jessica Walsh
- Fuse by Fuse
- Glyphfinder by überdosis
- Isolation by sabato studio
- more...

 Features

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

 Install

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:

    

 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. 

 Usage

Vi

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON