Godot 瓦片地图入门：TileMapLayer、TileSet、碰撞和 Codex 辅助开发

1
2
3
4
5
6

World (Node2D)
├─ Ground (TileMapLayer)       # 草地、道路、地板
├─ Decoration (TileMapLayer)   # 花草、裂纹、阴影
├─ Walls (TileMapLayer)        # 墙壁、障碍物
├─ Objects (Node2D)            # 宝箱、门、NPC、金币
└─ Player (CharacterBody2D)

1

tileset.png

1
2
3

16 × 16
32 × 32
64 × 64

1
2

Node2D
└─ TileMapLayer

1

Ground

1

Tile Set

1
2

<empty>
→ New TileSet

1

32 × 32

1

Physics Layers

1

Add Element

1
2

Collision Layer: 1
Collision Mask: 1

1
2
3

Player (CharacterBody2D)
├─ Sprite2D
└─ CollisionShape2D

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

extends CharacterBody2D

@export var speed: float = 200.0


func _physics_process(_delta: float) -> void:
	var direction := Input.get_vector(
		"move_left",
		"move_right",
		"move_up",
		"move_down"
	)

	velocity = direction * speed
	move_and_slide()

1
2

调试
→ 可见碰撞形状

1
2
3
4

World
├─ Ground
├─ Walls
└─ Decoration

1
2
3
4

Ground: 0
Walls: 1
Decoration: 2
Player: 3

1
2

World
└─ Ground

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

extends Node2D

@onready var ground: TileMapLayer = $Ground

const SOURCE_ID: int = 0
const GRASS_TILE: Vector2i = Vector2i(0, 0)


func place_grass(cell: Vector2i) -> void:
	ground.set_cell(
		cell,
		SOURCE_ID,
		GRASS_TILE
	)

1

place_grass(Vector2i(5, 3))

1
2

var local_position := ground.to_local(get_global_mouse_position())
var cell := ground.local_to_map(local_position)

1

var position_in_layer := ground.map_to_local(cell)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

extends Node2D

@onready var ground: TileMapLayer = $Ground

const SOURCE_ID: int = 0
const GRASS_TILE: Vector2i = Vector2i(0, 0)


func _unhandled_input(event: InputEvent) -> void:
	if event is InputEventMouseButton:
		if event.button_index == MOUSE_BUTTON_LEFT and event.pressed:
			var local_position := ground.to_local(
				get_global_mouse_position()
			)
			var cell := ground.local_to_map(local_position)

			ground.set_cell(
				cell,
				SOURCE_ID,
				GRASS_TILE
			)

1

ground.erase_cell(cell)

1
2
3

Coin (Area2D)
├─ Sprite2D
└─ CollisionShape2D

1
2

World
└─ Objects

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

这是一个 Godot 4.x 项目。

场景结构：

World：Node2D
├─ Ground：TileMapLayer
├─ Walls：TileMapLayer
├─ Objects：Node2D
└─ Player：CharacterBody2D

请为 World 编写脚本：

1. 把鼠标世界坐标转换成 Ground 的格子坐标；
2. 左键放置草地瓦片；
3. 右键清除瓦片；
4. SOURCE_ID 和 atlas 坐标使用 @export 配置；
5. 使用 Godot 4.x TileMapLayer API；
6. 使用静态类型；
7. 不修改 TileSet 和场景节点名称。

1
2
3
4
5

TileSet 负责瓦片素材和规则
TileMapLayer 负责绘制某一层地图
碰撞写在 TileSet 的瓦片上
有行为的对象做成独立场景
Codex 负责围绕真实节点结构写脚本

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

生成一张适合 Godot 4 TileSet 使用的顶视角 2D 瓦片素材图集。

画面要求：
- 风格：统一的像素艺术风格
- 视角：严格顶视角，不要透视，不要等距视角
- 单个瓦片逻辑尺寸：32×32 像素
- 所有瓦片按照规则网格整齐排列
- 每个瓦片占用完全相同的正方形区域
- 瓦片之间不要重叠
- 瓦片之间不要留不规则空隙
- 透明背景
- 无文字、无数字、无标签、无 UI、无边框
- 不要展示游戏角色
- 不要生成完整地图场景
- 不要使用倾斜镜头
- 不要添加整张图统一的光照或阴影
- 每个瓦片的光照方向保持一致

