Tnua - Bevy 的角色控制器。

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

Tnua 可以使用 Rapier 或 Avian（以前称为 XPBD），并通过集成 crate 支持两者的 2D 和 3D 版本。

• 对于 Rapier 2D，添加 bevy-tnua-rapier2d crate。
• 对于 Rapier 3D，添加 bevy-tnua-rapier3d crate。
• 对于 Avian 2D，添加 bevy-tnua-avian2d crate。
• 对于 Avian 3D，添加 bevy-tnua-avian3d crate。
• XPBD 仍然通过 bevy-tnua-xpbd2d 和 bevy-tnua-xpbd3d 支持，但鼓励用户迁移到 Avian。
• 第三方集成 crate。此类 crate 应依赖于 bevy-tnua-physics-integration-layer 而不是主 bevy-tnua crate。

注意：

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

特性

• 支持 Rapier 和 Avian 的 2D 和 3D 版本
• 运行
• 跳跃
• 蹲下
• 可变高度跳跃
• 狐狸时间
• 跳跃缓冲区
• 在斜坡/楼梯上上下跑
• 倾斜校正
• 移动平台
• 旋转平台
• 动画辅助工具（不是动画本身，但Tnua提供了帮助选择播放哪个动画的功能）
• 通过平台跳跃/下落
• 空中动作

演示

• 2D平台游戏： Rapier，Avian，Avian（f64版本）
• 3D平台游戏： Rapier，Avian，Avian（f64版本）
• 3D射击游戏： Rapier，Avian，Avian（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、avian2d或avian3d之一。请确保后端（2D或3D）的维度与演示的维度相匹配。例如，要使用Avian运行3D平台游戏，请使用此方法

$ cargo run --bin platformer_3d --features avian3d