前言¶
在 Godot 4 裏做 2D 遊戲，常見問題不是「引擎不會用」，而是流程散：項目結構怎麼搭、CharacterBody2D 和 TileMap 怎麼分工、像素素材導入參數、HUD 和關卡怎麼掛到場景樹、導出前怎麼在無頭環境驗一下。問通用大模型時，回答往往偏片段，缺少一條能從頭走到可玩、可導出的主線。
下面介紹 SkillHub 上的社區 Skill「2D 遊戲開發（Godot 4）」：把腳手架、場景架構、玩法模板、UI、資產與導出串成一條工作流，並在對話裏用自然語言觸發。
這是什麼¶
「2D 遊戲開發（Godot 4）」是面向 Godot 4 + GDScript 的 Agent Skill，座標爲 @user_51ab3167/2d-game-dev，當前版本 1.0.0，來源爲 community（社區），分類 dev-programming。SkillHub 頁面標註作者爲 joewang；發佈者 ID 爲 user_51ab3167。標籤 requires_api_key=false，安裝後不需要額外 API Key。
它解決的是：在 AI 輔助編碼場景下，用統一規範完成 2D 遊戲從立項到導出 的端到端指導；官方說明明確 只做 2D，3D 應使用 3d-game-dev skill。
核心功能¶
以下能力均來自 SkillHub 官方簡介，可按模塊理解 Agent 會引導的方向。
項目與場景¶
- 項目腳手架與場景樹架構規範，減少節點層級和職責混亂。
玩法模板¶
- CharacterBody2D 角色控制器（平臺跳躍、橫版、俯視角等常見 2D 玩法）。
- TileMap 關卡搭建。
- Area2D 拾取與傷害區域。
- 敵人 AI 等常用 2D 玩法骨架。
UI、資產與驗收¶
- UI / HUD（血條等界面元素）。
- 像素畫導入設置、免費素材源指引。
- 命令行 無頭驗證 與截圖驗收，便於 CI 或本地快速回歸。
- 導出發佈（含導出到網頁、桌面等訴求）。
觸發場景（可直接對 Agent 說）¶
官方列出的典型說法包括：
- 「做一個 2D 遊戲」「用 Godot 做遊戲」
- 「寫個平臺跳躍 / 橫版 / 俯視角 / 彈幕 / roguelike 遊戲」
- 「加個角色控制器 / 相機 / 血條 / 關卡 / 敵人」
- 「遊戲跑不起來幫我查」「導出到網頁 / 桌面」
- 英文：
make a 2D game、platformer / top-down shooter in Godot
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。在 SkillHub 上安裝時，頁面給出的提示是：讓 AI 按官方安裝文檔處理，並安裝座標 @user_51ab3167/2d-game-dev。
方式一：通過 SkillHub CLI（推薦）¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 安裝文檔 執行完整安裝或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能識別不到。不同客戶端路徑不同，官方文檔給出的常用示例如下：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中可執行：
skillhub install user_51ab3167/2d-game-dev --dir ~/.cursor/skills/
裝好後按所用 Agent 的要求重啓或刷新技能列表（SkillHub 文檔說明：未指向正確目錄時往往需要重啓才生效）。
方式二：對話安裝¶
將 SkillHub 頁面提供的提示發給 AI，例如：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_51ab3167/2d-game-dev`。
由 Agent 按文檔完成 CLI 檢查、--dir 選擇與安裝。
典型用法¶
沒有單獨附帶的「一鍵 demo 倉庫」說明時，用法就是：用觸發語打開工作流，再按 Skill 內的 Godot 4 規範逐步落地。
- 說明遊戲類型與視角（平臺跳躍、俯視角射擊、roguelike 等），讓 Agent 按 Skill 搭腳手架與場景樹。
- 指定當前卡點：控制器、TileMap 關卡、敵人、拾取傷害、HUD 等，對照 Skill 中的節點類型與分工改工程。
- 接入或替換素材時，按 Skill 中的像素導入與素材源建議配置 Godot 導入器。
- 運行異常或導出前，要求走 無頭驗證 / 截圖驗收，再執行網頁或桌面導出。
全程使用 Godot 4 與 GDScript；若目標是 3D，應改用 3d-game-dev，避免與本 Skill 範圍衝突。
適用場景與注意¶
適合誰
- 已選 Godot 4 做 2D，希望 AI 按固定架構推進而不是零散貼代碼的獨立開發者或小團隊。
- 需要平臺跳躍、橫版、俯視角、彈幕、roguelike 等 2D 品類時，想快速對齊 CharacterBody2D、TileMap、Area2D 等標準做法的同學。
限制與注意
- 範圍限定 2D；3D 不在本 Skill 內。
- 社區來源（
community），使用前可在 SkillHub 頁面查看版本與說明，自行評估是否納入工作流。 - SkillHub 抓取數據（截至編寫時）：評分 100000，下載 3486；頁面統計會隨時間變化，以官網爲準。
- 安裝統計字段在抓取快照中爲安裝 0，僅作平臺展示參考，不代表 Skill 內容不可用。
結尾¶
「2D 遊戲開發（Godot 4）」把 Godot 4 做 2D 時常拆散的步驟收成一條可對話觸發的工作流：從腳手架、玩法模板到 UI、資產、無頭驗證與導出。若你正在用 Cursor 或其他支持 Skills 的 Agent 做遊戲原型，可按上文安裝到對應 skills 目錄，用官方列出的中英文觸發語直接開工。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_51ab3167/2d-game-dev
- API / 元數據：https://api.skillhub.cn/user_51ab3167/2d-game-dev
- 安裝說明：https://skillhub.cn/install/skillhub.md