素材内容：
第一行：
1. 普通草地
2. 深色草地
3. 稀疏草地
4. 泥土地面
5. 石板地面
6. 沙土地面

第二行：
1. 横向道路
2. 纵向道路
3. 左上转角道路
4. 右上转角道路
5. 左下转角道路
6. 右下转角道路

第三行：
1. 水面中心
2. 水面上边缘
3. 水面下边缘
4. 水面左边缘
5. 水面右边缘
6. 水面外角

第四行：
1. 石墙中心
2. 石墙顶部
3. 石墙底部
4. 石墙左侧
5. 石墙右侧
6. 石墙转角

第五行：
1. 小花
2. 小石头
3. 草丛
4. 树桩
5. 地面裂纹
6. 落叶

技术要求：
- 所有地面瓦片必须能够无缝重复平铺
- 道路、水面和墙体的边缘必须能相互连接
- 图案不能跨越到相邻瓦片
- 每个瓦片边缘像素必须与连接方向保持一致
- 输出为一张完整 PNG 图集
- 图集布局为 6 列 × 5 行
- 不要生成预览场景，只生成瓦片素材表

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

生成一张适合 Godot 4 TileSet 使用的顶视角像素风瓦片图集。

要求：
- 严格顶视角
- 单个瓦片逻辑尺寸为 32×32
- 6 列 × 3 行规则网格
- 透明背景
- 所有格子大小完全一致
- 无文字、无标签、无 UI、无角色
- 不要生成完整地图
- 风格和光照保持统一

第一行：
普通草地、深色草地、稀疏草地、泥土、沙地、石地

第二行：
细草、碎石、花朵、落叶、地面裂纹、小蘑菇

第三行：
浅色草地变化、深色泥土变化、湿润泥土、苔藓石地、干燥沙地、鹅卵石地面

技术要求：
- 所有地面瓦片能够上下左右无缝重复平铺
- 瓦片边缘不能出现明显断层
- 细节不能跨越相邻格子
- 输出为单张 PNG 图集

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

生成一套适合 Godot 4 Terrain 系统的顶视角像素风草地与泥土连接瓦片。

规格：
- 单个瓦片逻辑尺寸：32×32
- 严格顶视角
- 规则网格排列
- 透明背景
- 统一像素密度
- 统一光照方向
- 无文字、无 UI、无角色、无完整场景

需要包含：
- 纯草地中心
- 纯泥土中心
- 草地包围泥土的上边缘
- 下边缘
- 左边缘
- 右边缘
- 左上外角
- 右上外角
- 左下外角
- 右下外角
- 左上内角
- 右上内角
- 左下内角
- 右下内角
- 横向窄泥土道路
- 纵向窄泥土道路
- 十字连接
- T 形连接

要求所有边缘像素能够严格对应和无缝连接。
不要省略内角和外角。
每个连接瓦片必须单独占据一个完整网格。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

生成一套适合 Godot 4 TileSet 的顶视角像素风水面瓦片图集。

要求：
- 单个瓦片逻辑尺寸：32×32
- 规则网格排列
- 透明背景
- 严格顶视角
- 水面颜色和波纹风格统一
- 无文字、无标签、无 UI、无完整地图

内容包括：
- 水面中心
- 水面变化块 1
- 水面变化块 2
- 上岸边
- 下岸边
- 左岸边
- 右岸边
- 左上外角
- 右上外角
- 左下外角
- 右下外角
- 左上内角
- 右上内角
- 左下内角
- 右下内角
- 小型水波
- 漂浮树叶
- 水中石块

岸边使用自然泥土和少量青草。
所有边缘必须能够上下左右无缝连接。
每个瓦片内容不能越过自己的网格区域。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

