What problem does it solve?
bvhecctrl solves the challenge of implementing smooth, physics-like character movement and collision handling in React Three Fiber worlds without writing complex BVH and controller logic from scratch.
Core Features & Use Cases
- Physics-based character movement: Configure capsulized movement with floating/slope handling so characters traverse stairs and uneven terrain naturally.
- High-performance collision with BVH: Use three-mesh-bvh-backed collision detection to keep interaction fast in dense scenes.
- Animation and input integration: Sync GLTF animations to controller states (Idle/Walk/Run/Jump) and wire movement via KeyboardControls, plus mobile-friendly joystick/button components for touch input.
- Use cases: First/third-person RPG traversal, browser-based metaverse character locomotion, and interactive sandbox editors where terrain changes require consistent collision behavior.
Quick Start
Install bvhecctrl, wrap your character in KeyboardControls, and render BVHEcctrl with your model to enable responsive movement and animation syncing.