Tnua - Bevy的字符控制器。

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

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

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

注意

• 需要集成包（bevy-tnua<physics-backend>）和主bevy-tnua包，并且需要添加两个包中的主要插件。
• 如果您使用具有双精度（如Avian带有f64标志）的物理后端，则需要将f64标志添加到所有Tnua包中。这适用于由物理后端定义的双精度数据 - 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

演示代码中的有趣部分

• 查看演示的入口点，了解插件和玩家角色实体是如何设置的。
• 查看角色控制系统，了解如何控制角色的运动和特殊移动动作。
• 查看角色动画系统，了解如何使用Tnua信息进行角色动画。

版本

Tnua被拆分为不同的crate，分别独立更新，因此分为多个表格。bevy-tnua-physics-integration-layer的版本必须与主bevy-tnua crate和集成crate相同。

主

Rapier集成

Avian集成

XPBD集成

由于bevy_xpbd项目已被重新命名为"Avian"，将不再接收任何更新。

预拆分

参考资料

以下用于编码Tnua的数学和物理

• "浮球"和奔跑机制
  • https://youtu.be/qdskE8PJy6Q
• 跳跃机制
  • https://youtu.be/hG9SzQxaCm8
  • https://youtu.be/eeLPL3Y9jjA

替代方案

• bevy_mod_wanderlust - 这个mod的原型，以及我从哪里获取浮球视频的地方。我最终创建了自有的插件，因为bevy_mod_wanderlust不支持2D。
• Rapier自身有角色控制器。它不是一个浮空角色控制器，但它与物理引擎本身集成，并利用这一优势来解决浮空模型通常需要解决的问题。

许可证

根据您的选择，受以下任何一项许可协议的保护

• Apache License，版本2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交以包含在作品中的任何贡献，将根据上述方式双重许可，不附加任何其他条款或条件。