生成一张适合 Godot 4 的顶视角像素风地牢瓦片素材图集。

规格：
- 单个瓦片逻辑尺寸：32×32
- 6 列 × 5 行规则网格
- 透明背景
- 严格顶视角
- 暗灰色石头地牢风格
- 统一像素密度和统一光照方向
- 不要角色，不要完整房间，不要 UI 和文字

内容包括：
- 普通石地板
- 裂纹石地板
- 苔藓石地板
- 血迹石地板
- 石墙中心
- 石墙顶部
- 石墙左右边缘
- 墙体内角
- 墙体外角
- 门洞
- 铁门
- 石柱
- 火把底座
- 木箱
- 木桶
- 碎石
- 骨头
- 铁链
- 地面陷阱

所有地板必须能够无缝平铺。
墙体边缘和转角必须能够正确连接。
每个物件必须完整位于自己的格子中。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

生成一张适合 Godot 4 TileSet 使用的顶视角手绘卡通风瓦片图集。

要求：
- 单个瓦片逻辑尺寸为 64×64
- 严格顶视角
- 柔和手绘风格
- 清晰轮廓
- 统一笔触
- 统一光照
- 规则网格排列
- 透明背景
- 不要完整地图场景
- 无文字、无 UI、无人物

内容：
草地、泥土、沙地、石路、水面、道路边缘、草地与泥土连接边缘、小花、小石头、草丛。

所有基础地面必须能够无缝平铺。
边缘图案必须能与相邻瓦片连接。
每个瓦片保持独立，不能跨格。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

no perspective view,
no isometric view,
no complete map,
no characters,
no text,
no labels,
no UI,
no irregular grid,
no overlapping tiles,
no inconsistent tile sizes,
no borders,
no mockup,
no screenshot,
no realistic photography,
no shadows crossing tile boundaries,
no objects cut off by tile edges

1
2
3
4

不要透视，不要等距视角，不要完整地图，不要角色，
不要文字，不要标签，不要 UI，不要预览边框，
不要不规则网格，不要瓦片重叠，不要尺寸不一致，
不要跨格阴影，不要让物体被网格边缘截断。

1
2
3
4
5

no preview scene,
no game screenshot,
no map mockup,
only a tile atlas,
only separate tiles in a regular grid

1
2
3
4
5

瓦片逻辑尺寸：32×32
图集布局：6×4 或 6×5
最终生成图：1024×1024 或更高
背景：透明
风格：像素风

1
2

保持与上一套素材完全相同的颜色、笔触、像素密度、
视角、光照方向和轮廓风格。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

生成一张适合 Godot 4 TileSet 使用的顶视角像素风基础地面瓦片图集。

单个瓦片逻辑尺寸为 32×32。
图集使用 6 列 × 3 行规则网格。
透明背景。
严格顶视角，无透视，无等距角度。
所有瓦片大小完全相同，整齐对齐。
统一像素密度、颜色风格和光照方向。

第一行：
普通草地、深色草地、浅色草地、普通泥土、深色泥土、沙地。

第二行：
灰色石地、苔藓石地、鹅卵石地面、湿润泥土、枯草地、碎石地。

第三行：
小花草装饰、草丛装饰、小石头装饰、落叶装饰、
地面裂纹装饰、小蘑菇装饰。

所有基础地面必须能够上下左右无缝重复平铺。
装饰物必须完整位于自己的瓦片内部。
不要生成完整地图。
不要人物。
不要文字、数字、标签、UI、边框或预览说明。
不要让任何图案跨越相邻瓦片。
输出为单张透明 PNG 图集。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

请严格参考我提供的 tileset 图集，使用图集中已有的地面、道路、水面、石墙和装饰元素，拼成一张完整、合理、可用于俯视角 RPG 的森林村庄场景。

场景规格：

严格顶视角
不使用透视或等距视角
地图逻辑尺寸为 24×18 个瓦片
每个瓦片逻辑尺寸为 32×32
保持参考 tileset 的原始画风、颜色、纹理、光照方向和比例
不改变瓦片的设计
不新增参考图中不存在的建筑、角色或大型物体
不生成 UI、文字、边框或网格线
输出完整场景，不输出 tileset 图集

