schteppe / cannon.js

cannon.js Lightweight 3D physics for the web Inspired by three.js and ammo.js, and driven by the fact that the web lacks a physics engine, here comes cannon.js. The rigid body physics engine includes simple collision detection, various body shapes, contacts, friction and constraints. Demos - Documentation - Rendering hints - NPM package - CDN Browser install Just include cannon.js or cannon.min.js in your html and you're done: Node.js install Install the cannon package via NPM: Alternatively, point to the Github repo directly to get the very latest version: Example The sample code below creates a sphere on a plane, steps the simulation, and prints the sphere simulation to the console. Note that Cannon.js uses SI units (metre, kilogram, second, etc.). If you want to know how to use cannon.js with a rendering engine, for example Three.js, see the Examples. Features • Rigid body dynamics • Discrete collision detection • Contacts, friction and restitution • Constraints • PointToPoint (a.k.a. ball/socket joint) • Distance • Hinge (with optional motor) • Lock • ConeTwist • Gauss-Seidel constraint solver and an island split algorithm • Collision filters • Body sleeping • Experimental SPH / fluid support • Various shapes and collision algorithms (see table below) | | Sphere | Plane | Box | Convex | Particle | Heightfield | Trimesh | | :-----------|:------:|:-----:|:---:|:------:|:--------:|:-----------:|:-------:| | Sphere | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | Plane | - | - | Yes | Yes | Yes | - | Yes | | Box | - | - | Yes | Yes | Yes | Yes | (todo) | | Cylinder | - | - | Yes | Yes | Yes | Yes | (todo) | | Convex | - | - | - | Yes | Yes | Yes | (todo) | | Particle | - | - | - | - | - | (todo) | (todo) | | Heightfield | - | - | - | - | - | - | (todo) | | Trimesh | - | - | - | - | - | - | - | Todo The simpler todos are marked with in the code. Github Issues can and should also be used for todos. Help Create an issue if you need help.