技能介绍

要解决什么问题

在 Godot 4.x 里做 2D/3D 玩法时，物理相关 bug 往往集中在几类：该用哪种 Body、碰撞层和遮罩为什么对不上、触发区不触发、刚体被直接改 position 后抖动穿模，以及 射线读到过期结果。本技能面向 Godot 4.3+，把 2D/3D 共用的一套概念讲清楚（节点名换 2D/3D 后缀即可）。

技能如何帮你落地

核心流程可以按五步记：

选物理体类型：StaticBody 做静态挡板；RigidBody 交给模拟（力/冲量或 linear_velocity，别硬拽位置）；CharacterBody 走脚本驱动的运动学（细节见 godot-2d-movement）；Area 做重叠检测并可施加重力/阻尼，没有实体碰撞。每个 Body 都需要子节点 CollisionShape 或 CollisionPolygon。
配 layers 与 masks：Body 在 layer 上声明「我是谁」，用 mask 声明「我找谁」；只有一方的 layer 落在另一方 mask 里才会交互。建议在 Project Settings > Layer Names 里命名层，避免后期对表困难。
用 Area 信号（body_entered、area_entered）处理触发器、受击框等重叠逻辑。
驱动 RigidBody：apply_force / apply_impulse，或重写 _integrate_forces 做完整控制。
射线检测：挂 RayCast2D/RayCast3D 每帧轮询，或在代码里用 space state 做一次查询。

文中还给出从代码设置层遮罩、Area 作 hurtbox、3D 刚体施力、两种 raycast 写法等 Patterns，并单列 Pitfalls（layer/mask 方向性、Area 的 monitoring/monitorable、同帧移动 RayCast 后需 force_raycast_update()、薄墙高速穿透与 continuous_cd、射线排除自身需 query.exclude = [self.get_rid()] 等）。

适用边界

不要用本技能替代：角色 move_and_slide 运动学控制器 → godot-2d-movement；瓦片碰撞搭建 → godot-tilemap；时间步、质量、手感调参 → physics-tuning。
关节、单向碰撞、PhysicsServer 直连、形状查询、move_and_collide 等进阶内容见技能内 references/bodies-and-queries.md。