地图结构：

地图底层主要使用普通草地，少量混合深色草地和稀疏草地，避免大面积完全重复。
地图下方中央设置一个清晰的入口。
从入口开始铺设一条纵向主路，延伸到地图中央。
主路在地图中央分成左右两条支路，所有道路必须连通，不能出现断路或无意义的道路碎片。
地图右上区域设置一个自然形状的小水池。
水池必须由水面中心、上下左右边缘和转角正确拼接，不能出现水面直接截断或岸边方向错误。
地图左上区域设置一段石墙围合区域，墙体边缘和转角必须正确连接。
水池、石墙和地图边缘之间必须保留至少一个瓦片宽的可通行区域。
地图中央保留一个较开阔的活动区域，方便角色移动。
不要让水池或石墙完全堵住主路。

装饰规则：

小花主要分布在草地区域，不能铺在道路和水面上。
小石头可以少量放在泥土、道路边缘或稀疏草地上。
草丛集中放在地图边缘、水池附近和墙角。
树桩只能少量出现，作为视觉兴趣点，不要堵塞主路。
地面裂纹只放在泥土或干燥区域。
落叶集中在地图角落和墙边。
道路中央保持干净，装饰主要放在道路两侧。
地图中心装饰较少，地图四周装饰密度较高。
不要在每个格子都放装饰，保留自然留白。

合理性要求：

所有道路必须有明确用途并互相连通。
所有可通行区域必须从入口到达。
水面、墙体和道路连接方向必须正确。
不出现孤立的单块水面、单块墙体或错误转角。
不出现无法进入的狭小封闭空间。
地图应像真实设计过的游戏关卡，而不是随机堆放瓦片。
画面需要有主次关系：入口引导玩家进入，主路引向中心，水池和石墙作为次要视觉焦点。

只生成一张完整的俯视角地图场景。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

请根据以下规则设计一张 24×18 的俯视角 RPG 森林地图布局。

地图符号：
G = 普通草地
D = 深色草地
S = 稀疏草地
R = 道路
W = 水面
A = 石墙
F = 小花
K = 小石头
B = 草丛
U = 树桩
C = 地面裂纹
L = 落叶
P = 玩家入口

设计要求：

P 位于地图下方中央。
从 P 开始必须有一条道路通向地图中央。
道路在中央分成左右支路，所有道路必须连通。
右上区域设置一个面积约为 4×5 的自然形状水池。
左上区域设置一段合理连接的石墙。
地图中央保留至少 7×5 的开阔活动区。
水池、墙体和地图边缘之间至少保留一格可通行空间。
玩家必须能从 P 到达所有主要道路和开阔区域。
不允许出现封闭的单格草地区域。
不允许道路、水面或墙体出现无意义的单格碎片。
装饰不能阻挡主要道路。
地图边缘装饰较多，中央区域装饰较少。
小花只放在草地上。
地面裂纹只放在泥土或稀疏草地区域。
落叶主要放在角落和墙体附近。
保持整体自然、不完全对称，但结构清晰。

输出要求：

第一部分只输出完整的 24×18 字符网格。
每行必须正好包含 24 个字符。
总共必须正好输出 18 行。
第二部分列出入口坐标、道路节点、水池范围和墙体范围。
第三部分检查地图是否存在断路、封闭区域或无法到达区域。
不生成图片。

1
2
3
4
5
6
7
8
9

请检查上面的字符地图：
1. P 是否能到达所有 R 道路；
2. 是否存在孤立的 W 水面；
3. 是否存在孤立的 A 石墙；
4. 是否存在被水面或墙体封死的可通行区域；
5. 每一行是否正好 24 个字符；
6. 总行数是否正好 18 行。

如果发现问题，请输出修正后的完整 24×18 地图。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

这是一个 Godot 4.x 项目，需要使用现有 TileSet 创建一张完整地图。

