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

生成一張適合 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

先結構，後裝飾。