UEFN ne répond pas
Island Pilot passe par le serveur MCP officiel d’Epic Games, qui tourne dans UEFN, sur votre ordinateur. Si la connexion échoue, la cause est le plus souvent un réglage d’UEFN ou une île différente de celle attendue.
Lire l’état de la connexion
Section intitulée « Lire l’état de la connexion »- Cliquez sur l’icône de connexion, en haut de l’application.
- La fenêtre Connexions s’ouvre. Regardez la ligne UEFN officiel.
- Après une correction, utilisez le bouton d’actualisation de cette fenêtre.
Quand tout va bien, la ligne indique UEFN connecté · projet vérifié. Le bouton Compiler Verse n’est utilisable qu’à ce moment-là, et quand aucun agent ne travaille.
Vérifier dans l’ordre
Section intitulée « Vérifier dans l’ordre »- La bonne île. UEFN est ouvert sur la même île que le projet choisi dans Island Pilot.
- Les deux options du projet. Dans les Project Settings d’UEFN, Python Editor Scripting et UEFN MCP Toolsets sont activés.
- Le serveur MCP. Dans Edit › Editor Preferences › Agentic Workflows › Model Context Protocol, le serveur est démarré (bouton Start Server depuis UEFN 43.00), avec son démarrage automatique.
- Le redémarrage. Après un changement de réglage, enregistrez votre travail et redémarrez UEFN.
- La connexion automatique. Dans Paramètres › Général, section Connexion à UEFN, Connexion automatique est activée.
- Le port. L’adresse par défaut est
http://127.0.0.1:8000/mcp. Si vous avez changé le port dans UEFN, adaptez l’adresse dans Store & connexions, puis redémarrez UEFN. - Le lancement. Island Pilot est lancé depuis le menu Démarrer, et non depuis une autre application. Sinon, il ne peut pas écrire les réglages d’UEFN à leur emplacement réel. Paramètres › Diagnostic le signale à la ligne Lancement.
La première configuration est détaillée dans Connecter UEFN.
Les messages
Section intitulée « Les messages »| Message | Ce qu’il veut dire | Ce qu’il faut faire |
|---|---|---|
| Connexion automatique désactivée. ou Désactivé | La connexion est coupée pour ce projet | Activez Connexion automatique |
| Handshake MCP HTTP impossible. Vérifiez l’URL, l’éditeur et l’authentification. | Island Pilot n’atteint pas le serveur : UEFN est fermé, le serveur n’est pas démarré ou le port diffère | Suivez les étapes ci-dessus |
| Connexion MCP expirée après 30 secondes. | UEFN n’a pas répondu à temps | Vérifiez qu’il n’est pas bloqué ou occupé, puis actualisez |
| Le toolset Verse n’est pas disponible dans cet éditeur. | Les outils de l’éditeur ne sont pas chargés | Vérifiez UEFN MCP Toolsets, puis redémarrez UEFN |
| UEFN connecté · identité du projet à configurer | Le lien fonctionne, mais le projet n’est pas confirmé | Ouvrez la même île dans UEFN et sélectionnez son dossier dans Island Pilot |
| Le projet ouvert dans UEFN ne correspond pas au chemin Verse de ce workspace. Action bloquée. | Une autre île est ouverte dans UEFN | Ouvrez la bonne île, ou changez de projet dans Island Pilot |
| L’identité de l’éditeur ne correspond pas au projet attendu. Action bloquée. | Même cause | Même solution |
| Un outil utilise actuellement l’éditeur. | Un agent s’en sert | Attendez la fin de son étape |
| Réglages d’UEFN introuvables sur ce PC : ouvrez UEFN une fois, puis réessayez. | UEFN n’a jamais été lancé sur ce PC | Lancez-le une fois, puis réessayez |
Island Pilot bloque volontairement toute modification tant que le projet ouvert ne correspond pas : cela évite de modifier la mauvaise île.
UEFN est occupé
Section intitulée « UEFN est occupé »Un import, la compilation des shaders, une compilation Verse ou le lancement d’une session de jeu peuvent rendre UEFN muet un moment. Island Pilot réessaie de lui-même.
Si le message dit UEFN ne répond toujours pas, regardez si une fenêtre ou une boîte de dialogue attend votre réponse dans UEFN.
Une action reste au résultat inconnu
Section intitulée « Une action reste au résultat inconnu »Si UEFN coupe pendant une action, Island Pilot ne sait pas si elle a abouti. Il affiche par exemple Appel MCP interrompu ou expiré. Résultat inconnu : inspectez l’état avant de réessayer. et bloque les nouvelles modifications.
- Regardez dans UEFN ce qui a réellement changé.
- Dans Activité, sur l’action concernée, cliquez sur Consigner une inspection.
- Décrivez ce que vous avez constaté dans Résultat de votre inspection, puis cliquez sur Enregistrer mon constat.
Vous pouvez aussi demander à un agent de relire l’état réel et de consigner ce constat. Ne relancez pas l’action à l’aveugle : elle s’appliquerait peut-être deux fois.
Toujours bloqué
Section intitulée « Toujours bloqué »Lancez Paramètres › Diagnostic, puis écrivez-nous avec le résultat. Voir Journaux et diagnostic.