open-index/open-npm huggingface dataset:
npm package: @perplexdotgg/bounce
Description: Bounce
Latest version: 1.8.0

[![npm version](https://img.shields.io/npm/v/@perplexdotgg/bounce.svg)](https://www.npmjs.com/package/@perplexdotgg/bounce)
[![repo](https://img.shields.io/badge/codeberg-repo-7d48ff?logo=codeberg)](https://codeberg.org/perplexdotgg/bounce)
[![license](https://img.shields.io/npm/l/@perplexdotgg/bounce.svg?color=7d48ff)](http://codeberg.org/perplexdotgg/bounce/src/branch/main/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-7d48ff.svg)](https://codeberg.org/perplexdotgg/bounce/pulls)

# Bounce &middot; 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)

## 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](https://codeberg.org/perplexdotgg/bounce/src/branch/main/docs/documentation.md))
- Fixing any reported bugs. Please [file an issue](https://codeberg.org/perplexdotgg/bounce/issues) if you run into problems.
- Want to see something here? Please [create an issue](https://codeberg.org/perplexdotgg/bounce/issues).

## How to contribute

If you like this project and would like to support our work, please consider contributing code via [pull requests](https://codeberg.org/perplexdotgg/bounce/pulls), or donating via [open collective](https://opencollective.com/perplexgg). Contributions are greatly appreciated!