# Godot New > 仅当 godot-deploy 已完成（${WORKSPACE}/godot-editor 存在）且需要**新建 一个游戏项目目录**时激活：用户说「再做一个 / 另一个游戏 / 新建游戏 / new game」，或被 godot-dev 在场景 1/2 让位过来。负责模板推断、复制 templates/<...> → ${WORKSPACE}/、注入 addons/godot_mcp、 覆盖写 ${WORKSPACE}/active-game.json。 用户首次说「做个 XX 游戏」请由 godot-dev 路由进来，不要直接激活本 Skill。 - Skill: `ahang1598/godot-new` (Agent Skill) - Install (CLI): `npx skillmds@latest add ahang1598/godot-new` - Raw SKILL.md: https://api.skillmd.com/api/skills/ahang1598/godot-new/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: ahang1598 (https://skillmd.com/u/ahang1598) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/ahang1598/godot-new --- # 新建 Godot 游戏项目（Skill 自执行版） > 严格遵循 [docs/需求文档/4.23.md](../../docs/需求文档/4.23.md) 场景 1 / 场景 2： > **创建游戏 + 在工作区根目录写一个 JSON 说明当前操作的游戏文件夹。** --- ## 工作区目录契约（4.23.md 强制约定） 本 Skill 创建的项目**必须**作为 `${WORKSPACE}` 的一级子目录，与 `godot-editor/` 和 `active-game.json` 平铺同级（详见 [godot-dev/SKILL.md](../godot-dev/SKILL.md#工作区目录契约4-23-md-强制约定所有子-skill-必须遵守)）： ``` ${WORKSPACE}/ ├── godot-editor/ ← 由 godot-deploy 维护，本 Skill 不动 ├── active-game.json ← 本 Skill 覆盖写入 ├── game1/ ← 第一次新建 └── game2/ ← 用户「再做一个」时新建 ``` **严禁**： - 把项目嵌套在 `godot-editor/` 内或其他子目录中 - 在工作区写除 `/` 与 `active-game.json` 之外的根级别资产 - 修改 `${WORKSPACE}/godot-editor/`（那是 godot-deploy 的领地） --- ## 输入解析 从用户原话提取： | 参数 | 默认 / 推断规则 | |------|----------------| | `projectName` | 优先用户显式给出；否则按下表推断；最后兜底 `my-game` | | `template` | 优先用户显式指定；否则按下表推断；推不出来就 `empty`（4.23.md 要求）| ### 模板推断表（与 [templates/](../../templates/) 目录一致） | 用户描述包含 | 模板 | |-------------|------| | 「平台跳跃 / 横版 / 2D 动作 / 马里奥 / platformer」 | `2d-platformer` | | 「FPS / 第一人称 / 3D 射击 / first-person」 | `3d-fps` | | 「弹幕 / 射击 / 塔防 / RPG / 棋牌 / 卡牌 / 益智 / 2D」等明确小类型 | `default`（带通用骨架） | | 「空白 / 从零 / empty」 或 推不出 | `empty` | ### 项目名推断表 | 关键词 | 项目名 | |--------|-------| | 塔防 / tower defense | `tower-defense` | | RPG | `my-rpg` | | 平台跳跃 / platformer | `platformer-game` | | 弹幕 / 射击 / FPS | `shooter-game` | | 贪吃蛇 / snake | `snake-game` | | 推不出 | `my-game` | 把推断结果**告诉用户**，例如：「将创建项目 `snake-game`，使用模板 `default`」， **不要反问**。如果用户要求改名，再覆盖。 --- ## 执行步骤（PowerShell，依次执行并把输出贴回对话） ```powershell $ws = "${WORKSPACE}" $pluginRoot = "${env:CODEBUDDY_PLUGIN_ROOT}" $projectName = "<上面推断>" $template = "<上面推断>" $projectDir = Join-Path $ws $projectName $templateDir = Join-Path $pluginRoot "templates\$template" if (-not (Test-Path $templateDir)) { Write-Host "[FAIL] 模板不存在: $templateDir"; return } if (Test-Path $projectDir) { Write-Host "[FAIL] 项目目录已存在: $projectDir，请换名或手动删除"; return } # 4.23.md 目录契约：projectName 不得与保留名冲突 if ($projectName -in @("godot-editor", "active-game.json", "addons", ".vscode")) { Write-Host "[FAIL] 项目名 '$projectName' 与工作区保留名冲突，请换名"; return } # 1) 复制模板 Copy-Item -Path $templateDir -Destination $projectDir -Recurse -Force Write-Host "[OK] 已复制模板 $template → $projectDir" # 2) 复制 MCP 插件（4.23.md 要求新项目立刻能被 MCP 操作） $addonsSrc = Join-Path $pluginRoot "addons\godot_mcp" $addonsDst = Join-Path $projectDir "addons\godot_mcp" if (Test-Path $addonsSrc) { New-Item -ItemType Directory -Path (Split-Path $addonsDst) -Force | Out-Null Copy-Item -Path $addonsSrc -Destination $addonsDst -Recurse -Force Write-Host "[OK] 已植入 addons/godot_mcp/" } # 3) 更新 project.godot：写 config/name + 用本机 godot-editor 实际版本替换占位符 # （模板里 config/features 用 "__GODOT_VERSION__" 占位，避免硬编码 4.6） $pg = Join-Path $projectDir "project.godot" $godotVersion = $null $editorExe = Get-ChildItem -Path (Join-Path $ws "godot-editor") -Filter "Godot_v*.exe" ` -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 if ($editorExe) { # 文件名形如 Godot_v4.6-stable_win64.exe → 取出 "4.6" if ($editorExe.Name -match 'Godot_v(\d+\.\d+)') { $godotVersion = $Matches[1] } } if (-not $godotVersion) { Write-Host "[WARN] 未能从 godot-editor 探测到版本，回退使用 4.6" $godotVersion = "4.6" } if (Test-Path $pg) { $content = Get-Content $pg -Raw $content = $content -replace 'config/name="[^"]*"', "config/name=`"$projectName`"" $content = $content -replace '__GODOT_VERSION__', $godotVersion Set-Content $pg -Value $content -Encoding UTF8 Write-Host "[OK] project.godot 已写入 config/name=$projectName, godot 版本=$godotVersion" } # 4) 标准目录骨架（与 docs/AI_GUIDE.md 一致；模板里没有的才补） foreach ($d in @( "assets\audio","assets\fonts","assets\models","assets\textures","assets\ui", "data", "scenes\entities","scenes\levels","scenes\main","scenes\ui", "scripts\autoload","scripts\components","scripts\systems","scripts\ui" )) { New-Item -ItemType Directory -Path (Join-Path $projectDir $d) -Force | Out-Null } # 5) 写入 / 覆盖 active-game.json （4.23.md 强制要求） $activeJson = Join-Path $ws "active-game.json" @{ gameDir = $projectDir projectName = $projectName template = $template godotVersion = $godotVersion createdAt = (Get-Date).ToString("o") pluginVersion = "2.0.0" } | ConvertTo-Json -Depth 5 | Set-Content $activeJson -Encoding UTF8 Write-Host "[OK] active-game.json 已写入根目录: $activeJson" # 6) 配置 godot-tools LSP（VSCode 扩展） $vscodeDir = Join-Path $projectDir ".vscode" New-Item -ItemType Directory -Path $vscodeDir -Force | Out-Null $settings = @{ "godotTools.lsp.serverPort" = 6005; "godotTools.sceneFileConfig" = "open" } $settings | ConvertTo-Json | Set-Content (Join-Path $vscodeDir "settings.json") -Encoding UTF8 Write-Host "[OK] .vscode/settings.json 已配置 LSP 端口 6005" # 7) 自动拉起 Godot 编辑器并加载新项目（节省用户手动双击 + 导入） # --editor --path 是 Godot 官方支持的命令行参数， # 会直接以编辑器模式打开该项目，首次会自动完成 import。 # 插件启用（Plugins 开关）仍然需要用户在 GUI 里勾一下。 $editorExeForLaunch = Get-ChildItem -Path (Join-Path $ws "godot-editor") -Filter "Godot_v*.exe" ` -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1 if ($editorExeForLaunch) { try { Start-Process -FilePath $editorExeForLaunch.FullName ` -ArgumentList @("--editor", "--path", $projectDir) | Out-Null Write-Host "[OK] 已启动 Godot 编辑器并加载项目: $projectDir" $script:editorAutoLaunched = $true } catch { Write-Host "[WARN] 自动启动 Godot 编辑器失败：$($_.Exception.Message)。请手动打开。" $script:editorAutoLaunched = $false } } else { Write-Host "[WARN] 在 ${ws}\godot-editor 下未找到 Godot_v*.exe，跳过自动启动。" $script:editorAutoLaunched = $false } ``` --- ## 完成后引导（**必须**输出） 根据步骤 7 是否成功拉起编辑器，二选一输出： ### A. 编辑器已自动启动（`$editorAutoLaunched -eq $true`） ``` ╔═══════════════════════════════════════════════════════╗ ║ ✓ 新游戏项目创建完成，Godot 编辑器已自动启动 ║ ╠═══════════════════════════════════════════════════════╣ ║ 项目名: ║ ║ 模板: