Godot 4.1（C#）如何检测Rigidbody2D碰撞的瓦片？

核心思路 #

在Godot 4.1中，TileMap的碰撞系统改用基于TileSet的配置，玩家端检测碰撞瓦片可通过坐标转换获取瓦片ID或碰撞接触检测两种方式实现，以下是具体步骤和代码：

方法一：通过玩家位置直接获取对应瓦片 #

适合无需精准碰撞接触点，仅检测玩家当前所在瓦片的场景。

1. 准备工作

   • 确保玩家节点（如CharacterBody2D）的碰撞形状与TileMap的碰撞层/掩码匹配。
   • 获取TileMap节点引用：

     private TileMap _tileMap;
     
     public override void _Ready()
     {
         _tileMap = GetNode<TileMap>("Path/To/Your/TileMap"); // 替换为实际节点路径
     }
     

2. 移动完成时检测（推荐）
   利用CharacterBody2D的_MovementFinished()方法，避免移动过程中重复触发：

   public override void _MovementFinished()
   {
       base._MovementFinished();
       // 转换玩家全局位置为TileMap的瓦片网格坐标
       Vector2 localPos = _tileMap.GlobalToLocal(GlobalPosition);
       Vector2i tileCoords = _tileMap.LocalToMap(localPos);
   
       // 获取目标瓦片ID
       int tileId = _tileMap.GetCellv(tileCoords);
   
       // 判断是否为特殊瓦片（替换为你的目标瓦片ID）
       if (tileId == 12) // 示例ID
       {
           // 执行特殊行为逻辑
           GD.Print("触发特殊瓦片交互");
       }
   }
   

方法二：通过碰撞接触精准检测瓦片 #

适合需要捕捉玩家与瓦片碰撞瞬间的场景。

1. 碰撞检测逻辑
   在玩家节点的_PhysicsProcess()中遍历碰撞体，筛选TileMap并获取碰撞位置对应的瓦片：

   public override void _PhysicsProcess(double delta)
   {
       base._PhysicsProcess(delta);
   
       foreach (var body in GetCollidingBodies())
       {
           if (body is TileMap tileMap)
           {
               // 获取碰撞位置（如需更精准，可通过GetCollisionInfo获取接触点）
               Vector2 collisionGlobalPos = GlobalPosition;
               Vector2i tileCoords = tileMap.GlobalToMap(collisionGlobalPos);
               int tileId = tileMap.GetCellv(tileCoords);
   
               // 批量判断特殊瓦片
               HashSet<int> specialTileIds = new HashSet<int> { 12, 15, 18 }; // 多个目标ID
               if (specialTileIds.Contains(tileId))
               {
                   // 触发特殊行为
                   GD.Print("碰撞到特殊瓦片");
               }
           }
       }
   }
   

关键注意事项 #

• Godot 4.x中瓦片网格坐标使用Vector2i（整数类型），替代了3.x的Vector2，转换时注意类型匹配。
• 若TileMap使用多图层，需在GetCellv()中指定图层索引：_tileMap.GetCellv(tileCoords, 0)（0为默认图层）。
• 确保TileSet中已为瓦片启用碰撞，且碰撞层与玩家的碰撞掩码相互匹配，否则无法触发碰撞检测。

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