Cli Anything Godot

作者 hkuds34f519533bc1无许可证51K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库2周前更新

Agent-native CLI for Godot project management, scenes, exports, and script execution.

AI 生成的概览

用于管理 Godot 游戏项目、场景、导出和 GDScript 执行的命令行界面。

功能
为 Godot 游戏引擎提供面向智能体的命令行界面。它可以创建和查看项目,列出场景、脚本和资源,创建场景并添加子节点,运行或校验 GDScript,以及构建导出预设。它还能报告引擎状态和版本,支持 JSON 输出,并提供交互式会话模式。
适用场景
当智能体需要通过命令行处理 Godot 项目时使用,例如查看项目结构、编辑场景、运行 GDScript 或生成游戏构建。它适合自动化 Godot 项目任务,而非通用编码或设计工作。
运行要求
需要 PATH 中有 Godot 4.x,或设置 GODOT_BIN 环境变量指向可执行文件。该 CLI 本身通过 pip 从 Git 仓库安装,因此安装需要 Python 和网络访问。它仅包含说明文档,不附带脚本。

Godot Engine CLI

Agent-native CLI for the Godot game engine. Manage projects, scenes, exports, and GDScript execution from the command line.

Installation

bash
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness

Requirements

  • Godot 4.x on PATH (or set GODOT_BIN env var)

Commands

Project Management

bash
# Create a new Godot projectcli-anything-godot project create <path> [--name "My Game"]
# Get project info (name, features, main scene)cli-anything-godot --json -p <project> project info
# List all scenescli-anything-godot --json -p <project> project scenes
# List all scriptscli-anything-godot --json -p <project> project scripts
# List all resourcescli-anything-godot --json -p <project> project resources
# Re-import project resourcescli-anything-godot -p <project> project reimport

Scene Operations

bash
# Create a new scene with root node typecli-anything-godot -p <project> scene create scenes/Level1.tscn --root-type Node3D
# Read scene structure (nodes, resources, connections)cli-anything-godot --json -p <project> scene read scenes/Level1.tscn
# Add a child node to a scenecli-anything-godot -p <project> scene add-node scenes/Level1.tscn --name Player --type CharacterBody3D --parent .

GDScript Execution

bash
# Run a GDScript file (must extend SceneTree)cli-anything-godot -p <project> script run tools/build_navmesh.gd
# Run inline GDScript codecli-anything-godot -p <project> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# Validate GDScript syntaxcli-anything-godot -p <project> script validate scripts/player.gd

Export

bash
# List configured export presetscli-anything-godot --json -p <project> export presets
# Export all presetscli-anything-godot -p <project> export build
# Export a specific presetcli-anything-godot -p <project> export build --preset "Windows Desktop" --output build/game.exe

Engine

bash
# Check Godot availability and binary pathcli-anything-godot --json engine status
# Get engine versioncli-anything-godot engine version

JSON Mode

Add --json flag to any command for structured JSON output suitable for agent consumption:

bash
cli-anything-godot --json -p ./my-game project info

Interactive REPL

bash
cli-anything-godot -p ./my-game session

来源与署名

来源:hkuds/cli-anything位于skills/cli-anything-godot提交34f5195

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架