Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

TileSet

Inherits: Resource < RefCounted < Object

Tile library for tilemaps.

Description

A TileSet is a library of tiles for a TileMap. A TileSet handles a list of TileSetSource, each of them storing a set of tiles.

Tiles can either be from a TileSetAtlasSource, which renders tiles out of a texture with support for physics, navigation, etc., or from a TileSetScenesCollectionSource, which exposes scene-based tiles.

Tiles are referenced by using three IDs: their source ID, their atlas coordinates ID, and their alternative tile ID.

A TileSet can be configured so that its tiles expose more or fewer properties. To do so, the TileSet resources use property layers, which you can add or remove depending on your needs.

For example, adding a physics layer allows giving collision shapes to your tiles. Each layer has dedicated properties (physics layer and mask), so you may add several TileSet physics layers for each type of collision you need.

See the functions to add new layers for more information.

Tutorials

Properties

TileLayout

tile_layout

0

TileOffsetAxis

tile_offset_axis

0

TileShape

tile_shape

0

Vector2i

tile_size

Vector2i(16, 16)

bool

uv_clipping

false

Methods

void

add_custom_data_layer ( int to_position=-1 )

void

add_navigation_layer ( int to_position=-1 )

void

add_occlusion_layer ( int to_position=-1 )

int

add_pattern ( TileMapPattern pattern, int index=-1 )

void

add_physics_layer ( int to_position=-1 )

int

add_source ( TileSetSource source, int atlas_source_id_override=-1 )

void

add_terrain ( int terrain_set, int to_position=-1 )

void

add_terrain_set ( int to_position=-1 )

void

cleanup_invalid_tile_proxies ( )

void

clear_tile_proxies ( )

Array

get_alternative_level_tile_proxy ( int source_from, Vector2i coords_from, int alternative_from )

Array

get_coords_level_tile_proxy ( int source_from, Vector2i coords_from )

int

get_custom_data_layer_by_name ( String layer_name ) const

String

get_custom_data_layer_name ( int layer_index ) const

Variant.Type

get_custom_data_layer_type ( int layer_index ) const

int

get_custom_data_layers_count ( ) const

bool

get_navigation_layer_layer_value ( int layer_index, int layer_number ) const

int

get_navigation_layer_layers ( int layer_index ) const

int

get_navigation_layers_count ( ) const

int

get_next_source_id ( ) const

int

get_occlusion_layer_light_mask ( int layer_index ) const

bool

get_occlusion_layer_sdf_collision ( int layer_index ) const

int

get_occlusion_layers_count ( ) const

TileMapPattern

get_pattern ( int index=-1 )

int

get_patterns_count ( )

int

get_physics_layer_collision_layer ( int layer_index ) const

int

get_physics_layer_collision_mask ( int layer_index ) const

PhysicsMaterial

get_physics_layer_physics_material ( int layer_index ) const

int

get_physics_layers_count ( ) const

TileSetSource

get_source ( int source_id ) const

int

get_source_count ( ) const

int

get_source_id ( int index ) const

int

get_source_level_tile_proxy ( int source_from )

Color

get_terrain_color ( int terrain_set, int terrain_index ) const

String

get_terrain_name ( int terrain_set, int terrain_index ) const

TerrainMode

get_terrain_set_mode ( int terrain_set ) const

int

get_terrain_sets_count ( ) const

int

get_terrains_count ( int terrain_set ) const

bool

has_alternative_level_tile_proxy ( int source_from, Vector2i coords_from, int alternative_from )

bool

has_coords_level_tile_proxy ( int source_from, Vector2i coords_from )

bool

has_source ( int source_id ) const

bool

has_source_level_tile_proxy ( int source_from )

Array

map_tile_proxy ( int source_from, Vector2i coords_from, int alternative_from ) const

void

move_custom_data_layer ( int layer_index, int to_position )

void

move_navigation_layer ( int layer_index, int to_position )

void

move_occlusion_layer ( int layer_index, int to_position )

void

move_physics_layer ( int layer_index, int to_position )

void

move_terrain ( int terrain_set, int terrain_index, int to_position )

void

move_terrain_set ( int terrain_set, int to_position )

void

remove_alternative_level_tile_proxy ( int source_from, Vector2i coords_from, int alternative_from )

void

remove_coords_level_tile_proxy ( int source_from, Vector2i coords_from )

void

remove_custom_data_layer ( int layer_index )

void

remove_navigation_layer ( int layer_index )

void

remove_occlusion_layer ( int layer_index )

void

remove_pattern ( int index )

void

remove_physics_layer ( int layer_index )

void

remove_source ( int source_id )

void

remove_source_level_tile_proxy ( int source_from )

void

remove_terrain ( int terrain_set, int terrain_index )

void

remove_terrain_set ( int terrain_set )

void

set_alternative_level_tile_proxy ( int source_from, Vector2i coords_from, int alternative_from, int source_to, Vector2i coords_to, int alternative_to )

void

set_coords_level_tile_proxy ( int p_source_from, Vector2i coords_from, int source_to, Vector2i coords_to )

void

set_custom_data_layer_name ( int layer_index, String layer_name )

void

set_custom_data_layer_type ( int layer_index, Variant.Type layer_type )

void

set_navigation_layer_layer_value ( int layer_index, int layer_number, bool value )

void

set_navigation_layer_layers ( int layer_index, int layers )

void

set_occlusion_layer_light_mask ( int layer_index, int light_mask )

void

set_occlusion_layer_sdf_collision ( int layer_index, bool sdf_collision )

void

set_physics_layer_collision_layer ( int layer_index, int layer )

void

set_physics_layer_collision_mask ( int layer_index, int mask )

void

set_physics_layer_physics_material ( int layer_index, PhysicsMaterial physics_material )

void

set_source_id ( int source_id, int new_source_id )

void

set_source_level_tile_proxy ( int source_from, int source_to )

void

set_terrain_color ( int terrain_set, int terrain_index, Color color )

void

set_terrain_name ( int terrain_set, int terrain_index, String name )

void

set_terrain_set_mode ( int terrain_set, TerrainMode mode )

Enumerations

enum TileShape:

TileShape TILE_SHAPE_SQUARE = 0

Rectangular til