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版本
• 运行
• 跳跃
• 蹲下
• 可变高度的跳跃
• Coypote时间
• 跳跃缓冲区
• 上/下斜坡/楼梯的跑步
• 倾斜校正
• 移动平台
• 旋转平台
• 动画辅助工具（不是动画本身，但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，这些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 - 这是这个模组的原始灵感来源，也是我从哪里获得浮动胶囊视频的地方。最后，我创建了自己的插件，因为 bevy_mod_wanderlust 不支持2D。
• Rapier 本身有一个角色控制器。它不是一个浮动的角色控制器，但它与物理引擎本身集成，并利用这个特权来解决浮动模型用来解决的问题。

许可证

根据以下任一项授权

• Apache License, Version 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非你明确表示，否则根据 Apache-2.0 许可证定义，任何有意提交以包含在你工作的贡献，都将根据上述条款双授权，不附加任何额外条款或条件。