gaia-physics 是一个游戏开发方向的物理技能,使用 BVH(Bounding Volume Hierarchy,层次包围盒)为静态与运动学几何体提供物理计算,底层依赖 @pmndrs/viverse 库。资料明确指出,目前动态刚体之间尚不能相互交互。
用途方面,该技能主要服务于游戏中的角色移动与场景碰撞需求,包括搭建物理世界、构建角色控制器、进行地面检测,以及使用传感器体积判断角色进入或离开某个区域。
主要能力包括:
- 物理世界:通过 BvhPhysicsWorld 创建物理世界实例。
- 刚体添加:world.addBody(object, isKinematic) 可添加静态刚体(第二参数为 false)或运动学刚体(第二参数为 true)。
- 角色控制器:通过 BvhCharacterPhysics(world) 创建角色物理控制器;使用 applyVelocity 施加一次性速度(例如跳跃),使用 inputVelocity 设置持续速度(例如行走)。资料特别提示,对于带动画的人形角色不要直接设置 inputVelocity,而应使用 applyMove 回调模式,否则角色在待机或攻击动画期间会出现滑动。
- 逐帧更新:设置速度后需每帧调用 characterPhysics.update(character, delta, {} satisfies BvhCharacterPhysicsOptions)。
- 地面状态:通过 characterPhysics.isGrounded 判断角色是否位于地面。
- 传感器体积:world.addSensor(object, isStatic, callback) 添加传感器,回调参数 intersected 为真表示角色进入、为假表示离开;world.removeSensor(object) 移除传感器。若希望使用统一的进入回调,可为每个传感器包装回调,在 intersected 为真时调用 onEnter(object),并传入对应对象。
使用方式上,需先在项目中引入 @pmndrs/viverse,按上述 API 创建物理世界、添加场景几何体、创建角色控制器,并在每帧循环中设置速度后调用 update。传感器则按需添加并在回调中处理进入/离开逻辑。
适用场景包括:静态关卡地形与移动平台(运动学刚体)上的角色行走与跳跃、地面检测、以及触发区域(如进入某范围时触发事件)。限制在于动态刚体之间暂不支持相互交互,且人形动画角色需遵循 applyMove 回调模式而非直接设置 inputVelocity。关于安装命令、收费与授权方式等,资料暂未提供。