Repository navigation
Releases
Enginewright v0.4.0
Enginewright v0.4.0
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.4.0-UE5.8-Win64.zip |
d1359462ae21d94c30e8894cf09e07216534d213a345ae4cbe2190e095b23dfb |
EnginewrightMVVM-0.4.0-UE5.8-Win64.zip (optional, MVVM tools) |
285b50d6889e99f296cb1aeacd9321da8fa841f360d930cbaf5aa2ce78e065df |
Check a file in PowerShell with Get-FileHash .\Enginewright-0.4.0-UE5.8-Win64.zip (or sha256sum -c Enginewright-0.4.0-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. - Optional, only if the project uses MVVM (Epic's UMG Viewmodel plugin): unzip
EnginewrightMVVM-0.4.0-UE5.8-Win64.zipintoPlugins/too, soPlugins/EnginewrightMVVMsits next toPlugins/Enginewright, then enableEnginewrightMVVMin Edit > Plugins and restart. Skip it otherwise: Enginewright works without it. - 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.
Highlights
- Localization loop:
loc_gathergathers, compiles and checks a target while the editor is open;stringtable_comparereads.poand.locresfiles;game_runtakes aculture;font_coverageandglyphMissesfind characters that would show as empty boxes. - Game testing tools:
ui_key,pie_walk_toandpie_traveldrive a running game;ui_stateshows only what the player can use;ui_promptswithinput_map_listcompares the on-screen hints with the real bindings. - Game runs and images:
game_runtakesshotNames,cvarsandvariants;image_statsreports brightness, histogram and difference for each screenshot. - Scene tools:
scene_dressplaces hundreds of meshes in one undo step;actor_previewphotographs an actor class without Play In Editor. - MVVM: the
viewmodel_*tools edit view models and bindings in an optional plugin. - Reliability sweep: every tool was run on a real game project (RagnaCook) with 11 fixes.
New
Localization
stringtable_comparereads a.po,.locresor CSV translation next to a String Table or CSV source. It reports translations made for an older source text and fuzzy entries.loc_gather/loc_gather_statusgather, export, import, compile and check a localization target in one call. The commandlet works while the editor is open, and the verdict uses both exit codes.game_runculture: the game process gets the language, not only the editor.font_coveragelists the characters of a language or text that a Font asset or a.ttf/.otfcannot draw.game_runglyphMissescounts the characters Slate could not draw in the running game.
Running and checking the game
game_runshotNames: the run ends withPASSED/SHOTS_DONEwhen each named screenshot is written, andSHOTS_MISSINGwhen the game ends without one.game_runcvars: console variables are sent as-ExecCmds, and unknown names are refused.game_runvariants: the same run once per look, each screenshot with its stats and the diff to the first variant.image_stats: mean luma, luma histogram (16 bins), saturation, clipped black / white and, withreference, the brightness difference, mean absolute pixel difference, changed pixels and SSIM.
Play In Editor and UI testing
ui_key: a key or mouse button through Slate to the focused widget (for "press any key" panels), with an optionalfocusthat moves user focus first.pie_walk_to: walks the pawn to a position with movement input, using a navmesh path when there is one, and reportsSTUCK/TIMEOUTwith the last position.pie_travel: travels a running session to another map with URL options (?game=...?listen), checks the map and the options, and waits for the new map and the pawns.ui_statelists only what the player can use (visible, top page of its stack, page activated) and counts the rest.includeHiddenshows the rest withlayer,topandhiddenReason. Buttons carrytext,tooltipandlabel, andui_clickfinds a button by any of them.input_map_listlists the bound keys per action and device, from an asset or live from the player.ui_promptscompares the hints on screen (CommonUI action widgets and key-like texts) with those bindings and answers OK / MISMATCH / PROMPT_NOT_SHOWN / ACTION_NOT_BOUND percheckentry.
Save games
savegame_get/savegame_set: read and write a SaveGame slot by reflection. A slot with a game footer or checksum needs the game's own save function (saveFunction).
Scene tools
scene_dress: ring, ellipse, line, grid or scatter of meshes around an actor or point, in one undo step, with seed, rotation and scale jitter, ground snap, overlap and avoid checks, instanced or separate actors, and DataTable export.actor_preview: builds an actor class like the game does (construction, BeginPlay, a few ticks) in an isolated preview world or temporarily in the open level, photographs it, and cleans up. No Play In Editor.
MVVM
viewmodel_list,viewmodel_add,viewmodel_bind,viewmodel_unbindandviewmodel_removeedit view models and view bindings of a Widget Blueprint, with conversion functions, one undo step, compile and read-back.- The tools live in the optional
EnginewrightMVVMplugin. Enginewright loads without it, never enables it, and the tools answerMVVM_NOT_ENABLEDuntil both plugins are on.
Editor panel
- The Enginewright panel shows its version label, a "What's new / Roadmap" button and a "Changelog" button (both open GitHub).
Docs
docs/SUPPORT.md,CHANGELOG.md, and the roadmap and request flow.
Changed
ui_statelists only visible widgets on the top page of their stack;includeHiddenadds the rest.ui_clickignores closed and covered pages, andAMBIGUOUSnames page and layer of each candidate.asset_deletesays why an asset cannot be deleted, per asset, and the tool text explainsforce.mesh_inforeturns local bounds, size and the pivot offsets without spawning an actor.blueprint_set_component_defaultswrites defaults of a component inherited from a C++ parent or an SCS component.asset_importtakesscale,rotation,translationandmeshTypefor static and skeletal meshes.- Every tool argument has a type and a description.
Fixes
game_runshotsFoundcounted a screenshot copied from another folder twice (ER-09). It now counts each PNG once.datatable_set_rows: rows are checked on copies first, so a failed call no longer overwrites every row'sNamefield.level_savewithpath: the map is written insideContent/and registered with the asset registry at once;.umapfiles are found byasset_existsandasset_delete.asset_delete: a set of assets that only use each other is deleted referencer first, and String Tables no longer needforce.gameplay_tag_add/gameplay_tag_remove: a tag ini created in the session is removed again with its last tag, and dropped from the editor's config cache.game_run: screenshots inSaved/Screenshotsare moved into the run folder, not copied.game_run: a/Gamemap inurlthat does not exist answersMAP_NOT_FOUNDwith the closest maps, also indryRun.game_run: thedryRunheavy-level warning matches what happens (viewports pause by default).stringtable_compare: a CSV source uses its file name as the namespace when the.pohas that namespace, and a mostly-missing result warns.- Every argument has a type and a description (80 had no description, 8 had no type).
- Descriptions now say that
key_auditandid_auditanswerok: falseon findings, thatautomation_listmatches anywhere in the name, that a stoppedgame_runanswersRUN_NOT_PASSED, and thatsettings_setwrites a file in source control. tests/smoke.pywith no editor prints one line instead of a urllib traceback.
Tested
tests/run_all.py: 19 suites, 856 checks, all passed on UE 5.8 Win64;buildsuite 15/15 (editor closed, compile, reopen).- Every tool was called on RagnaCook, a UE 5.8 co-op game in development (330 calls): RELIABILITY_0.4.md.
Known issues
- Tested on UE 5.8 Win64 only.
asset_findreturns an empty list without a warning for a folder that does not exist (planned for 0.4.1).- There is no warning for asset names with non-ASCII letters (planned for 0.4.1).
loc_gatherwrites the project's localization files. Run it on a clean working tree.- The art import pipeline is not in this release (0.4.1).
Tools
The client sees three meta tools: search (find a tool in plain words), describe (read its arguments) and call (run it). Behind them:
| Area | Tools |
|---|---|
| Objects | object_get, object_set |
| Assets | asset_find, asset_exists, asset_references, asset_duplicate, asset_rename (updates referencers, removes the redirector, reports text and IDs that still name the old asset; dryRun to preview), asset_delete (refuses assets still in use; says why per asset: which asset references it, open editor, unsaved changes; force explained in the tool text), asset_save, asset_import (texture, sound, font, mesh, while the editor is open; meshes take scale, rotation, translation, meshType) |
| Types and data | enum_create, struct_create, type_info, datatable_create, datatable_get, datatable_set_rows, datatable_remove_rows, datatable_rename_row |
| Blueprint... |
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/.
Enginewright v0.3.0
Enginewright v0.3.0
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.0-UE5.8-Win64.zip |
95e008efc80bb5dea28de45fc9e9003eb6a5d816fc274cc14bd7c6c7912333d4 |
Check it in PowerShell with Get-FileHash .\Enginewright-0.3.0-UE5.8-Win64.zip (or sha256sum -c Enginewright-0.3.0-UE5.8-Win64.zip.sha256).
Install
- Close the editor. Unzip into your project's
Plugins/folder, so you get<YourProject>/Plugins/Enginewright/Enginewright.uplugin. - Open the project. The Output Log prints
Enginewright: MCP server on http://127.0.0.1:3100/mcp. - Connect your client with the ready-to-paste config in
<YourProject>/Saved/Enginewright/clients/(Claude Code, Codex, Cursor, VS Code, Hermes). - Ask your agent to call
doctor.
Works in Blueprint-only and C++ projects. No Python, Node or other runtime is needed.
New since v0.2
- UMG:
widget_create,widget_tree,widget_get,widget_add(widget, properties and slot layout in one checked call),widget_set,widget_remove, andwidget_render(a Widget Blueprint to PNG at any resolution, no Play In Editor needed). - Runtime UI with CommonUI support:
ui_statelists what a player's screen shows (widgets in the viewport, CommonUI activatable widgets and stacks, visible buttons with label, selected state and rectangle);ui_clickclicks by name or label and refuses a button that another widget covers;ui_open/ui_closeshow one screen in Play In Editor, or push it onto a running CommonUI stack. CommonUI is used through reflection, so projects without it work too. - CommonUI input:
ui_input_audit(missing action rows, Enhanced Input actions that never fire, duplicate actions, no input data asset),ui_input_type(switch a player to gamepad / mouse and keyboard / touch). - Localization:
stringtable_list,stringtable_get,stringtable_set(String Table assets, read back),stringtable_compare(missing, extra, empty, untranslated, format argument differences),loc_culture(preview another language). - Run the game:
game_runstarts the game (this editor in-gamemode, or a packaged exe) with a map URL, once per resolution. The URL is passed unchanged and checked against the game's own log; the run is stopped early when it does not match, or when a required test-mode line never appears. The reply gives a verdict from log patterns (PASSED / FAILED / CRASHED / TIMEOUT / …), only the log lines you asked for, and the new PNG files with their real size.game_run_statusfollows or stops a long run. - Compare images:
image_composeputs PNG files side by side in one labelled PNG (title, column and row labels), then reads the file back and compares every cell. - Gameplay Tags:
gameplay_tags_list,gameplay_tag_add(strict names, read back),gameplay_tag_remove(refused while assets use the tag). - Multiplayer tests on one machine:
pie_actors(what the server and each client see: count, net roles, owner, property values; waits for replication),pie_net_emulation(lag, loss, duplicates, reordering; profiles off / average / bad). - Measuring:
class_measure(size of a class or Blueprint without placing it),screen_coverage(how big an actor looks from a player's camera). - Optional build helper:
Plugins/Enginewright/Scripts/ewtool.pycompiles the project while the editor is closed (waits for locked DLLs and names the process that holds them; UnrealBuildTool runs detached, so it keeps going when the caller is killed). Python 3, standard library only. You do not need it to use the plugin. Seedocs/EWTOOL.md.
Changed
asset_renamereports text and IDs that still name the old asset (a redirector cannot fix those);dryRunpreviews referencers and such text.object_seton a class default also updates placed instances and widget templates that still had the old default.automation_list/automation_runkeep the editor at full speed while it is in the background (UE otherwise throttles it and tests time out).screenshotof a running game (Play In Editor) now includes the UI drawn over it (UMG / CommonUI), as the player sees it;ui: falsecaptures the scene only.- Every tool argument has a description in
describe(checked by a test).
Fixes
- The plugin builds in projects that use unity builds (helper names no longer clash).
- Adding and removing widgets keeps the Widget Blueprint's variable list consistent (no compiler ensure).
Known issues and limits
- Tested on UE 5.8 Win64 only. The prebuilt zip contains Win64 binaries only.
ui_clickchecks covering widgets at the UMG level; it does not press keys or gamepad buttons (usepie_input).game_runstarts a new game process per resolution and stops it when the run is over; it does not attach to a game that is already running.editor_restart(close, build, reopen) is Windows-only.- One editor per port (default 3100). Set
ENGINEWRIGHT_PORTto run several editors. - APIs may still change before 1.0.
Tests
tests/run_all.py on a blank UE 5.8 test project (with CommonUI enabled): 16 suites, 389 checks, all passed. This includes one real -game run (ENGINEWRIGHT_TEST_GAME=1) and the build suite (Live Coding, automation tests, full C++ rebuild).