Skip to content

vpochapuis/bevy-tnua

 
 

Repository files navigation

Build Status Latest Version Rust Documentation Rust Documentation

Tnua - A Character Controller for Bevy.

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 can use Rapier or XPBD, and supports both the 2D and 3D versions of both with integration crates:

Note that both integration crate (bevy-tnua-<physics-backend>) and the main bevy-tnua crate are required, and that the main plugin from both crates should be added.

Features

  • Supports both 2D and 3D versions of Rapier and XPBD
  • Running
  • Jumping
  • Crouching
  • Variable height jumping
  • Coyote time
  • Jump buffer
  • Running up/down slopes/stairs
  • Tilt correction
  • Moving platforms
  • Rotating platforms
  • Animation helpers (not the animation itself, but Tnua has facilities that help deciding which animation to play)
  • Jump/fall through platforms
  • Air actions

Demos:

Demo Rapier XPBD
2D Platformer https://idanarye.github.io/bevy-tnua/demos/platformer_2d-rapier https://idanarye.github.io/bevy-tnua/demos/platformer_2d-xpbd
3D Platformer https://idanarye.github.io/bevy-tnua/demos/platformer_3d-rapier https://idanarye.github.io/bevy-tnua/demos/platformer_3d-xpbd

Running the Demos Locally

$ cargo run --bin <demo-name> --features <physics-backend>

Where <demo-name> is the name of the demo and <physics-backend> is either rapier2d, rapier3d, xpbd2d or xpbd3d. Make sure to match the dimensionality of the backend (2D or 3D) to that of the demo. For example, to run the 3D platformer with XPBD, use this:

$ cargo run --bin platformer_3d --features xpbd3d

Interesting Parts of the Demo Code

Versions

Tnua is broken into different crates that update separately, so this is broken into multiple tables. The version of bevy-tnua-physics-integration-layer must be the same for both the main bevy-tnua crate and the integration crates.

Main

bevy bevy-tnua-physics-integration-layer bevy-tnua
0.13 0.2 0.15
0.12 0.1 0.13-0.14

Rapier integration

bevy bevy-tnua-physics-integration-layer bevy-tnua-rapier bevy_rapier
0.13 0.2 0.3 0.25
0.12 0.1 0.2 0.24
0.12 0.1 0.1 0.23

XPBD integration

bevy bevy-tnua-physics-integration-layer bevy-tnua-xpbd bevy_xpbd
0.13 0.2 0.2 0.4
0.12 0.1 0.1 0.3

Pre-split

bevy bevy-tnua bevy_rapier
0.12 0.12 0.23
0.11 0.8 - 0.11 0.22
0.10 0.1 - 0.7 0.21

Reference Material

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

Alternatives

  • bevy_mod_wanderlust - the original inspiration for this mod, and where I got the floating capsule video from. I ended up creating my own plugin because bevy_mod_wanderlust 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

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.

About

A floating character controller for Bevy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%