Godot 新手起步：用 VS Code 和 Codex 擴充套件開發 2D 遊戲

1
2
3
4

編輯器
→ 編輯器設定
→ 文字編輯器
→ 外部

1

使用外部編輯器

1

where code.cmd

1

C:\Users\你的使用者名稱\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd

1

{project} --goto {file}:{line}:{col}

1
2
3
4
5

編輯器設定
→ 文字編輯器
→ 行為
→ 檔案
→ Auto Reload Scripts on External Change

1
2
3
4
5
6
7

my_game/
├─ project.godot
├─ AGENTS.md
├─ scenes/
├─ scripts/
├─ assets/
└─ .vscode/

1
2

cd D:\GodotProjects\my_game
code .

1

.vscode/launch.json

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

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "執行 Godot 專案",
            "type": "godot",
            "request": "launch",
            "project": "${workspaceFolder}",
            "debugServer": 6006
        }
    ]
}

1

godotTools.editorPath.godot4

1

D:\Programs\Godot\Godot_v4.7-stable_win64.exe

 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

# Godot Project Instructions

這是一個 Godot 4.x 專案，使用 GDScript。

## 編碼規則

- 只使用 Godot 4.x API。
- 不使用 Godot 3.x 舊語法。
- GDScript 盡量使用靜態型別。
- 使用 snake_case 命名變數和函式。
- 使用 PascalCase 命名 class_name。
- 節點引用優先使用 @onready。
- 可配置參數使用 @export。
- 不隨意更改現有節點名稱。
- 不建立過度複雜的 Manager 架構。
- 每次只實作一個可獨立測試的功能。

## 檔案職責

- scenes/ 保存 .tscn 場景。
- scripts/ 保存 .gd 腳本。
- assets/ 保存圖片、字型和聲音。
- ui/ 保存介面場景和介面腳本。

## 場景修改規則

- 修改 .tscn 前先讀取並理解現有節點結構。
- 不猜測節點名稱和 NodePath。
- 對複雜場景，優先告訴使用者在 Godot 編輯器中手動建立節點。
- 除非任務明確要求，否則不要大範圍重寫 .tscn 檔案。

## 驗證規則

完成任務後：

1. 檢查 GDScript 語法。
2. 檢查資源路徑和節點路徑。
3. 列出修改的檔案。
4. 說明在 Godot 中如何測試。
5. 不聲稱已經執行成功，除非確實執行過驗證。

1

git init

1
2
3
4
5

.godot/
.vscode/*.log
*.tmp
export/
build/

1
2

git add .
git commit -m "初始化 Godot 项目"

1

2D 俯視角射擊原型

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

my_game/
├─ project.godot
├─ AGENTS.md
├─ scenes/
│  ├─ main.tscn
│  ├─ player.tscn
│  ├─ bullet.tscn
│  └─ enemy.tscn
├─ scripts/
│  ├─ main.gd
│  ├─ player.gd
│  ├─ bullet.gd
│  └─ enemy.gd
├─ ui/
│  └─ hud.tscn
└─ assets/

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

這是一個新建的 Godot 4.x GDScript 專案。

我要製作一個最小的 2D 俯視角射擊遊戲。

請先不要修改檔案。

先完成以下工作：

1. 閱讀 project.godot 和目前目錄結構。
2. 判斷目前專案是否已經配置入口場景。
3. 設計最小可行版本。
4. 把任務拆成每一步都可以單獨執行驗證的小任務。
5. 明確哪些節點應該由我在 Godot 編輯器裡建立。
6. 明確哪些腳本適合由你編寫。
7. 只使用 Godot 4.x API。
8. 不要一次生成完整遊戲。
9. 不要直接編寫複雜的 .tscn 檔案。

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

現在只實作玩家移動。

場景結構為：

Player：CharacterBody2D
├─ Sprite2D
└─ CollisionShape2D

腳本路徑：
scripts/player.gd

要求：

- 使用 Input.get_vector
- 使用 move_and_slide
- 使用靜態型別
- 移動速度使用 @export
- 不修改場景節點名稱
- 不實作射擊、生命值或動畫
- 修改後告訴我需要配置哪些 Input Map 動作
- 給出測試步驟

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

在 Godot 中建立節點
        ↓
在 VS Code 中讓 Codex 寫腳本
        ↓
查看 Git diff
        ↓
按 F5 執行
        ↓
把完整錯誤交給 Codex
        ↓
要求最小修改
        ↓
執行成功後 Git commit

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

執行時出現以下錯誤：

貼上完整錯誤訊息

請先定位根本原因。

要求：
- 檢查實際節點結構和 NodePath；
- 只做最小修改；
- 不重構無關程式碼；
- 不修改已經正常工作的功能；
- 修改後解釋錯誤為什麼發生。