Documentation
Unreal live link
Tessera can push any node straight into the open Unreal Editor and keep it in sync while you edit. It uses Unreal’s own Python remote execution on your PC: nothing is installed into your project, and no plugin from Tessera is needed.
Set up Unreal (once per project)
- In Unreal Engine 5, open your project.
- Edit > Plugins: enable Python Editor Script Plugin (restart the editor if asked).
- Edit > Project Settings > Plugins > Python: tick Enable Remote Execution. Leave the multicast settings at their defaults (group 239.0.0.1:6766, bind address 127.0.0.1).
- Keep the project open. In Tessera, click Unreal in the top bar: the panel lists the editors it found (project name and engine version). Press Refresh if you just started Unreal.
Windows Firewall may ask about network access the first time; discovery only uses multicast on this PC (localhost, TTL 0).
Send to Unreal
- Open the Unreal panel. Node is the node to send (empty = the display node of the current graph). Asset name is optional (default: the node name).
- Click Send to Unreal.
Tessera exports the node as one mesh with vertex colours and UVs, imports it into your project and places an actor in front of the editor camera the first time. Sending again re-imports over the same asset and updates the actor in place; every placed instance of that mesh updates. The panel shows the last result and how long it took.
Live link
Tick Live link and every change to the graph (yours or the AI’s) is re-sent to Unreal automatically, debounced by about a second so a slider drag doesn’t flood the editor. Tune a seed or a roof height in Tessera and watch it update in your level. Linked assets are listed in the panel. Untick to stop.
What gets created in Unreal
| Item | Where |
|---|---|
| Static mesh | /Game/Tessera/<asset>, imported from a GLB with vertex colours and UVs |
| Material | /Game/Tessera/M_Tessera_VertexColor: base colour from vertex colour, created once and shared |
| Actor | Labelled Tessera_<asset> in the level’s Tessera outliner folder, placed in front of the editor camera on first send |
| Source file | %USERPROFILE%\Tessera\unreal\<asset>.glb on your PC |
Asset names are made Unreal-safe (letters, digits and underscores). Move the actor freely in Unreal; re-sends swap the mesh and keep your placement.
For final assets you can also export a GLB and import it with Unreal’s own importer.
Project pinning
The link is bound to one Unreal project and never pushes into a different one:
- On first use with a single editor open, the link binds to that project.
- If that editor restarts, the link finds the same project again automatically.
- If another project is open instead, Tessera refuses to send and tells you the linked project is not open. To switch, pick the other editor in the Unreal panel.
- Each linked asset also remembers which Tessera project it came from, so live updates from one tab never overwrite assets of another.
From the AI and scripts
Ask the AI: “send it to Unreal with live link”. Claude Code uses the MCP tool send_to_unreal (path, asset, live). Over HTTP:
# status and detected editors
Invoke-RestMethod http://127.0.0.1:7419/api/unreal/status
# send the node OUT_village as asset Village
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:7419/api/unreal/send -ContentType 'application/json' -Body '{"path":"main/OUT_village","asset":"Village"}'
# live link on
Invoke-RestMethod -Method Post -Uri http://127.0.0.1:7419/api/unreal/live -ContentType 'application/json' -Body '{"live":true,"path":"main/OUT_village","asset":"Village"}'Terrain: use heightmaps
The live link sends static meshes. For landscapes, export a 16-bit heightmap with hf_export and import it with Unreal’s Landscape tool: see Terrain & Unreal heightmaps.
Troubleshooting
- “No Unreal editor found”
- Check the plugin and Enable Remote Execution, restart the editor, keep the project open and press Refresh. Check that the firewall did not block Unreal.
- “The linked project is not open”
- The link is pinned to another project. Open that one, or pick the current editor in the Unreal panel to re-bind.
- “Unreal did not open a command connection”
- Unreal saw Tessera but did not connect back: usually the remote execution settings were changed from their defaults, or a firewall blocks local connections.
- Very heavy meshes are slow
- Sculpted villages can be millions of triangles. Send a lighter version (turn off
sculpted, usepolyreduce) while iterating; turn live link off for heavy edits.