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

Debug
→ Visible Collision Shapes

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 は 1 つのマップレイヤーを描画する
衝突は 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 で使用できる、トップダウン視点のピクセル風タイルアトラスを生成してください。

要件：
- 厳密なトップダウン視点
- 1 タイルの論理サイズは 32×32
- 6 列 × 3 行の規則的なグリッド
- 透明背景
- すべてのセルサイズは完全に同一
- 文字、ラベル、UI、キャラクターなし
- 完成したマップを生成しない
- スタイルと光照を統一する

1 行目：
通常の草地、濃い草地、まばらな草地、土、砂地、石地

2 行目：
細い草、砕石、花、落ち葉、地面のひび割れ、小さなキノコ

3 行目：
明るい草地バリエーション、濃い土バリエーション、湿った土、苔むした石地、乾いた砂地、丸石の地面

技術要件：
- すべての地面タイルは上下左右にシームレスに繰り返し配置できること
- タイルの端に明確な継ぎ目が出ないこと
- 細部が隣のセルにはみ出さないこと
- 1 枚の 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 システム向けの、トップダウン視点ピクセル風の草地と土の接続タイルセットを生成してください。

仕様：
- 1 タイルの論理サイズ：32×32
- 厳密なトップダウン視点
- 規則的なグリッド配置
- 透明背景
- 統一されたピクセル密度
- 統一された光源方向
- 文字なし、UI なし、キャラクターなし、完成シーンなし

必要なタイル：
- 純粋な草地中央
- 純粋な土中央
- 草地が土を囲む上端
- 下端
- 左端
- 右端
- 左上外角
- 右上外角
- 左下外角
- 右下外角
- 左上内角
- 右上内角
- 左下内角
- 右下内角
- 横方向の細い土の道
- 縦方向の細い土の道
- 十字接続
- T 字接続

すべての端のピクセルは厳密に対応し、シームレスに接続できること。
内角と外角を省略しないこと。
各接続タイルは 1 つの完全なグリッドセルを単独で占めること。

 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 向けの、トップダウン視点ピクセル風水面タイルアトラスを生成してください。

要件：
- 1 タイルの論理サイズ：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 向けのトップダウン視点ピクセル風ダンジョンタイル素材アトラスを生成してください。

仕様：
- 1 タイルの論理サイズ：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 で使用できる、トップダウン視点の手描きカートゥーン風タイルアトラスを生成してください。

要件：
- 1 タイルの論理サイズは 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 で使用できる、トップダウン視点ピクセル風の基本地面タイルアトラスを生成してください。

1 タイルの論理サイズは 32×32。
アトラスは 6 列 × 3 行の規則的なグリッド。
透明背景。
厳密なトップダウン視点、透視なし、等角投影なし。
すべてのタイルは完全に同じサイズで、きれいに整列。
統一されたピクセル密度、色スタイル、光源方向。

1 行目：
通常の草地、濃い草地、明るい草地、通常の土、濃い土、砂地。

2 行目：
灰色の石地、苔むした石地、丸石の地面、湿った土、枯れ草地、砕石地。

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
51

提供した tileset 図集を厳密に参照し、その中にある地面、道路、水面、石壁、装飾要素だけを使って、トップダウン RPG 用の完全で合理的な森の村シーンを組み立ててください。

シーン仕様：

厳密なトップダウン視点
透視や等角投影を使わない
マップ論理サイズは 24×18 タイル
各タイルの論理サイズは 32×32
参照 tileset の元の画風、色、テクスチャ、光源方向、比率を維持する
タイルのデザインを変更しない
参照画像にない建物、キャラクター、大型オブジェクトを追加しない
UI、文字、枠線、グリッド線を生成しない
tileset 図集ではなく、完成したシーンを出力する

マップ構造：

地図の基礎は通常の草地を中心にし、濃い草地とまばらな草地を少し混ぜて大きな繰り返しを避ける。
地図下部中央に明確な入口を配置する。
入口から地図中央へ縦方向のメイン道路を伸ばす。
メイン道路は中央で左右の分岐に分かれ、すべての道は接続されていること。途切れた道や意味のない断片を作らない。
右上に自然な形の小さな池を置く。
池は水面中央、上下左右の端、角を正しく組み合わせること。水面の切断や岸辺の向き間違いを作らない。
左上に接続された石壁エリアを置く。
壁の端と角は正しく接続する。
池、石壁、地図端の間には少なくとも 1 タイル幅の通行可能領域を残す。
中央にはキャラクターが動ける開けた活動エリアを残す。
池や石壁でメイン道路を完全に塞がない。

装飾ルール：

小さな花は主に草地に置き、道路や水面には置かない。
小石は少量だけ土、道の端、まばらな草地に置ける。
草むらは地図端、池の近く、壁の角に集中させる。
切り株は少量だけ視覚的な見どころとして使い、メイン道路を塞がない。
地面のひび割れは土や乾いた場所にだけ置く。
落ち葉は地図の角や壁の近くに集める。
道路中央はきれいに保ち、装飾は主に道路の両側に置く。
地図中央の装飾は少なめ、外周の装飾は多めにする。
すべてのセルに装飾を置かず、自然な余白を残す。

合理性要件：

すべての道は明確な目的を持ち、互いに接続されていること。
すべての通行可能領域は入口から到達できること。
水面、壁、道路の接続方向は正しいこと。
孤立した単一水面、単一壁、間違った角を作らない。
入れない狭い閉鎖空間を作らない。
マップはランダムにタイルを置いたものではなく、実際に設計されたゲームレベルに見えること。
画面には主従関係が必要：入口がプレイヤーを導き、メイン道路が中央へ向かい、池と石壁が副次的な視覚焦点になる。

完全なトップダウンマップシーンを 1 枚だけ生成する。

 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 の開けた活動エリアを残す。
池、壁、地図端の間には少なくとも 1 マスの通行可能空間を残す。
プレイヤーは P からすべての主要道路と開けた領域に到達できること。
閉じ込められた 1 マス草地領域を作らない。
道路、水面、壁に意味のない 1 マス断片を作らない。
装飾は主要道路を塞がない。
地図端は装飾多め、中央は少なめ。
小花は草地にだけ置く。
地面のひび割れは土またはまばらな草地にだけ置く。
落ち葉は主に角と壁付近に置く。
全体は自然で、完全対称ではないが、構造は明確にする。

出力要件：

第 1 部分は完全な 24×18 文字グリッドだけを出力。
各行は必ず 24 文字。
合計で必ず 18 行。
第 2 部分で入口座標、道路ノード、池の範囲、壁の範囲を列出。
第 3 部分で断路、閉鎖領域、到達不能領域があるか検査。
画像は生成しない。

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. source_id と主要 atlas 座標は @export で設定する；
8. マップサイズ検査を追加する；
9. 道路連結性検査を追加する；
10. PlayerSpawn から主要領域への到達可能性検査を追加する；
11. 検査に失敗したら push_error() で理由を出力する；
12. 変更後、Godot でのテスト方法を説明する。

1
2
3
4
5
6

すべての道路は互いに接続され、明確な用途を持つこと。
孤立した単一の水面、壁、道路を作らないこと。
地図中央は読みやすく保ち、地図端の装飾密度を高めること。
すべての主要エリアはプレイヤー入口から到達できること。
装飾物は主要な通行ルートを塞がないこと。
まずマップ構造を設計し、その後で装飾を追加すること。

1

構造が先、装飾は後。