SuperAPI AI 工具集

godot-physics

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在 Godot 4.7 中正确选用物理体、配置碰撞层与掩码、用 Area 检测重叠(触发器、受击盒)、对 RigidBody 施加力/冲量、用射线做视线与地面检测。2D 与 3D 概念相同,仅换后缀。

主要能力:①体类型选择——StaticBody 不动(地板、墙),RigidBody 完全模拟且不应直接改 position,CharacterBody 为脚本驱动的运动学体,Area 只检测重叠并可施加重力/阻尼、不做实体碰撞;每个体都需要 CollisionShape 或 CollisionPolygon 子节点。②碰撞层与掩码——体位于自己的层上,按掩码去扫描;两个体交互需一方的层落在另一方的掩码中,检测可能单向。③用 Area 的 body_entered、area_entered 信号检测重叠。④用 apply_central_force、apply_central_impulse 驱动刚体,或重写 _integrate_forces。⑤射线:RayCast2D/3D 节点每帧轮询,或用 space_state.intersect_ray 做一次性查询。

必要用法示例:set_collision_layer_value(1, true) 与 set_collision_mask_value(2, true);Area 中 body_entered.connect(_on_body_entered)、area_entered.connect(_on_area_entered);刚体 apply_central_impulse(direction * 8.0);一次性射线 PhysicsRayQueryParameters2D.create(...) 后 intersect_ray(query),排除自身用 query.exclude = [self.get_rid()]。

适用场景:碰撞关系排查、触发器/受击盒、刚体受力、视线与地面检测。不适用于:运动学角色控制器(move_and_slide,转 godot-2d-movement)、瓦片碰撞(godot-tilemap)、手感调参(physics-tuning)。

限制与常见坑:层/掩码混淆是首要 bug;直接改 RigidBody 位置会与求解器冲突导致穿插或抖动;Area 需开启 monitoring/monitorable 且层掩码重叠;RayCast 未启用或在物理更新前读取会得到过期数据;缺少 CollisionShape 则不碰撞;高速物体需 continuous_cd。3D 中 Godot 4.6 及以后新项目默认使用 Jolt Physics,旧项目沿用 GodotPhysics3D,不同引擎在关节、射线面索引、运动学接触、碰撞余量上表现不同,需在项目设置 Physics > 3D > Physics Engine 确认。