Acknowledgements

Ecctrl

jolt-ts-character-controller is an imperative TypeScript port of Ecctrl, the floating-capsule character and vehicle controller for React Three Fiber, created by Erdong Chen and the Ecctrl contributors.

The behavior ported from Ecctrl includes the floating capsule with its spring–damper hover, ground friction, edge-triggered jumping, slope handling, auto-balance, moving-platform coupling, and custom gravity, as well as the car and drone control logic. This project mechanically ports that behavior and:

• removes the React, React Three Fiber, and react-three-rapier runtime dependencies,
• targets the jolt-ts wrapper around Jolt Physics instead of Rapier, and
• exposes an imperative, rendering-free API.

If you find this library useful, please consider starring and supporting the upstream project:

• Repository: github.com/pmndrs/ecctrl
• Author: Erdong Chen and the Ecctrl contributors

License & attribution

Ecctrl is released under the MIT License, and this project is MIT licensed too. The full attribution is recorded in the repository’s NOTICE file, and source that ports Ecctrl logic (such as the vehicle controller) carries an SPDX attribution header. Ecctrl’s original MIT terms are preserved.

Built on

This library stands on top of several excellent open-source projects:

• Jolt Physics — the underlying physics engine, by Jorrit Rouwe.
• jolt-ts — the TypeScript wrapper around Jolt that this library builds on (docs, npm).
• Three.js — used for its math types, and for rendering in the examples.

This documentation

Built with Astro and Starlight.