场景结构：

World：Node2D
├─ Ground：TileMapLayer
├─ Roads：TileMapLayer
├─ Water：TileMapLayer
├─ Walls：TileMapLayer
├─ Decorations：TileMapLayer
└─ PlayerSpawn：Marker2D

tileset 图集为 6 列 × 5 行，坐标定义如下：

第一行：
(0,0) 普通草地
(1,0) 深色草地
(2,0) 稀疏草地
(3,0) 泥土地面
(4,0) 石板地面
(5,0) 沙土地面

第二行：
(0,1) 横向道路
(1,1) 纵向道路
(2,1) 左上转角道路
(3,1) 右上转角道路
(4,1) 左下转角道路
(5,1) 右下转角道路

第三行：
(0,2) 水面中心
(1,2) 水面上边缘
(2,2) 水面下边缘
(3,2) 水面左边缘
(4,2) 水面右边缘
(5,2) 水面外角

第四行：
(0,3) 石墙中心
(1,3) 石墙顶部
(2,3) 石墙底部
(3,3) 石墙左侧
(4,3) 石墙右侧
(5,3) 石墙转角

第五行：
(0,4) 小花
(1,4) 小石头
(2,4) 草丛
(3,4) 树桩
(4,4) 地面裂纹
(5,4) 落叶

任务：

创建一张 24×18 的森林村庄地图。
地图下方中央设置玩家入口。
主路从入口通向中央，并在中央分成左右支路。
右上角创建一个合理连接的小水池。
左上角创建一段合理连接的石墙。
中央保留开阔区域。
所有道路必须连通。
水面和墙体不能堵死通路。
装饰主要放在地图边缘、水池附近和墙角。
道路中央不要放装饰。
不出现孤立水块、孤立墙块或错误方向的转角。
source_id 使用 @export 配置。
使用 Godot 4 TileMapLayer.set_cell()。
使用静态类型。
地图数据和绘制逻辑分开。
在代码中加入地图尺寸检查和可达性检查。
如果现有 tileset 缺少完成某种连接所需的瓦片，不要猜测或用错误瓦片替代，应明确指出缺失项。

先读取当前项目、场景和 TileSet 资源，确认真实 source_id 和 atlas 坐标，再修改代码。不要直接假设 source_id 等于 0。

1

先读取当前项目、场景和 TileSet 资源，确认真实 source_id 和 atlas 坐标，再修改代码。不要直接假设 source_id 等于 0。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

这是一个 Godot 4.x 项目。

请先不要修改任何文件。

请完成以下检查：

1. 读取当前场景结构；
2. 找到所有 TileMapLayer 节点；
3. 找到它们使用的 TileSet；
4. 确认真实 source_id；
5. 列出 tileset 中每个 atlas 坐标对应的瓦片；
6. 判断是否足够拼出 24×18 森林村庄地图；
7. 如果缺少道路、水面或墙体连接瓦片，请明确列出缺失项；
8. 给出地图数据结构设计；
9. 给出可达性检查方案；
10. 暂时不要写代码。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

现在开始实现地图生成脚本。

要求：

1. 只修改 World 的脚本；
2. 不修改 TileSet；
3. 不修改场景节点名称；
4. 地图尺寸为 24×18；
5. 使用数组或字典保存地图数据；
6. 使用 TileMapLayer.set_cell() 绘制；
7. 使用 @export 配置 source_id 和关键 atlas 坐标；
8. 添加地图尺寸检查；
9. 添加道路连通性检查；
10. 添加从 PlayerSpawn 到主要区域的可达性检查；
11. 如果检查失败，push_error() 输出原因；
12. 修改完成后说明如何在 Godot 中测试。

1
2
3
4
5
6

所有道路必须互相连通，并具有明确用途。
不要出现孤立的单块水面、墙体或道路。
地图中心保持可读，地图边缘增加装饰密度。
每个主要区域必须能够从玩家入口到达。
装饰物不能阻挡主要通行路线。
先设计地图结构，再添加装饰。

1

先结构，后装饰。