Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Enable collision detection for tiles

Add a Tilemap Collider 2D component to a tilemap, choose which tiles collide, and merge shapes with a Composite Collider 2D component for better performance.
Read time 2 minutesLast updated 14 days ago
To enable collision detection for tiles, add a Tilemap Collider 2D component to the tilemap.
The Tilemap Collider 2D component automatically generates collider shapes for each tile in the tilemap, so that GameObjects with a 
Collider2D
component collide with the tiles.
You can choose which tiles to enable collision for.

Add a Tilemap Collider 2D component

To add the component to a tilemap, follow these steps:
  1. Select an existing tilemap GameObject in your project, or create a tilemap.
  2. In the
    Inspector

    ?

    window, select Add Component.
  3. Search for and add the Tilemap Collider 2D component from the list.
The Scene view displays the collider shapes as green outlines over the tilemap.
To make another GameObject collide with the tiles, refer to Collider 2D.

Disable collisions for a tile

Follow these steps:
  1. In the Project window, select a tile asset.
  2. Set Collider Type to None.

Create a custom collider shape

To change the shape that a tile uses to register a collision, use the Custom Physics Shape window in the Sprite Editor.
  1. In the Project window, select a tile asset.
  2. Set the Collider Type to
    Sprite

    ?

    .
  3. Select Sprite Editor.
  4. In the Sprite Editor window, in the dropdown at the top-left, select Custom Physics Shape.
For more information about editing the shape, refer to Create collision shapes for a sprite.

Reduce the number of collider shapes

To improve the performance of a tilemap with many collider shapes, add a Composite Collider 2D component. Unity merges the collider shapes of neighboring tiles together, which reduces how much Unity needs to calculate during a physics update.
Follow these steps:
  1. Select a tilemap with a Tilemap Collider 2D component.
  2. In the Inspector window, select Add Component.
  3. Search for and add the Composite Collider 2D component from the list.
For more information, refer to Composite Collider 2D component reference.
To further configure performance and collider behavior, use the 
TilemapCollider2D
API.

Update collider shapes manually via API

By default, when you add or remove tiles, the Tilemap Collider 2D updates shapes during 
LateUpdate
and batches multiple changes together for performance. To force immediate updates, follow these steps:
  1. Call 
    Tilemaps.TilemapCollider2D.ProcessTilemapChanges
     to process changes immediately.
  2. Check 
    Tilemaps.TilemapCollider2D-hasTilemapChanges
     to determine if processing is required.
For more information, refer to the 
TilemapCollider2D
API.

Additional resources