<<<<<<< HEAD
Box2D is a 2D physics engine for games.
Please do not submit pull requests with new features or core library changes. Instead, please file an issue first for discussion. For bugs, I prefer detailed bug reports over pull requests.
- Continuous collision detection
- Contact callbacks: begin, end, pre-solve, post-solve
- Convex polygons and circles
- Multiple shapes per body
- One-shot contact manifolds
- Dynamic tree broadphase
- Efficient pair management
- Fast broadphase AABB queries
- Collision groups and categories
- Continuous physics with time of impact solver
- Persistent body-joint-contact graph
- Island solution and sleep management
- Contact, friction, and restitution
- Stable stacking with a linear-time solver
- Revolute, prismatic, distance, pulley, gear, mouse joint, and other joint types
- Joint limits, motors, and friction
- Momentum decoupled position correction
- Fairly accurate reaction forces/impulses
- Small block and stack allocators
- Centralized tuning parameters
- Highly portable C++ with no use of STL containers
- OpenGL with GLFW
- Graphical user interface with imgui
- Extensible test framework
- Support for loading world dumps
- Install CMake
- Ensure CMake is in the user
PATH - Visual Studio: run
build.batfrom the command prompt - Otherwise: run
build.shfrom a bash shell - Results are in the build sub-folder
- On Windows you can open box2d.sln
You can download and install Box2D using the vcpkg dependency manager:
- git clone https://github.com/Microsoft/vcpkg.git
- cd vcpkg
- ./bootstrap-vcpkg.sh
- ./vcpkg integrate install
- ./vcpkg install box2d
The Box2D port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.
Note: vcpkg support is not provided by the Box2D project
- Install CMake
- Add Cmake to the path in .zprofile (the default Terminal shell is zsh)
- export PATH="/Applications/CMake.app/Contents/bin:$PATH"
- mkdir build
- cd build
- cmake -G Xcode ..
- open box2d.xcodeproj
- Select the testbed scheme
- Edit the scheme to set a custom working directory, make this be in box2d/testbed
- You can now build and run the testbed
You can build and install the library and docs using this command sequence (requires Doxygen):
mkdir build
cd build
cmake -DBOX2D_BUILD_DOCS=ON ..
cmake --build .
cmake --build . --target INSTALL
On Windows this tries to install in Program Files and thus requires admin privileges. Alternatively you can target another directory using something like this:
mkdir build
cd build
cmake -DBOX2D_BUILD_DOCS=ON -DCMAKE_INSTALL_PREFIX="C:/packages" ..
cmake --build .
cmake --build . --target INSTALL
Box2D is developed by Erin Catto, and uses the MIT license.
Support development of Box2D through Github Sponsors
Box2D is a 2D physics engine for games.
- Continuous collision detection
- Contact events and sensors
- Convex polygons, capsules, circles, rounded polygons, segments, and chains
- Multiple shapes per body
- Collision filtering
- Ray casts, shape casts, and overlap queries
- Robust Soft Step rigid body solver
- Continuous physics for fast translations and rotations
- Island based sleep
- Revolute, prismatic, distance, mouse joint, weld, and wheel joints
- Joint limits, motors, springs, and friction
- Joint and contact forces
- Body movement events and sleep notification
- Data-oriented design
- Written in portable C17
- Extensive multithreading and SIMD
- OpenGL with GLFW and enkiTS
- Graphical user interface with imgui
- Many samples to demonstrate features and performance
- Install CMake
- Ensure CMake is in the user
PATH - Visual Studio: run
build.batfrom the command prompt - Otherwise: run
build.shfrom a bash shell - Results are in the build sub-folder
- On Windows you can open box2d.sln
- Install CMake
- Add Cmake to the path in .zprofile (the default Terminal shell is zsh)
- export PATH="/Applications/CMake.app/Contents/bin:$PATH"
- mkdir build
- cd build
- cmake -G Xcode ..
- open box2d.xcodeproj
- Select the samples scheme
- Edit the scheme to set a custom working directory to the box2d directory
- You can now build and run the samples
The Box2D library and samples build and run on Windows, Linux, and Mac.
Box2D should be built on recent versions of clang and gcc. You will need the latest Visual Studio version for C11 atomics to compile (17.8.3+).
AVX2 CPU support is assumed on x64. You can turn this off in the CMake options and use SSE2 instead. There are some compatibility issues with very old CPUs.
Please do not submit pull requests. Instead, please file an issue for bugs or feature requests. For support, please visit the Discord server.
Please file an issue or start a chat on discord.
Box2D is developed by Erin Catto and uses the MIT license.
Support development of Box2D through Github Sponsors
- https://github.com/EnokViking/Box2DBeef
- https://github.com/HolyBlackCat/box2cpp
upstream/main