Godot 引擎 CLI 是做什麼的？
專為 Godot 遊戲引擎設計的 AI 代理原生命令列工具。可從終端機管理專案、場景、匯出及執行 GDScript。
安裝
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
需求
- Godot 4.x 已加入 PATH（或設定
GODOT_BIN環境變數）
指令
專案管理
# 建立新的 Godot 專案
cli-anything-godot project create <path> [--name "My Game"]
# 取得專案資訊（名稱、功能、主場景）
cli-anything-godot --json -p <project> project info
# 列出所有場景
cli-anything-godot --json -p <project> project scenes
# 列出所有腳本
cli-anything-godot --json -p <project> project scripts
# 列出所有資源
cli-anything-godot --json -p <project> project resources
# 重新匯入專案資源
cli-anything-godot -p <project> project reimport
場景操作
# 使用指定根節點類型建立新場景
cli-anything-godot -p <project> scene create scenes/Level1.tscn --root-type Node3D
# 讀取場景結構（節點、資源、連線）
cli-anything-godot --json -p <project> scene read scenes/Level1.tscn
# 為場景新增子節點
cli-anything-godot -p <project> scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent .
GDScript 執行
# 執行 GDScript 檔案（必須繼承 SceneTree）
cli-anything-godot -p <project> script run tools/build_navmesh.gd
# 執行行內 GDScript 程式碼
cli-anything-godot -p <project> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# 驗證 GDScript 語法
cli-anything-godot -p <project> script validate scripts/player.gd
匯出
# 列出已設定的匯出預設集
cli-anything-godot --json -p <project> export presets
# 匯出所有預設集
cli-anything-godot -p <project> export build
# 匯出指定預設集
cli-anything-godot -p <project> export build --preset "Windows Desktop" --output build/game.exe
引擎
# 檢查 Godot 可用性與可執行檔路徑
cli-anything-godot --json engine status
# 取得引擎版本
cli-anything-godot engine version
JSON 模式
為任何指令加上 --json 旗標，即可輸出結構化 JSON，適合 AI 代理處理：
cli-anything-godot --json -p ./my-game project info
互動式 REPL
cli-anything-godot -p ./my-game session