在实际 2D 游戏开发中，手动摆放每一个场景元素不仅效率低下，而且难以维护。Godot 引擎内置的 TileMap 节点正是为了解决这个问题而生，它允许开发者使用预先制作好的瓦片（Tile）快速拼接出规整的关卡地图，同时支持自动生成地形、设置碰撞体、添加导航区域等高级功能。对于 2025 年刚开始接触 Godot 的开发者来说，掌握 TileMap 是迈向高效 2D 游戏开发的关键一步。
本文将带你从零开始，理解 TileMap 的核心概念，学会如何准备瓦片集资源，在 Godot 4 中配置并使用 TileMap 节点搭建一个可交互的关卡地图。我们不仅会完成基础的地图拼接，还会涉及碰撞体设置、图层管理以及常见问题的排查方法。无论你是想制作平台跳跃、俯视角 RPG 还是策略地图，TileMap 都是不可或缺的工具。
1. 理解 TileMap 的核心概念与工作流程
1.1 什么是瓦片（Tile）与瓦片集（Tileset）
瓦片是构成 TileMap 的基本单元，通常是一张小型、规整的图片资源，比如一块草地、一段墙壁或一个水面图案。多个瓦片按照规则排列在一张大图中，就形成了瓦片集（Tileset）。Godot 支持将单张图片切割为多个瓦片，也支持直接导入由多个独立图片组成的瓦片集。
在 Godot 4 中，瓦片集资源（.tres文件）独立于场景存在，这意味着你可以在多个 TileMap 节点间复用同一套瓦片集，极大提升了资源管理效率。
1.2 TileMap 节点如何工作
TileMap 节点是 Godot 中用于放置和渲染瓦片的容器。它通过一个不可见的网格来定位每个瓦片的位置。你只需要在瓦片集中选择想要的瓦片，然后在 TileMap 的网格中点击，即可快速填充地图。
Godot 4 对 TileMap 系统进行了重构，引入了更强大的功能：
- 多层 TileMap：允许你在同一位置叠加多个瓦片，例如先铺草地，再在上面放置树木或石块。
- 地形自动拼接：设置地形规则后，Godot 能自动为相邻的瓦片选择正确的边缘图案，避免手动拼接的繁琐。
- 物理、导航与遮挡层：可以直接在瓦片上标记碰撞体、导航区域或光照遮挡区域，无需额外创建节点。
1.3 典型工作流程
使用 TileMap 创建关卡地图的标准流程如下：
- 准备或制作瓦片集图片资源。
- 在 Godot 中创建瓦片集资源（Tileset Resource），并导入图片进行切割。
- 为瓦片配置属性（如碰撞形状、导航区域、自定义数据等）。
- 在场景中添加 TileMap 节点，并为其分配刚刚创建的瓦片集。
- 使用 TileMap 的绘制工具在网格上“绘制”地图。
- 测试地图的碰撞、导航等交互功能。
2. 环境准备与资源导入
2.1 Godot 版本选择与项目创建
Godot 4.0 及以上版本对 TileMap 系统进行了重大升级，建议使用 Godot 4.2 或更高版本以获得最稳定的体验。如果你尚未安装 Godot，可以从官方网站下载标准版（不含 .NET 支持）或 Mono 版（支持 C#）。
创建新项目时，选择“2D 项目”模板。项目设置中，建议将“渲染 > 分辨率”下的“缩放模式”设置为“canvas_items”，并根据目标平台设置一个合适的基础分辨率（如 1920x1080）。
2.2 准备瓦片集资源
对于学习目的，你可以使用开源的瓦片集资源。推荐到 OpenGameArt.org 或 itch.io 搜索“free tileset”获取适合 2D 游戏的资源。确保你使用的资源允许免费学习使用。
一个典型的瓦片集图片可能是一张 PNG 格式的大图，其中包含 16x16、32x32 或 64x64 像素的多个瓦片。例如，一个 256x256 的图片，如果每个瓦片是 32x32，那么它包含 8x8 共 64 个瓦片。
将下载的瓦片集图片放入项目的res://assets/tilesets/目录下（如无此目录请自行创建）。
2.3 创建 Godot 资源目录结构
良好的目录结构有助于长期维护。建议按以下方式组织：
res:// scenes/ main.tscn assets/ tilesets/ grassland_tileset.png scripts/3. 创建并配置瓦片集（Tileset）
3.1 新建 Tileset 资源
在 Godot 编辑器底部面板点击“文件系统”，在assets/tilesets/文件夹上右键，选择“新建 > Resource”。在弹出的资源类型列表中，搜索并选择“TileSet”。将其命名为grassland_tileset.tres并保存。
3.2 导入瓦片集图片并配置源（Source）
- 双击新创建的
grassland_tileset.tres资源，Godot 会打开 TileSet 面板。 - 在面板底部，点击“添加源”（Add Source）按钮，选择“ AtlasGrid 源”（AtlasGrid Source）。这是 Godot 4 中用于处理规整排列瓦片集的新方式。
- 在检查器（Inspector）中，为“Texture”属性分配你的瓦片集图片（如
grassland_tileset.png）。 - 根据你的图片设置正确的瓦片尺寸。例如，如果每个瓦片是 32x32，则将“Atlas Grid > 单元大小”（Cell Size）设置为 x:32, y:32。
- Godot 会自动根据图片尺寸和瓦片大小计算出瓦片数量。你可以在预览窗口中看到网格线划分出的各个瓦片。
3.3 为瓦片配置物理碰撞
为了让角色能够与地图中的障碍物（如墙壁、石块）发生碰撞，需要为相应的瓦片添加碰撞形状。
- 在 TileSet 面板中，选择一个代表障碍物的瓦片（如石头或墙壁图案）。
- 在检查器中展开“物理”（Physics）部分，点击“添加物理层”（Add Physics Layer）。
- 选中该物理层，然后点击“添加多边形”（Add Polygon）或“添加矩形”（Add Rectangle）来绘制碰撞体。对于方形瓦片，通常使用矩形碰撞体即可覆盖整个瓦片区域。
- 拖动矩形框覆盖整个瓦片，确保碰撞体与视觉内容匹配。
注意：Godot 4 允许为一个瓦片设置多个物理层，这意味着你可以为同一个瓦片创建不同用途的碰撞体（如用于角色碰撞的精细形状和用于投射物的简化形状）。
3.4 设置地形自动拼接（可选但推荐）
地形自动拼接是 Godot 4 TileMap 的强大功能之一。它允许你定义瓦片之间的连接规则，让 Godot 自动选择边缘平滑的瓦片图案。
- 在 TileSet 面板顶部，点击“地形集”（Terrain Sets）旁边的“+”号添加一个地形集。
- 为地形集命名，如“Grass”。
- 点击“地形”（Terrains）下的“+”号添加几种地形类型，如“Grass”、“Water”、“Path”。
- 选择瓦片，在“地形”（Terrain）部分为其分配对应的地形类型。
- 使用地形绘制工具时，Godot 会自动为相邻的不同地形生成过渡瓦片。
4. 使用 TileMap 节点构建关卡
4.1 添加并配置 TileMap 节点
在场景中右键点击，选择“添加子节点”（Add Child Node），搜索并添加“TileMap”节点。在检查器中，找到“Tile Set”属性，点击下拉菜单并选择你刚才创建的grassland_tileset.tres资源。
关键参数说明：
- 单元格大小（Cell Size）：应与瓦片集中设置的尺寸一致（如 32x32）。
- 渲染顺序（Rendering Order）：决定瓦片的绘制顺序，“索引顺序”按放置顺序绘制，“从上到下”优先绘制上方的瓦片。
- 图层（Layer）：Godot 4 支持多层 TileMap，点击“管理图层”（Manage Layers）可以添加/删除图层。
4.2 使用绘制工具创建地图
在编辑器顶部工具栏中，找到 TileMap 绘制工具（通常显示为画笔图标）。点击后会展开瓦片选择面板和绘制选项。
- 选择瓦片：在瓦片选择面板中点击你想要使用的瓦片。
- 绘制模式：
- 单点绘制：在网格上点击放置单个瓦片。
- 矩形填充：拖动鼠标绘制矩形区域并批量填充。
- 线形绘制：点击起点和终点绘制直线。
- 橡皮擦：删除已放置的瓦片。
建议的绘制顺序：
- 先在底层铺设基础地形（如草地）。
- 然后在上层添加装饰物（如树木、石块）。
- 如果有地形自动拼接功能，确保先完成基础地形再添加细节。
4.3 使用多层 TileMap 管理视觉层次
Godot 4 的多层 TileMap 允许你在同一位置叠加多个瓦片，这对于创建复杂的视觉层次非常有用。
- 在 TileMap 节点的检查器中，点击“管理图层”（Manage Layers）。
- 添加 2-3 个图层，分别命名为“Ground”、“Decoration”、“Overhead”。
- 将基础地面瓦片放在“Ground”层。
- 将树木、石块等障碍物放在“Decoration”层。
- 将可能遮挡角色的物体（如树冠）放在“Overhead”层。
- 确保图层的 Z 索引（Z Index）顺序正确，通常 Ground < Decoration < Overhead。
4.4 保存场景与测试
完成地图绘制后，将场景保存为level_01.tscn。按下 F5 或点击编辑器右上角的“运行”按钮测试场景。此时你应该能看到绘制的地图，但还没有交互功能。
5. 添加角色与碰撞测试
5.1 创建简单玩家角色
为了测试 TileMap 的碰撞功能，我们需要一个可移动的角色。
- 新建一个 CharacterBody2D 节点，命名为“Player”。
- 为其添加一个 Sprite2D 子节点，并分配一个简单的角色图片。
- 添加一个 CollisionShape2D 子节点，设置合适的碰撞形状（如胶囊形或矩形）。
- 为 Player 节点添加脚本：
extends CharacterBody2D const SPEED = 300.0 func _physics_process(delta): var input_direction = Vector2.ZERO input_direction.x = Input.get_axis("ui_left", "ui_right") input_direction.y = Input.get_axis("ui_up", "ui_down") if input_direction: velocity = input_direction.normalized() * SPEED else: velocity = velocity.move_toward(Vector2.ZERO, SPEED) move_and_slide()5.2 配置输入映射
在项目设置中，找到“输入映射”（Input Map）标签，确保已定义“ui_left”、“ui_right”、“ui_up”、“ui_down”等操作，并绑定到相应的键盘按键（如 WASD 或方向键）。
5.3 测试碰撞功能
将 Player 节点添加到场景中，放置在 TileMap 的空地区域。运行游戏，尝试移动角色。当角色碰到你之前设置了碰撞体的瓦片（如墙壁）时，应该会被阻挡无法通过。
6. 常见问题排查与调试技巧
6.1 瓦片不显示或显示错误
| 问题现象 | 可能原因 | 检查方式 | 解决方案 |
|---|---|---|---|
| 瓦片显示为粉红色错误图案 | 瓦片集资源路径错误或纹理丢失 | 检查 TileMap 节点的 Tile Set 属性是否正确分配 | 重新分配正确的 .tres 文件 |
| 部分瓦片显示为空白 | 瓦片集源配置错误 | 在 TileSet 编辑器中检查 Atlas 源的纹理和单元格大小 | 确保纹理已分配，单元格大小与实际瓦片尺寸匹配 |
| 瓦片位置错乱 | 单元格大小不匹配 | 比较 TileMap 的 Cell Size 和 Tileset 中的瓦片尺寸 | 将两者设置为相同值 |
6.2 碰撞体不生效
如果角色可以穿过应该被阻挡的瓦片：
- 检查瓦片碰撞配置：在 TileSet 编辑器中确认已为障碍物瓦片添加了物理层和碰撞形状。
- 验证物理层启用状态：确保物理层没有被禁用。
- 检查图层碰撞掩码：在 TileMap 节点的“物理”部分，确保“碰撞层”（Collision Layer）与玩家角色的“碰撞掩码”（Collision Mask）有重叠。通常可以先将两者都设置为第 1 位进行测试。
- 重启场景：有时 Godot 编辑器需要重启场景才能使碰撞更改生效。
6.3 性能优化建议
当 TileMap 地图很大时，可能会影响游戏性能：
- 使用 Occluder：为静态障碍物瓦片设置遮挡器，Godot 可以自动剔除屏幕外的瓦片。
- 分块加载：对于超大地图，考虑将地图分为多个小块，根据玩家位置动态加载/卸载。
- 简化碰撞形状：对于大量使用的瓦片，使用简单的矩形碰撞体而非复杂多边形。
- 合并图层：如果多层 TileMap 导致过度绘制，考虑将静态元素合并到同一图层。
6.4 地形自动拼接不工作
如果设置了地形但自动拼接效果不出现：
- 检查地形分配：确保每个瓦片都正确分配了地形类型。
- 验证邻居规则：地形自动拼接依赖于相邻瓦片的地形类型，确保周围瓦片也设置了正确的地形。
- 使用地形绘制模式：在 TileMap 绘制工具中切换到地形模式（地形图标），而不是普通的选择模式。
7. 进阶功能与最佳实践
7.1 使用自定义数据层
Godot 4 的 TileMap 支持为每个瓦片添加自定义数据，这对于游戏逻辑非常有用：
- 在 TileSet 编辑器中，点击“自定义数据层”（Custom Data Layers）添加新层。
- 定义数据类型（如布尔值、整数、字符串）。
- 为特定瓦片设置自定义数据值（如“is_damaging: true”表示伤害性地板）。
- 在游戏中通过代码读取这些数据：
func _check_tile_data(player_position): var tilemap = $TileMap var coords = tilemap.local_to_map(player_position) var data = tilemap.get_cell_tile_data(0, coords) # 0 表示第一层 if data and data.get_custom_data("is_damaging"): player.take_damage()7.2 动态修改 TileMap
你可以在运行时通过代码修改 TileMap：
# 在指定位置放置瓦片 $TileMap.set_cell(0, Vector2i(10, 5), 0, Vector2i(2, 3)) # 图层0，位置(10,5)，源ID 0，瓦片坐标(2,3) # 清除指定位置的瓦片 $TileMap.erase_cell(0, Vector2i(10, 5)) # 获取指定位置的瓦片信息 var atlas_coords = $TileMap.get_cell_atlas_coords(0, Vector2i(10, 5))7.3 与导航系统集成
Godot 4 的导航系统可以直接与 TileMap 集成：
- 在 TileSet 编辑器中为可行走区域添加导航多边形。
- 在场景中添加 NavigationRegion2D 节点。
- 将 TileMap 的导航数据烘焙到 NavigationRegion2D：
func _ready(): var tilemap_navigation = $TileMap.get_navigation_map(0) # 获取指定图层的导航数据 $NavigationRegion2D.navigation_map = tilemap_navigation7.4 版本控制友好实践
TileMap 场景文件可能会很大，不利于版本控制：
- 使用场景继承：将静态地图部分保存为单独的场景，通过实例化引入主场景。
- 分离逻辑与数据：考虑将地图数据导出为 JSON 等格式，运行时动态加载。
- .gitignore 配置：如果使用 Git，可以在 .gitignore 中添加大型二进制资源的过滤规则。
掌握 TileMap 是 Godot 2D 游戏开发的重要里程碑。从简单的静态地图开始，逐步尝试地形自动拼接、多层管理和运行时动态修改，你会发现 TileMap 能够应对各种复杂的地图需求。在实际项目中，结合自定义数据和导航系统，可以创建出既有丰富视觉效果又有深度游戏玩法的关卡设计。
