Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Physics plugin for Three.js
Pull request Compare This branch is 136 commits behind chandlerprall:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Physics plugin for three.js

Physijs brings a very easy to use interface to the three.js framework. One of the reasons three.js is so popular is because it is so incredibly easy for graphics newbies to get into 3D programming. Physijs takes that philosophy to heart and makes physics simulations just as easy to run. In fact, there are just five easy steps that must be taken to make a 3D scene come alive.

How does Physijs work?

Physijs is built on top of ammo.js (although there is also a cannon.js branch) and runs the physics simulation in a separate thread (via web worker) to avoid impacting in your application's performance and taking up your your 3D rendering time.

A lot of effort has been made to keep the style of code the same when using Physijs. Apart from updating an object's position, all of the normal three.js conventions remain the same. If you are used to three.js, you already know how to use the Physijs plugin.

Who is this for?

You, hopefully. If you are familiar with three.js and want to add physics to your scene, this is the plugin for you. No mucking about with shape definitions, keeping objects in their correct positions, or identifying collisions - simply use a few Physijs objects in place of three.js's and you'll automatically have a dynamic environment.

If you need (or want) a feature not already included then add it to the issue tracker or implement it yourself and send over a pull request.


rigid bodies collisions compound shapes all shapes jenga


  • Support for multiple object shapes, including custom convex objects.
  • Material system provides simple control over friction and restitution ("bounciness")
  • Integrated collision detection and events
  • Compound objects using the hierarchy system in three.js
  • Rotations using either euler or quaternion systems - your preference
  • Built seamlessly on top of three.js to keep the same convention and coding style

In the Future

  • More (and better) optimizations
  • Constraint systems such as point-to-point and hinge.
  • Vehicle systems
  • Heightfield/heightmap shape
  • It would be awesome to have concave shape decomposition
Something went wrong with that request. Please try again.