godot-ai

# Godot AI Godot AI conecta clientes MCP como Claude Code, Claude Desktop, Codex y Hermes Agent a un editor Godot en vivo. Proporciona 46 herramientas y más de 120 operaciones que permiten a los asistentes de IA construir escenas, editar nodos y scripts, conectar señales y configurar UI, materiales, animación, partículas, cámaras y entornos. ## Inicio Rápido ### Requisitos - Godot 4.7+ (dentro de la línea 4.x) para Godot AI v4 - uv (proporciona uvx para el servidor Python) - Un cliente MCP ### Instalación 1. **Proyecto nuevo:** Descargue una versión publicada desde GitHub Releases e instale el complemento en `su-proyecto/addons/godot_ai/` con `plugin.cfg` dentro de ese directorio. 2. **Instalación existente:** Use el botón Actualizar en el panel de Godot AI. La versión final firmada v3 admite migración con un clic a v4. ### Habilitar el Plugin En Godot: **Proyecto → Configuración del Proyecto → Plugins → Godot AI**. El plugin inicia el servidor MCP y muestra el estado de conexión en el panel de Godot AI. ### Conecte su Cliente MCP En el panel, presione **Configurar** junto a su cliente, o **Configurar todos** para cada cliente detectado. Los clientes compatibles incluyen Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor y VS Code. ### Pruébelo Ejemplos de indicaciones: - "Muéstrame la jerarquía de escena actual." - "Crea una Camera3D llamada MainCamera bajo /Main." - "Busca en el proyecto archivos PackedScene en ui/." - "Ejecuta el conjunto de pruebas de la escena." - "Construye un juego de mundo de bloques voxel con un jugador, bloques para colocar y destruir, y ranuras de guardado." ## Cómo Funciona ```text Cliente MCP → godot-ai attach (stdio) → Servidor Python (HTTP autenticado, puerto 8000) → Plugin del editor Godot (WebSocket autenticado, puerto 9500) ``` Ambos saltos locales usan capacidades rotativas independientes; ninguno recurre a acceso no autenticado. El WebSocket del editor permanece solo en bucle local. Para agentes en contenedores u otras máquinas, ejecute el puente en la máquina del editor a través de SSH. ## Telemetría y Privacidad La telemetría de uso registra un UUID de instalación, evento, resultado, duración, plataforma y versión, no código, contenido de escenas ni nombres de proyectos/archivos. Los slugs de directorios de proyectos se codifican antes de la transmisión. Opte por no participar con `GODOT_AI_DISABLE_TELEMETRY=true` o `DISABLE_TELEMETRY=true`. ## Documentación y Ayuda ### Problema de Bazzite / Fedora Atomic Desktop En Bazzite y otros escritorios Fedora Atomic, `/home` normalmente es un enlace simbólico a `/var/home`. Godot AI 4.0.2 y anteriores rechazan cada ruta de directorio de capacidad que pase a través de un enlace. La próxima versión sigue un enlace cuando es propiedad de root y está en un directorio propiedad de root que otras cuentas no pueden escribir. Para 4.0.2 o anterior, establezca `GODOT_AI_CAPABILITY_DIR` a una ruta canónica y lance tanto Godot como su cliente MCP desde esa terminal. ### Referencia y Soporte - Herramientas, operaciones y recursos - Escriba y ejecute pruebas para su juego - Detalles de configuración del cliente - Actualización desde v3 y recuperación de migraciones interrumpidas - Registro de cambios - Contribución y configuración de desarrollo - Discord para preguntas y demostraciones; GitHub Issues para informes de errores **Licencia:** MIT