Tnua - Bevy的角色控制器。

Tnua（希伯来语中的“运动”）是一个悬浮角色控制器，这意味着角色不再始终接触地面，而是在空中浮动，这使得许多运动控制方面变得更加简单。

Tnua可以使用Rapier或XPBD，并支持两个库的2D和3D版本，通过集成Crate。

• 对于Rapier 2D，添加bevy-tnua-rapier2d Crate。
• 对于Rapier 3D，添加bevy-tnua-rapier3d Crate。
• 对于XPBD 2D，添加bevy-tnua-xpbd2d Crate。
• 对于XPBD 3D，添加bevy-tnua-xpbd3d Crate。
• 第三方集成Crate。这样的Crate应依赖于bevy-tnua-physics-integration-layer而不是主要的bevy-tnua Crate。

注意：

• 需要集成Crate（bevy-tnua<physics-backend>）和主要的bevy-tnua Crate，并且应该添加两个Crate的主要插件。
• 如果您使用具有双精度（如使用f64标志的XPBD）的物理后端，则需要将f64标志添加到所有Tnua Crate中。这适用于物理后端定义的双精度数据 - Bevy本身仍然使用单精度，这是位置和旋转将使用的精度。

功能

• 支持Rapier和XPBD的2D和3D版本
• 运行
• 跳跃
• 蹲下
• 可变高度跳跃
• Coyote时间
• 跳跃缓冲
• 在斜坡/楼梯上上下跑
• 倾斜校正
• 移动平台
• 旋转平台
• 动画辅助工具（不是动画本身，而是Tnua具有帮助决定播放哪个动画的工具）
• 跳过/穿过平台
• 空中动作

演示

• 2D 平台游戏：Rapier，XPBD，XPBD (f64 版本)
• 3D 平台游戏：Rapier，XPBD，XPBD (f64 版本)
• 3D 射击游戏：Rapier，XPBD，XPBD (f64 版本)

演示中的基本设置和动作可以通过 GUI 进行调整。它们被初始化为 Tnua 中提供的 Default::default()，以下有一些例外

• TnuaBuiltinWalk::desired_velocity 默认为零向量，但用户行走角色时将其设置为长度为 20.0 的向量（2D 演示中为 40.0）
• TnuaBuiltinWalk::float_height 被设置为 2.0，尽管它默认为 0.0。用户代码应始终根据模型几何形状设置浮点高度。
• TnuaBuiltinWalk::max_slope 被设置为 $\frac{\pi}{4}$，尽管它默认为 $\frac{\pi}{2}$（这将禁用滑动行为，因为这是墙壁的斜率角度）
• TnuaBuiltinJump::height 被设置为 4.0，尽管它默认为 0.0。用户代码应始终根据游戏要求设置跳跃高度（零高度跳跃动作是无用的）
• TnuaBuiltinCrouch::float_offset 被设置为 -0.9，尽管它默认为 0.0。就像 float_height 一样，此值应始终由用户代码根据模型几何形状设置。
• TnuaBuiltinDash::displacement 默认为 0.0，但用户输入冲刺命令时，它被设置为长度为 10.0 的向量。

本地运行演示

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

其中 <demo-name> 是演示的名称，而 <physics-backend> 是 rapier2d、rapier3d、xpbd2d 或 xpbd3d 之一。请确保后端维度（2D 或 3D）与演示相匹配。例如，要使用 XPBD 运行 3D 平台游戏，请使用以下命令

$ cargo run --bin platformer_3d --features xpbd3d