Tnua - Bevy的字符控制器。

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

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

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

注意：

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

功能

• 支持Rapier和XPBD的2D和3D版本
• 运行
• 跳跃
• 蹲下
• 可变高度的跳跃
• 狐狸时间
• 跳跃缓冲
• 上/下斜坡/楼梯
• 倾斜校正
• 移动平台
• 旋转平台
• 动画辅助（不是动画本身，但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