Godot Engine CLI
Agentenkompatible CLI für die Godot-Spielengine. Verwalte Projekte, Szenen, Exports und GDScript-Ausführung über die Kommandozeile.
Installation
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
Voraussetzungen
- Godot 4.x im PATH (oder setze die Umgebungsvariable
GODOT_BIN)
Befehle
Projektverwaltung
# Ein neues Godot-Projekt erstellen
cli-anything-godot project create <pfad> [--name "Mein Spiel"]
# Projektinformationen abrufen (Name, Features, Hauptszene)
cli-anything-godot --json -p <projekt> project info
# Alle Szenen auflisten
cli-anything-godot --json -p <projekt> project scenes
# Alle Skripte auflisten
cli-anything-godot --json -p <projekt> project scripts
# Alle Ressourcen auflisten
cli-anything-godot --json -p <projekt> project resources
# Projektressourcen neu importieren
cli-anything-godot -p <projekt> project reimport
Szenenoperationen
# Eine neue Szene mit Wurzelknotentyp erstellen
cli-anything-godot -p <projekt> scene create scenes/Level1.tscn --root-type Node3D
# Szenenstruktur lesen (Knoten, Ressourcen, Verbindungen)
cli-anything-godot --json -p <projekt> scene read scenes/Level1.tscn
# Einen untergeordneten Knoten zu einer Szene hinzufügen
cli-anything-godot -p <projekt> scene add-node scenes/Level1.tscn --name Spieler --type CharacterBody3D --parent .
GDScript-Ausführung
# Eine GDScript-Datei ausführen (muss SceneTree erweitern)
cli-anything-godot -p <projekt> script run tools/build_navmesh.gd
# Inline-GDScript-Code ausführen
cli-anything-godot -p <projekt> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# GDScript-Syntax validieren
cli-anything-godot -p <projekt> script validate scripts/player.gd
Export
# Konfigurierte Export-Voreinstellungen auflisten
cli-anything-godot --json -p <projekt> export presets
# Alle Voreinstellungen exportieren
cli-anything-godot -p <projekt> export build
# Eine bestimmte Voreinstellung exportieren
cli-anything-godot -p <projekt> export build --preset "Windows Desktop" --output build/game.exe
Engine
# Verfügbarkeit und Binärpfad von Godot prüfen
cli-anything-godot --json engine status
# Engine-Version abrufen
cli-anything-godot engine version
JSON-Modus
Füge das Flag --json zu einem beliebigen Befehl hinzu, um eine strukturierte JSON-Ausgabe zu erhalten, die für die Verarbeitung durch Agenten geeignet ist:
cli-anything-godot --json -p ./mein-spiel project info
Interaktive REPL
cli-anything-godot -p ./mein-spiel session