Connect UEFN
Island Pilot works with UEFN, the Epic Games editor, through its MCP server: a service built into the editor that runs on your computer and lets a program read and change the open project. Island Pilot is not affiliated with Epic Games.
Before you start
Section titled “Before you start”- UEFN installed and launched at least once on this PC.
- An Island Pilot project created on your island’s folder.
What Island Pilot does for you
Section titled “What Island Pilot does for you”- It adds a UEFN officiel (Official UEFN) connection, turned on, to every new project, at
http://127.0.0.1:8000/mcp. - It turns on the server’s automatic start in UEFN’s settings: at the UEFN step of the first launch, with J’accepte et je configure UEFN (I accept and configure UEFN), then every time it opens, for as long as Connexion automatique (Automatic connection) stays on in Paramètres › Général (Settings › General). The first time, a copy of your settings is kept next to the original file (
Editor.ini.pilot-backup). - It checks the connection and the open island every 30 seconds, except while an agent is working.
It does not launch UEFN and does not restart it.
What is left to do in UEFN
Section titled “What is left to do in UEFN”These steps also appear in Paramètres › Général, in the Connexion à UEFN (Connection to UEFN) section.
- Open your island in UEFN, then Project Settings.
- Search for and turn on Python Editor Scripting, then UEFN MCP Toolsets. Both options are required, for every project.
- Open Edit › Editor Preferences › Agentic Workflows › Model Context Protocol. Check that the server is started (Start Server button since UEFN 43.00) and that its automatic start is on. Since 43.00, this setting applies to all your projects.
- Save your work and restart UEFN.
- Reopen the same island.
UEFN may also ask you to trust a project that uses Python.
Check the connection
Section titled “Check the connection”- At the top of the window, click the connection icon (tooltip État de Pilot et des serveurs MCP (Pilot and MCP servers status)).
- In Connexions (Connections), read the UEFN officiel line. It should show UEFN connecté · projet vérifié (UEFN connected · project verified).
- To run the check again, click Actualiser la connexion (Refresh connection), the icon at the top of that panel.
While an agent is working, the check is paused: the status shown is the last known one.
The icon’s dot is green if all the connections that are turned on respond, and orange otherwise. A closed Blender is enough to turn it orange: rely on the UEFN officiel line.
| Message | What it means | What to do |
|---|---|---|
| UEFN connecté · projet vérifié (UEFN connected · project verified) | The editor responds and the open island is the project’s island. | Nothing. |
| UEFN connecté · identité du projet à configurer (UEFN connected · project identity to be configured) | The editor responds, but the island cannot be identified. Agents can read, not edit. Compiling is blocked. | Check the .uefnproject file, below. |
| Le projet ouvert dans UEFN ne correspond pas au chemin Verse de ce workspace. Action bloquée. (The project open in UEFN does not match the Verse path of this workspace. Action blocked.) | Another island is open, or another UEFN is using the port. Changes are blocked; a read would apply to the island that is actually open. | Open the right island or close the other editor. |
| Le toolset Verse n’est pas disponible dans cet éditeur. (The Verse toolset is not available in this editor.) | The editor responds without its Verse tools. | Check UEFN MCP Toolsets, then restart UEFN. |
| Handshake MCP HTTP impossible. Vérifiez l’URL, l’éditeur et l’authentification. (MCP HTTP handshake impossible. Check the URL, the editor and authentication.) | Nothing responds at this address. | Open UEFN, start the server, check the port. |
| UEFN ne répond pas. Vérifiez l’éditeur et son serveur MCP. (UEFN does not respond. Check the editor and its MCP server.) | No response within 15 seconds. The editor may be busy. | Wait, then refresh. |
To list the tools that are really available, open Outils UEFN › Connexions (UEFN tools › Connections), then the UEFN officiel details page, and click Tester et découvrir (Test and discover).
The .uefnproject file
Section titled “The .uefnproject file”UEFN creates this file at the root of your island’s folder. Island Pilot reads the island’s Verse path from it and compares it with what the editor reports, before and after each change. This check stops it from changing another island.
- The project’s Workspace must be the folder that directly contains this file.
- There must be only one. With no file, or with several, the identity remains to be configured.
- Island Pilot only reads it. Do not edit it and do not move it.
If the island changes during an action, the result is marked as needing a check: Le projet éditeur a changé pendant l’action. Résultat à vérifier manuellement. (The editor project changed during the action. Result to be checked manually.)
Several islands open
Section titled “Several islands open”Two editors cannot share a port. Give each its own with Server Port Number in UEFN’s preferences (8000 by default), enter it in URL MCP, Configuration tab of the UEFN officiel details page, then restart UEFN.
What you allow
Section titled “What you allow”Agents read and change the open project, and compile its Verse. What they look at (files, logs, screenshots) goes to your agent’s AI provider. In Ask or Plan mode, and with read-only profiles, nothing is changed. To cut the connection, turn off Connexion automatique.