level-design-patterns

Level Design Patterns

Godot TileMap Configuration

# TileMap setup and painting at runtime
class_name LevelTileMap extends TileMap

const LAYER_GROUND: int = 0
const LAYER_DECOR: int = 1
const SOURCE_ID: int = 0  # TileSet source index

func paint_tile(pos: Vector2i, atlas_x: int, atlas_y: int, layer: int = LAYER_GROUND) -> void:
    set_cell(layer, pos, SOURCE_ID, Vector2i(atlas_x, atlas_y))

func clear_tile(pos: Vector2i, layer: int = LAYER_GROUND) -> void:
    erase_cell(layer, pos)

func get_terrain_type(pos: Vector2i) -> StringName:
    var tile_data: TileData = get_cell_tile_data(LAYER_GROUND, pos)
    if tile_data:
        return tile_data.get_custom_data(&"terrain_type") as StringName
    return &""

# Terrain autotile: paint using terrain set instead of individual atlas coords
func paint_terrain_region(positions: Array[Vector2i], terrain_set: int, terrain: int) -> void:
    set_cells_terrain_connect(LAYER_GROUND, positions, terrain_set, terrain)

NavigationRegion3D Baking Parameters

# Configure NavMesh baking for specific agent types
@tool
class_name NavMeshConfigurator extends EditorScript

func configure_for_humanoid(nav_region: NavigationRegion3D) -> void:
    var mesh := NavigationMesh.new()
    # Agent dimensions
    mesh.agent_radius = 0.5         # Half character width
    mesh.agent_height = 1.8         # Character height
    mesh.agent_max_climb = 0.35     # Step height (stair riser)
    mesh.agent_max_slope = 45.0     # Max walkable slope degrees
    # Mesh generation precision
    mesh.cell_size = 0.25           # Smaller = more precise, slower bake
    mesh.cell_height = 0.1
    # Filtering
    mesh.filter_low_hanging_obstacles = true
    mesh.filter_ledge_spans = true
    mesh.filter_walkable_low_height_spans = true
    nav_region.navigation_mesh = mesh

func bake_async(nav_region: NavigationRegion3D) -> void:
    # Bake on background thread to avoid frame hitches
    nav_region.bake_navigation_mesh(true)  # true = on_thread