Godot问题：Area无法检测KinematicBody，部队自动检测失效

问题说明 #

开发的3D RTS游戏中，敌方部队无法自动检测玩家部队，当敌对双方部队的EnemyZone接触时，_on_EnemyZone_body_entered函数完全未触发。部队脚本代码如下：

func _on_EnemyZone_body_entered(body):
    if self.is_in_group("enemy") and body.is_in_group("player_troop") or self.is_in_group("enemy") and body.is_in_group("player_city"):
        body = enemy
        hunt = true
    if enemy == null and self.is_in_group("player_troop") and body.is_in_group("enemy"):
        body = enemy
        hunt = true

注：双方使用同一部队场景生成，敌方生成的部队归入“enemy”组，玩家生成的归入对应玩家组。

可能的原因及排查方向 #

• 碰撞区域/碰撞体基础配置错误
  • EnemyZone节点类型不符：若使用Area3D，需确认Monitorable属性已勾选；若为碰撞体，要保证Collision Layer和Collision Mask设置匹配——敌方EnemyZone的掩码需包含玩家部队的碰撞层，玩家部队的掩码也要包含敌方EnemyZone的碰撞层，否则双方无法触发碰撞检测。
  • 缺失碰撞形状：EnemyZone节点下未挂载CollisionShape3D或CollisionPolygon3D，或碰撞形状的尺寸、位置设置错误，导致实际检测区域未覆盖部队需要的范围。
• 信号未正确绑定
  • body_entered信号未连接到_on_EnemyZone_body_entered函数：可在编辑器信号面板检查绑定状态；若为动态生成的节点，需确认代码中手动连接信号的逻辑正确，节点路径未因重命名、层级变更而失效。
• 分组赋值错误
  • 部队分组未正确设置：生成敌方部队时是否确实加入了“enemy”组？玩家部队是否正确归入“player_troop”或“player_city”组？可通过运行时调试工具查看节点分组标记，确认分组配置无误。
• 物理层全局过滤冲突
  • 项目物理层设置异常：检查Project Settings -> Physics -> 3D中的碰撞层规则，确保EnemyZone与目标部队所在的物理层未被全局过滤规则排除。
• 节点激活状态异常
  • EnemyZone或目标部队节点未激活：比如节点的monitoring或visible属性被误设为false，导致碰撞检测功能未启用。

内容的提问来源于stack exchange，提问作者AbsolutePickle42