Skip to Content
GameGenUnreal EngineEditor connection

Editor connection

The Unreal agents look at and drive a running Unreal Editor through its Remote Control server. The Editor connection section of the Unreal view tells you whether that server answers. The agents can still build and test without it, but they cannot check a change in the editor.

How it works

  • Unreal Editor’s Remote Control API plugin serves HTTP on the machine. GameGen expects it at http://127.0.0.1:30010.
  • The agents use it to confirm the editor is reachable, read and set properties, list actors, run console commands, run editor Python and read the output log.
  • The editor tools are attached to an agent’s run only if the editor answered when the run started. If it did not, the agent builds and verifies from the command line.

The Floppy Bird tutorial is already set up for this: the Remote Control and Python Editor Script plugins are enabled in its .uproject, and Config/DefaultRemoteControl.ini allows the editor Python call that the agents use.

Connect

Build first

Choose Build in the Unreal view, so the editor loads current binaries.

Open the editor

Choose Open editor. It starts Unreal Editor on this project with Remote Control on and waits until it answers.

Check the row

The Unreal Editor row changes to Connected: “Remote Control answers at … The Unreal agents can inspect and drive this editor.”

Why it says Not connected

What the row saysCauseFix
“No answer at …”No editor is running, or it has no Remote Control server.Choose Open editor.
“An Unreal Editor is running on this machine, but it is not answering at …”The running editor has a different project open, or its Remote Control server is off.Choose Open editor to start one for this project. Or use the running editor: see below.

Use an editor you opened yourself

Open this project

In the running editor, open this project.

Enable the plugin

Enable the Remote Control API plugin.

Start the server

Run this in the editor’s console:

WebControl.StartServer

To have the server start with the editor every time, turn on auto-start for the Remote Control HTTP server on port 30010 in the editor’s Remote Control settings.

Editor Python in your own project

Unreal Engine blocks editor Python over Remote Control unless the project allows it. Projects that New game creates include the file below. A project you bring yourself needs both of these lines in Config/DefaultRemoteControl.ini:

Config/DefaultRemoteControl.ini
[/Script/RemoteControlCommon.RemoteControlSettings] bEnableRemotePythonExecution=True +CustomAllowedRemoteFunctionCalls=(ClassPath="/Script/PythonScriptPlugin.PythonScriptLibrary",FunctionName="ExecutePythonCommandEx",bAllowChildClasses=False)

It also needs the Remote Control API and Python Editor Script plugins enabled.

Use another address

GameGen’s background process reads the address from the AGENTLOOP_UNREAL_RC_URL variable when it is set. Use it for a different port or a forwarded local port.

Limits

  • One port means one connected editor per machine at a time.
  • The Remote Control server does not start in an editor run without rendering.

Next steps

Last updated on