IMPORTANT: OgreBullet is outdated, for new projects rather use btogre.

This is an OgreGallery featured project


Bullet physics wrapper for Ogre

  • License MIT
  • Status dormant but reviving?
  • Dependencies Ogre 1.4+, Bullet Physics Engine
  • Latest Version
  • Instructions
  • Support OgreBullet Forum
  • Lead Developer Tuan Kuranes (maintainer) and Chaster,
  • Start Date 23-Apr-2007

Boxes flying and colliding in Ogre Bullet Demo
Boxes flying and colliding in Ogre Bullet Demo
Vehicle from the same demo
Vehicle from the same demo

OgreBullet is a wrapper, which allows you to easily integrate Bullet Physics Engine into your project. Bullet is available here
Currently the wrapper supports nearly all Bullet 2.64 features.

What is Bullet?
Bullet is a 3D Collision Detection and Rigid Body Dynamics Library for games and animation.
Free for commercial use, including PlayStation 3, Open Source multiplatform C++ under the ZLib License.
Discrete and continuous collision detection, integrated into Blender 3D and COLLADA 1.4 Physics tools support.

Just some of the features:

Multi Platform support:
Playstation 3, XBox 360, Wii, Win32, Linux, Mac OSX etc.
Parallel optimizations for Cell SPU, multi-core
Fully Open Source, ZLib license (free for commercial use)
Used by several professional game companies in AAA titles on Playstation 3, XBox 360, Wii and PC.

Supports various shape types:
Convex Polyhedron, Box, Sphere, Cone, Cylinder, Capsule, Static Triangle Mesh, Heightfield.

Single Queries:
Closest Point/Normal/Distance
Penetration Depth estimation
Ray Cast
Linear Cast / Swept Collision Test
Experimental Continuous Collision Detection/Time of Impact (incl. Rotation)

Sweep and Prune Broadphase
Bounding Volume Hierarchy for Static Triangle Mesh (AABB tree)
Allows re-use of graphics mesh, instead of duplicating (using index/stride)

Dynamics Features:
Framework with 2 different Constraint Solvers
Sequential Impulse
Projected Gauss Siedel (quickstep)
Hinge, Point to Point Constraint, Twist Cone Constraint (ragdolls)
Automatic de-activation (sleeping)
Generic 6 Degree of Freedom Constraint , Motors, Limits
LCP Warm starting of contact points

And more...

You can always find help and advice at the official OgreBullet forums.

Alexey Knyshev has a Bitbucket repository of OgreBullet that builds with CMake and Bullet 2.81. The original code is in the Ogre Addons repository. See the OgreBullet forum for details.

Don't forget to visit Bullet forums full of ideas, help and advise. Also, official wiki, manual and doxygen API are also there!

Ubuntu/Debian packages

SonSilentSea (by user SanguinarioJoe) Launchpad repository contains packages for Debian users (Ubuntu/Debian Natty Narwhal or Debian squeeze).
Simply execute:

sudo apt-add-repository ppa:sonsilentsea-team/sonsilentsea
sudo apt-get update
sudo apt-get install libogrebullet-dev

As super user, add this lines to /etc/apt/sources.list:

# SonSilentSea
deb http://ppa.launchpad.net/sonsilentsea-team/sonsilentsea/ubuntu natty main 
deb-src http://ppa.launchpad.net/sonsilentsea-team/sonsilentsea/ubuntu natty main

Then execute this commands

apt-get update
apt-get install libogrebullet-dev