godot-ai

# Godot AI Godot AI connecte des clients MCP comme Claude Code, Claude Desktop, Codex et Hermes Agent à un éditeur Godot en direct. Il fournit 46 outils et plus de 120 opérations qui permettent aux assistants IA de créer des scènes, éditer des nœuds et des scripts, connecter des signaux, et configurer l'interface utilisateur, les matériaux, l'animation, les particules, les caméras et les environnements. ## Démarrage rapide ### Prérequis - Godot 4.7+ (dans la ligne 4.x) pour Godot AI v4 - uv (fournit uvx pour le serveur Python) - Un client MCP ### Installation 1. **Nouveau projet :** Téléchargez une version publiée depuis GitHub Releases et installez le module complémentaire dans `votre-projet/addons/godot_ai/` avec `plugin.cfg` dans ce répertoire. 2. **Installation existante :** Utilisez le bouton Mise à jour dans le dock Godot AI. La version v3 finale signée prend en charge la migration en un clic vers v4. ### Activer le plugin Dans Godot : **Projet → Paramètres du projet → Plugins → Godot AI**. Le plugin démarre le serveur MCP et affiche l'état de connexion dans le dock Godot AI. ### Connecter votre client MCP Dans le dock, appuyez sur **Configurer** à côté de votre client, ou **Tout configurer** pour chaque client détecté. Les clients pris en charge incluent Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor et VS Code. ### Essayez-le Exemples de prompts : - "Affiche-moi la hiérarchie de scène actuelle." - "Crée un Camera3D nommé MainCamera sous /Main." - "Recherche dans le projet les fichiers PackedScene dans ui/." - "Exécute la suite de tests de la scène." - "Construis un jeu de monde en blocs voxel avec un joueur, des blocs à placer et à détruire, et des emplacements de sauvegarde." ## Comment ça fonctionne text Client MCP → godot-ai attach (stdio) → Serveur Python (HTTP authentifié, port 8000) → Plugin éditeur Godot (WebSocket authentifié, port 9500) Les deux sauts locaux utilisent des capacités rotatives indépendantes ; aucun ne retombe sur un accès non authentifié. Le WebSocket de l'éditeur reste en boucle locale uniquement. Pour les agents dans des conteneurs ou sur d'autres machines, exécutez le pont sur la machine de l'éditeur via SSH. ## Télémétrie et confidentialité La télémétrie d'utilisation enregistre un UUID d'installation, un événement, un résultat, une durée, une plateforme et une version—pas le code, le contenu des scènes, ni les noms de projets ou de fichiers. Les slugs de répertoires de projet sont hachés avant transmission. Désactivez avec `GODOT_AI_DISABLE_TELEMETRY=true` ou `DISABLE_TELEMETRY=true`. ## Documentation et aide ### Problème Bazzite / Fedora Atomic Desktop Sur Bazzite et d'autres bureaux Fedora Atomic, `/home` est normalement un lien symbolique vers `/var/home`. Godot AI 4.0.2 et antérieurs refusent tout chemin de répertoire de capacités qui passe par un lien. La prochaine version suit un lien lorsqu'il appartient à root et se trouve dans un répertoire appartenant à root que d'autres comptes ne peuvent pas écrire. Pour 4.0.2 ou antérieur, définissez `GODOT_AI_CAPABILITY_DIR` sur un chemin canonique et lancez à la fois Godot et votre client MCP depuis ce terminal. ### Référence et support - Outils, opérations et ressources - Écrire et exécuter des tests pour votre jeu - Détails de configuration du client - Mise à niveau depuis v3 et récupération des migrations interrompues - Journal des modifications - Contribution et configuration de développement - Discord pour les questions et démonstrations ; GitHub Issues pour les rapports de bugs **Licence :** MIT