Repository navigation
Enginewright v0.3.1
Enginewright v0.3.1
Early preview. Supported: Unreal Engine 5.8, Windows (Win64). Other engine versions, Mac and Linux are not tested yet.
Download
| File | SHA-256 |
|---|---|
Enginewright-0.3.1-UE5.8-Win64.zip |
9f00cfa2e51c275fa6b5f69b6e4c4b18d901e7a5cb181eee4a4cd9fc3b68cc13 |
Check it in PowerShell with Get-FileHash .\Enginewright-0.3.1-UE5.8-Win64.zip (or sha256sum -c Enginewright-0.3.1-UE5.8-Win64.zip.sha256).
Install or update
- Close the editor. Delete an older
Plugins/Enginewrightfolder, then unzip into your project'sPlugins/folder, so you get<YourProject>/Plugins/Enginewright/Enginewright.uplugin. - Open the project. The status bar (bottom right) shows
Enginewright :3100with a green dot. - Click it to open the Enginewright panel and copy the config for your client (Claude Code, Codex, Cursor, VS Code, Hermes). The same files are in
<YourProject>/Saved/Enginewright/clients/. - Ask your agent to call
doctor.
Your token and port stay the same after an update.
New
- Status bar indicator:
Enginewright :3100 (2)at the bottom right. Green while the server listens, red when it is off or the port is in use; the number is the clients seen in the last 5 minutes. The tooltip shows the URL, the token state and the last call. Click it to open the panel. - Enginewright panel (Tools > Enginewright): server on/off and port, the token (show, copy, make a new one), one-click client configs, the clients that talked to this editor, tool categories you can turn off, a read-only mode, the Output Log level, the last 15 calls with their result and time, and a
doctorbutton. - Settings in Project Settings > Plugins > Enginewright, saved per user and project (
EditorPerProjectUserSettings.ini). The panel, Project Settings andsettings_setchange the same values, and changes apply at once.- Read-only mode refuses every tool that changes assets, the level, files or the editor (
READ_ONLY). It is a guard against accidents, not a security boundary. - Turned-off tool categories are refused with
TOOL_DISABLED;describeshows a tool'scategory.
- Read-only mode refuses every tool that changes assets, the level, files or the editor (
editor_capture: the main editor window or the Enginewright panel to a PNG.doctoralso reports the server: version, URL, clients, read-only mode and turned-off categories.
Fixes from a real game project
These came from using v0.3 on a game whose UI is written in C++:
widget_renderalso takes C++ UserWidget classes (/Script/MyGame.MyWidget), not only Widget Blueprints. A widget that builds its tree in code is rendered the same way: without Play In Editor there is no owning player and Unreal skipsNativeOnInitialized, sowidget_renderruns it once when the widget tree is still empty (nativeInit: falseturns this off; the reply saysinitializedWithoutPlayer).game_runafter Live Coding: a new game process loads the C++ modules on disk, not the patch in the editor's memory.game_runnow refuses to start after a Live Coding patch (LIVE_CODING_PATCHED; rebuild witheditor_restart {"build": true}, or passallowLiveCodingPatch: true) and warns when C++ source changed after the last build. Thelive_coding_compiledescription says the same.game_runwith a heavy editor level: the editor's realtime level viewports are paused while the game runs and restored after (editorViewports: "keep"to leave them), and a heavy level (Lumen, real-time sky light, volumetric clouds, many actors) is reported with a hint.game_runscreenshot runs:shotsExpected: nends the run when n new PNG files are written, with aPASSEDverdict (stopReason: SHOTS_DONE) instead of a timeout. Useful with-ExecCmds=HighResShotin games that do not quit by themselves.
For contributors
- Issue forms for tool requests and bug reports, a pull request template, CONTRIBUTING.md, and REQUEST_WITH_AI.md: a prompt for your own AI agent that checks the existing tools with
search/describeand fills in a tool request. - Open issues labelled good first issue, each with the files to touch, the test to extend and when it is done.
Known issues and limits
- Tested on UE 5.8 Win64 only. The prebuilt zip contains Win64 binaries only.
- Turning the server off unbinds
/mcp; the port itself stays open until the editor closes (Unreal's HTTP server has no per-port stop). - A client is counted by its MCP session; clients that do not send
Mcp-Session-Idare counted together. editor_restart(close, build, reopen) is Windows-only.- APIs may still change before 1.0.
Tests
tests/run_all.py+buildon a UE 5.8.4 test project: 17 suites, 435 checks, all passed (including a real-gamerun and an editor restart with a build).- Clean install: the prebuilt zip unzipped into a blank UE 5.8 project; the editor opened without compiling, the status bar indicator was green and
doctoranswered with server version 0.3.1. - In a real game project with a C++ UI:
widget_renderdrew a C++ menu page from its class path;game_runran the game's own UI test at 1920x1080 (PASSED, URL confirmed, 13 screenshots); with a heavy level open in the editorgame_runreported it with a hint, and a-ExecCmds=HighResShot 1run ended after 53 s withshotsExpected: 1(PASSED,SHOTS_DONE) instead of a timeout. No files were left in the project outsideSaved/.