Tnua - A Character Controller for bevy_rapier.

Tnua ("motion" in Hebrew) is a floating character controller, which means that instead of constantly touching the ground the character floats above it, which makes many aspects of the motion control simpler.

Tnua uses Rapier, and supports both the 2D and 3D versions of it:

Features (implemented and future)

• [x] Supports both 2D and 3D versions of Rapier
• [x] Running
• [x] Jumping
• [x] Variable height jumping
• [x] Coyote time
• [x] Running up/down slopes/stairs
• [x] Tilt correction
• [x] Moving platforms
• [x] Rotating platforms
• [x] Animation helpers (not the animation itself, but Tnua has facilities that help deciding which animation to play)
• [ ] Jump/fall-through platforms
• [ ] Wall clinging/running
• [ ] Ledge grabbing
• [ ] Air actions (double jump, float, etc.)
• [ ] Slippery ground
• [ ] Slope affected movement

Examples:

• https://idanarye.github.io/bevy-tnua/demos/platformer_2d
• https://idanarye.github.io/bevy-tnua/demos/platformer_3d

Versions

| bevy | bevy-tnua | bevy_rapier | |------|-----------|-------------| | 0.10 | 0.1 | 0.21 |

Reference Material

The following were used for coding the math and physics of Tnua:

• "Floating capsule" and running mechanics: https://youtu.be/qdskE8PJy6Q
• Jumping mechanics:https://youtu.be/hG9SzQxaCm8

Alternatives

• bevymodwanderlust - the original inspiration for this mod, and where I got the floating capsule video from. I ended up creating my own plugin because bevymodwanderlust does not support 2D.
• Rapier itself has a character controller. It's not a floating character controller, but it's integrated with the physics engine itself and uses that privilege to work out some of the problems the floating model is used to address.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.