¿Qué hace CLI de Godot Engine?
CLI nativa para agentes del motor de juegos Godot. Gestiona proyectos, escenas, exportaciones y ejecución de GDScript desde la línea de comandos.
Instalación
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=godot/agent-harness
Requisitos
- Godot 4.x en el PATH (o definir la variable de entorno
GODOT_BIN)
Comandos
Gestión de proyectos
# Crear un nuevo proyecto Godot
cli-anything-godot project create <ruta> [--name "Mi Juego"]
# Obtener información del proyecto (nombre, características, escena principal)
cli-anything-godot --json -p <proyecto> project info
# Listar todas las escenas
cli-anything-godot --json -p <proyecto> project scenes
# Listar todos los scripts
cli-anything-godot --json -p <proyecto> project scripts
# Listar todos los recursos
cli-anything-godot --json -p <proyecto> project resources
# Reimportar recursos del proyecto
cli-anything-godot -p <proyecto> project reimport
Operaciones con escenas
# Crear una nueva escena con tipo de nodo raíz
cli-anything-godot -p <proyecto> scene create scenes/Nivel1.tscn --root-type Node3D
# Leer la estructura de la escena (nodos, recursos, conexiones)
cli-anything-godot --json -p <proyecto> scene read scenes/Nivel1.tscn
# Añadir un nodo hijo a una escena
cli-anything-godot -p <proyecto> scene add-node scenes/Nivel1.tscn --name Jugador --type CharacterBody3D --parent .
Ejecución de GDScript
# Ejecutar un archivo GDScript (debe extender SceneTree)
cli-anything-godot -p <proyecto> script run tools/build_navmesh.gd
# Ejecutar código GDScript en línea
cli-anything-godot -p <proyecto> script inline 'print(ProjectSettings.get_setting("application/config/name"))'
# Validar sintaxis GDScript
cli-anything-godot -p <proyecto> script validate scripts/jugador.gd
Exportación
# Listar plantillas de exportación configuradas
cli-anything-godot --json -p <proyecto> export presets
# Exportar todas las plantillas
cli-anything-godot -p <proyecto> export build
# Exportar una plantilla específica
cli-anything-godot -p <proyecto> export build --preset "Escritorio Windows" --output build/juego.exe
Motor
# Verificar disponibilidad de Godot y ruta del binario
cli-anything-godot --json engine status
# Obtener versión del motor
cli-anything-godot engine version
Modo JSON
Añade la bandera --json a cualquier comando para obtener una salida JSON estructurada, adecuada para el consumo por agentes:
cli-anything-godot --json -p ./mi-juego project info
REPL interactivo
cli-anything-godot -p ./mi-juego session