Godot Dev Guide Skill

Godot 4.x 遊戲開發完整指南，專為 AI 輔助開發設計。

核心原則

1. 文件格式差異（最重要！）

CODEBLOCK0

⚠️ AI PITFALL：混淆 GDScript 與資源格式
CODEBLOCK1

2. 類型系統（永遠使用）

CODEBLOCK2

3. 架構模式

CODEBLOCK3

---

快速參考

項目結構

CODEBLOCK4

常用節點

2D	3D	用途
CharacterBody2D	CharacterBody3D	玩家/NPC 移動
RigidBody2D

RigidBody3D | 物理模擬 | | Area2D | Area3D | 碰撞檢測（無物理） | | Sprite2D | MeshInstance3D | 視覺渲染 |

Export 變數

CODEBLOCK5

信號模式

CODEBLOCK6

節點引用

CODEBLOCK7

---

關鍵陷阱清單

陷阱	錯誤寫法	正確寫法
.tres 使用 preload	INLINECODE0	INLINECODE1
.tres 使用 var

var x = 5 | x = 5 |
| 未類型化陣列 | [1, 2, 3] in .tres | Array[int]([1, 2, 3]) |
| 缺少 extresource | 直接使用 id | 先宣告 extresource |
| @onready 初始化 | 在宣告時存取其他節點 | 等到 _ready() |
| 直接修改資源 | resource.value = x | resource.duplicate() |
| 輸入處理 | UI 和遊戲混用 input | UI 用 gui_input |

---

參考文件

主題	路徑
項目結構	INLINECODE8
GDScript 模式

references/02-gdscript-patterns.md |
| 文件格式 | references/03-file-formats.md |
| 場景與節點 | references/04-scenes-nodes.md |
| UI 與輸入 | references/05-ui-input.md |
| 物理系統 | references/06-physics.md |
| 音效與動畫 | references/07-audio-animation.md |
| 性能優化 | references/08-performance.md |
| 導出平台 | references/09-export.md |
| 測試指南 | references/10-testing.md |

---

CLI 快速命令

CODEBLOCK8

---

Version: 1.0.0 | Last Updated: 2026-02-17