Tnua - Bevy的字符控制器。

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

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

• 对于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