Bounce is a 3D physics library for the web, written in Typescript for JS and TS projects

• TypeScript 99.8%
• JavaScript 0.2%

- BREAKING CHANGE: world.castRay now uses RaycastResult instead of CastResult, which has much fewer fields (only what's needed for raycasting). result.contactPointA and result.bodyA are now result.contactPoint and result.body
- Resolves #6, now world.castRay takes a boolean `computeNormals` 6th parameter (default false), when set to true the normals are computed during the raycasting process. result.normal is now set when this boolean is set to true
- Resolves #7, now world.castShape correctly resets the earlyOutFraction, this had caused castShape to typically fail after succeeding one time in a session
- Improved ray casting performance by minimizing re-computations of the ray's center and extents
- Other minor cleanups and improvements
Special thanks to digitalbreed for the detailed bug reports!

Bounce · Premium 3D Physics for the Web

Bounce is a fast and determinstic 3D physics library for Typescript and Javascript projects. Bounce is written in pure Typsescript (no WebAssembly).

Links

• Official Bounce website with demos, API and more info: https://perplex.gg/bounce
• Documentation (markdown): https://codeberg.org/perplexdotgg/bounce/src/branch/main/docs/documentation.md
• NPM Package: https://www.npmjs.com/package/@perplexdotgg/bounce
• Reference character controller implementation: https://codeberg.org/perplexdotgg/bounce-character-controller

Official Examples

• Bounce + Three.js simple example (w/ Vite + Typescript): https://codeberg.org/perplexdotgg/bounce-simple-example
• Bounce + Three.js character controller example (w/ Vite + Typescript): https://codeberg.org/perplexdotgg/bounce-character-controller-example
• Bounce + Three.js MECS example, tower defense simulation: https://codeberg.org/perplexdotgg/mecs-tower-defense-example

Community Examples

• Bounce + Three.js, vanilla JS example by Mameson: https://mameson.com/experiment/glsl/bounce_example/bounce_example.html (for code, just view source, it's very readable)
• Bounce + Three.js, vanilla JS, official Three.js example by mrdoob: https://threejs.org/examples/#webgpu_postprocessing_ssgi_ballpool

Credits and Acknowledgments

Bounce was created by:

• Durai Ziyaee - 90% of the code, physics R&D
• Hamza Kubba - 10% of the code, funding, direction, project management, QA, website
• Your name here? - Contributions are welcome!

Although Bounce is mostly original code, it is inspired by and draws heavily from:

• Jolt
• Rapier
• Box2D
• Godot
• gl-matrix

Roadmap

• Creating a dedicated documentation site (markdown docs)
• Fixing any reported bugs. Please file an issue if you run into problems.
• Want to see something here? Please create an issue.

How to contribute

If you like this project and would like to support our work, please consider contributing code via pull requests, or donating via open collective. Contributions are greatly appreciated!