Connecter UEFN
Island Pilot travaille avec UEFN, l’éditeur d’Epic Games, par son serveur MCP : un service intégré à l’éditeur, qui tourne sur votre ordinateur et permet à un programme de lire et de modifier le projet ouvert. Island Pilot n’est pas affilié à Epic Games.
Avant de commencer
Section intitulée « Avant de commencer »- UEFN installé et lancé au moins une fois sur ce PC.
- Un projet Island Pilot créé sur le dossier de votre île.
Ce qu’Island Pilot fait pour vous
Section intitulée « Ce qu’Island Pilot fait pour vous »- Il ajoute à chaque nouveau projet une connexion UEFN officiel, activée, à l’adresse
http://127.0.0.1:8000/mcp. - Il active le démarrage automatique du serveur dans les réglages d’UEFN : à l’étape UEFN du premier lancement, avec J’accepte et je configure UEFN, puis à chaque ouverture tant que Connexion automatique reste activée dans Paramètres › Général. La première fois, une copie de vos réglages est gardée à côté du fichier d’origine (
Editor.ini.pilot-backup). - Il contrôle la connexion et l’île ouverte toutes les 30 secondes, sauf pendant le travail d’un agent.
Il ne lance pas UEFN et ne le redémarre pas.
Ce qu’il reste à faire dans UEFN
Section intitulée « Ce qu’il reste à faire dans UEFN »Ces étapes figurent aussi dans Paramètres › Général, section Connexion à UEFN.
- Ouvrez votre île dans UEFN, puis Project Settings.
- Recherchez et activez Python Editor Scripting, puis UEFN MCP Toolsets. Les deux options sont nécessaires, pour chaque projet.
- Ouvrez Edit › Editor Preferences › Agentic Workflows › Model Context Protocol. Vérifiez que le serveur est démarré (bouton Start Server depuis UEFN 43.00) et que son démarrage automatique est actif. Depuis la 43.00, ce réglage vaut pour tous vos projets.
- Enregistrez votre travail et redémarrez UEFN.
- Rouvrez la même île.
UEFN peut aussi vous demander de faire confiance à un projet qui utilise Python.
Vérifier la connexion
Section intitulée « Vérifier la connexion »- En haut de la fenêtre, cliquez sur l’icône de connexion (infobulle État de Pilot et des serveurs MCP).
- Dans Connexions, lisez la ligne UEFN officiel. Elle doit afficher UEFN connecté · projet vérifié.
- Pour relancer le contrôle, cliquez sur Actualiser la connexion, l’icône en haut de ce panneau.
Pendant qu’un agent travaille, le contrôle est suspendu : l’état affiché est le dernier connu.
La pastille de l’icône est verte si toutes les connexions activées répondent, orange sinon. Blender fermé suffit à la rendre orange : fiez-vous à la ligne UEFN officiel.
| Message | Ce qu’il signifie | Que faire |
|---|---|---|
| UEFN connecté · projet vérifié | L’éditeur répond et l’île ouverte est celle du projet. | Rien. |
| UEFN connecté · identité du projet à configurer | L’éditeur répond, mais l’île ne peut pas être identifiée. Les agents peuvent lire, pas modifier. La compilation est bloquée. | Vérifiez le fichier .uefnproject, ci-dessous. |
| Le projet ouvert dans UEFN ne correspond pas au chemin Verse de ce workspace. Action bloquée. | Une autre île est ouverte, ou un autre UEFN occupe le port. Les modifications sont bloquées ; une lecture porterait sur l’île réellement ouverte. | Ouvrez la bonne île ou fermez l’autre éditeur. |
| Le toolset Verse n’est pas disponible dans cet éditeur. | L’éditeur répond sans ses outils Verse. | Vérifiez UEFN MCP Toolsets, puis redémarrez UEFN. |
| Handshake MCP HTTP impossible. Vérifiez l’URL, l’éditeur et l’authentification. | Rien ne répond à cette adresse. | Ouvrez UEFN, démarrez le serveur, vérifiez le port. |
| UEFN ne répond pas. Vérifiez l’éditeur et son serveur MCP. | Pas de réponse en 15 secondes. L’éditeur est peut-être occupé. | Attendez, puis actualisez. |
Pour lister les outils réellement disponibles, ouvrez Outils UEFN › Connexions, puis la fiche UEFN officiel, et cliquez sur Tester et découvrir.
Le fichier .uefnproject
Section intitulée « Le fichier .uefnproject »UEFN crée ce fichier à la racine du dossier de votre île. Island Pilot y lit le chemin Verse de l’île et le compare à ce que répond l’éditeur, avant et après chaque modification. Ce contrôle évite de modifier une autre île.
- Le Workspace du projet doit être le dossier qui contient directement ce fichier.
- Il doit y en avoir un seul. Sans fichier, ou avec plusieurs, l’identité reste à configurer.
- Island Pilot se contente de le lire. Ne le modifiez pas et ne le déplacez pas.
Si l’île change pendant une action, le résultat est marqué à vérifier : Le projet éditeur a changé pendant l’action. Résultat à vérifier manuellement.
Plusieurs îles ouvertes
Section intitulée « Plusieurs îles ouvertes »Deux éditeurs ne peuvent pas partager un port. Donnez à chacun le sien avec Server Port Number dans les préférences d’UEFN (8000 par défaut), reportez-le dans URL MCP, onglet Configuration de la fiche UEFN officiel, puis redémarrez UEFN.
Ce que vous autorisez
Section intitulée « Ce que vous autorisez »Les agents lisent et modifient le projet ouvert, et en compilent le Verse. Ce qu’ils consultent (fichiers, journaux, captures) part chez le fournisseur d’IA de votre agent. En mode Ask ou Plan et avec les profils en lecture seule, rien n’est modifié. Pour couper la connexion, désactivez Connexion automatique.