Skip to content

Tile map Reference

The Tilemap object can be used to display tile-based objects. It's a good way to create maps for RPG, strategy games or create objects by assembling tiles, useful for platformer, retro-looking games, etc... External tilemaps are also supported - but it's recommended to use the built-in, simple Tilemap object for most use cases. Read more explanations about it.

External Tilemap (Tiled/LDtk) collision mask

Invisible object handling collisions with parts of a tilemap.

Object actions

Tilemap JSON file
Set the JSON file containing the Tilemap data to display. This is usually the JSON file exported from Tiled.

See parameters
  • Parameter 0 (👾 Object): Tile map collision mask
  • Parameter 1 (jsonResource): Tilemap JSON file

Tileset JSON file
Set the JSON file with the tileset data (sometimes that is embedded in the Tilemap, so not needed)

See parameters
  • Parameter 0 (👾 Object): Tile map collision mask
  • Parameter 1 (jsonResource): Tileset JSON file

Object conditions

Tilemap JSON file
Check the Tilemap JSON file being used.

See parameters
  • Parameter 0 (👾 Object): Tile map collision mask
  • Parameter 1 (jsonResource): Tilemap JSON file

Tileset JSON file
Check the tileset JSON file being used.

See parameters
  • Parameter 0 (👾 Object): Tile map collision mask
  • Parameter 1 (jsonResource): Tileset JSON file

No expressions for this object.

Tile map

Displays a tile-based map. Recommended for most games that need to use static tiles.

Object actions

Flip tile horizontally (on the grid)
Flip tile horizontally at grid coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Grid X
  • Parameter 2 (🔢 Number): Grid Y
  • Parameter 3 (❓ Yes or No): Flip horizontally

Flip tile horizontally (at position)
Flip tile horizontally at scene coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Position X
  • Parameter 2 (🔢 Number): Position Y
  • Parameter 3 (❓ Yes or No): Flip horizontally

Flip tile vertically (on the grid)
Flip tile vertically at grid coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Grid X
  • Parameter 2 (🔢 Number): Grid Y
  • Parameter 3 (❓ Yes or No): Flip vertically

Flip tile vertically (at position)
Flip tile vertically at scene coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Position X
  • Parameter 2 (🔢 Number): Position Y
  • Parameter 3 (❓ Yes or No): Flip vertically

Remove tile (on the grid)
Remove the tile at the grid coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Grid X
  • Parameter 2 (🔢 Number): Grid Y

Remove tile (at position)
Remove the tile at the scene coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Position X
  • Parameter 2 (🔢 Number): Position Y

Grid column count
Change the grid column count in the tile map.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value

Grid row count
Change the grid row count in the tile map.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value

Tile (on the grid)
Change the id of the tile at the grid coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value
  • Parameter 3 (🔢 Number): Grid X
  • Parameter 4 (🔢 Number): Grid Y

Tile (at position)
Change the id of the tile at the scene coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value
  • Parameter 3 (🔢 Number): Position X
  • Parameter 4 (🔢 Number): Position Y

Object conditions

Tile flipped horizontally (on the grid)
Check if tile at grid coordinates is flipped horizontally.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Grid X
  • Parameter 2 (🔢 Number): Grid Y

Tile flipped horizontally (at position)
Check if tile at scene coordinates is flipped horizontally.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Position X
  • Parameter 2 (🔢 Number): Position Y

Tile flipped vertically (on the grid)
Check if tile at grid coordinates is flipped vertically.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Grid X
  • Parameter 2 (🔢 Number): Grid Y

Tile flipped vertically (at position)
Check if tile at scene coordinates is flipped vertically.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔢 Number): Position X
  • Parameter 2 (🔢 Number): Position Y

Grid column count
Compare the grid column count in the tile map.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Grid row count
Compare the grid row count in the tile map.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Tile (on the grid)
Compare the id of the tile at the grid coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare
  • Parameter 3 (🔢 Number): Grid X
  • Parameter 4 (🔢 Number): Grid Y

Tile (at position)
Compare the id of the tile at the scene coordinates.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare
  • Parameter 3 (🔢 Number): Position X
  • Parameter 4 (🔢 Number): Position Y

Object expressions

Expression Description
Object.GridColumnCount() Return the grid column count in the tile map.
Object.GridRowCount() Return the grid row count in the tile map.
Object.GridX(number, number) Get the grid column coordinates in the tile map corresponding to the scene coordinates.
🔢 Number Position X
🔢 Number Position Y
Object.GridY(number, number) Get the grid row coordinates in the tile map corresponding to the scene coordinates.
🔢 Number Position X
🔢 Number Position Y
Object.TileCenterX(number, number) Get the scene X position of the center of the tile.
🔢 Number Grid X
🔢 Number Grid Y
Object.TileCenterY(number, number) Get the scene Y position of the center of the tile.
🔢 Number Grid X
🔢 Number Grid Y
Object.TileIdAtGrid(number, number) Return the id of the tile at the grid coordinates.
🔢 Number Grid X
🔢 Number Grid Y
Object.TileIdAtPosition(number, number) Return the id of the tile at the scene coordinates.
🔢 Number Position X
🔢 Number Position Y
Object.TilesetColumnCount() Get the number of columns in the tileset.
Object.TilesetRowCount() Get the number of rows in the tileset.

External Tilemap (Tiled/LDtk)

Displays a tiled-based map, made with the Tiled editor (https://www.mapeditor.org/) or the LDtk editor (https://ldtk.io/).

Object actions

Animation speed (FPS)
Set the animation speed of the Tilemap.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Animation speed (in frames per second)

Animation speed scale
Set the animation speed scale of the Tilemap.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Speed scale (1 by default)

Display mode
Set the display mode

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔤 String): Display mode (one of: "visible", "all", "index")

Layer index
Set the layer index of the Tilemap.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Operator
  • Parameter 2 (🔢 Number): Value

Tilemap file (Tiled or LDtk)
Set the Tiled or LDtk file containing the Tilemap data to display. This is usually the main file exported from Tiled/LDtk.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (tilemapResource): Tilemap file (Tiled or LDtk)

Tileset JSON file
Set the JSON file with the tileset data (sometimes that is embedded in the Tilemap, so not needed)

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (tilesetResource): Tileset JSON file

Object conditions

Animation speed (FPS)
Compare the animation speed.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Animation speed to compare to (in frames per second)

Animation speed scale
Compare the animation speed scale.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Speed scale to compare to (1 by default)

Display mode
Compare the value of the display mode.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (🔤 String): Display mode (one of: "visible", "all", "index")

Layer index
Compare the value of the layer index.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Level index
Compare the level index being displayed..

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1: 🟰 Relational operator
  • Parameter 2 (🔢 Number): Value to compare

Tilemap file (Tiled or LDtk)
Check the tilemap file (Tiled or LDtk) being used.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (tilemapResource): Tilemap file (Tiled or LDtk)

Tileset JSON file
Check the tileset JSON file being used.

See parameters
  • Parameter 0 (👾 Object): Tile map
  • Parameter 1 (tilesetResource): Tileset JSON file

Object expressions

Expression Description
Object.AnimationFps() Get the animation speed (in frames per second)
Object.AnimationSpeedScale() Get the Animation speed scale
Object.LayerIndex() Get the layer index being displayed
Object.LevelIndex() Return the level index being displayed..

The Tile map extension is always installed in all GDevelop projects: there is no need to add it from the Project Manager.

This page is an auto-generated reference page about the Tile map feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.