Skip to content

Releases

Enginewright v0.4.0

Choose a tag to compare

@shanyup shanyup released this 10 Nov 12:55

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

  1. Close the editor. Delete an older Plugins/Enginewright folder, then unzip into your project's Plugins/ folder, so you get <YourProject>/Plugins/Enginewright/Enginewright.uplugin.
  2. Optional, only if the project uses MVVM (Epic's UMG Viewmodel plugin): unzip EnginewrightMVVM-0.4.0-UE5.8-Win64.zip into Plugins/ too, so Plugins/EnginewrightMVVM sits next to Plugins/Enginewright, then enable EnginewrightMVVM in Edit > Plugins and restart. Skip it otherwise: Enginewright works without it.
  3. Open the project. The status bar (bottom right) shows Enginewright :3100 with a green dot.
  4. 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/.
  5. Ask your agent to call doctor.

Your token and port stay the same after an update.

Highlights

  • Localization loop: loc_gather gathers, compiles and checks a target while the editor is open; stringtable_compare reads .po and .locres files; game_run takes a culture; font_coverage and glyphMisses find characters that would show as empty boxes.
  • Game testing tools: ui_key, pie_walk_to and pie_travel drive a running game; ui_state shows only what the player can use; ui_prompts with input_map_list compares the on-screen hints with the real bindings.
  • Game runs and images: game_run takes shotNames, cvars and variants; image_stats reports brightness, histogram and difference for each screenshot.
  • Scene tools: scene_dress places hundreds of meshes in one undo step; actor_preview photographs 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_compare reads a .po, .locres or 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_status gather, 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_run culture: the game process gets the language, not only the editor.
  • font_coverage lists the characters of a language or text that a Font asset or a .ttf / .otf cannot draw. game_run glyphMisses counts the characters Slate could not draw in the running game.

Running and checking the game

  • game_run shotNames: the run ends with PASSED / SHOTS_DONE when each named screenshot is written, and SHOTS_MISSING when the game ends without one.
  • game_run cvars: console variables are sent as -ExecCmds, and unknown names are refused.
  • game_run variants: 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, with reference, 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 optional focus that 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 reports STUCK / TIMEOUT with 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_state lists only what the player can use (visible, top page of its stack, page activated) and counts the rest. includeHidden shows the rest with layer, top and hiddenReason. Buttons carry text, tooltip and label, and ui_click finds a button by any of them.
  • input_map_list lists the bound keys per action and device, from an asset or live from the player.
  • ui_prompts compares the hints on screen (CommonUI action widgets and key-like texts) with those bindings and answers OK / MISMATCH / PROMPT_NOT_SHOWN / ACTION_NOT_BOUND per check entry.

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_unbind and viewmodel_remove edit 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 EnginewrightMVVM plugin. Enginewright loads without it, never enables it, and the tools answer MVVM_NOT_ENABLED until 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_state lists only visible widgets on the top page of their stack; includeHidden adds the rest.
  • ui_click ignores closed and covered pages, and AMBIGUOUS names page and layer of each candidate.
  • asset_delete says why an asset cannot be deleted, per asset, and the tool text explains force.
  • mesh_info returns local bounds, size and the pivot offsets without spawning an actor.
  • blueprint_set_component_defaults writes defaults of a component inherited from a C++ parent or an SCS component.
  • asset_import takes scale, rotation, translation and meshType for static and skeletal meshes.
  • Every tool argument has a type and a description.

Fixes

  • game_run shotsFound counted 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's Name field.
  • level_save with path: the map is written inside Content/ and registered with the asset registry at once; .umap files are found by asset_exists and asset_delete.
  • asset_delete: a set of assets that only use each other is deleted referencer first, and String Tables no longer need force.
  • 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 in Saved/Screenshots are moved into the run folder, not copied.
  • game_run: a /Game map in url that does not exist answers MAP_NOT_FOUND with the closest maps, also in dryRun.
  • game_run: the dryRun heavy-level warning matches what happens (viewports pause by default).
  • stringtable_compare: a CSV source uses its file name as the namespace when the .po has 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_audit and id_audit answer ok: false on findings, that automation_list matches anywhere in the name, that a stopped game_run answers RUN_NOT_PASSED, and that settings_set writes a file in source control.
  • tests/smoke.py with 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; build suite 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_find returns 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_gather writes 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...
Read more

Enginewright v0.3.1

Choose a tag to compare

@shanyup shanyup released this 09 Nov 15:34

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

  1. Close the editor. Delete an older Plugins/Enginewright folder, then unzip into your project's Plugins/ folder, so you get <YourProject>/Plugins/Enginewright/Enginewright.uplugin.
  2. Open the project. The status bar (bottom right) shows Enginewright :3100 with a green dot.
  3. 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/.
  4. 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 doctor button.
  • Settings in Project Settings > Plugins > Enginewright, saved per user and project (EditorPerProjectUserSettings.ini). The panel, Project Settings and settings_set change 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; describe shows a tool's category.
  • editor_capture: the main editor window or the Enginewright panel to a PNG.
  • doctor also 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_render also 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 skips NativeOnInitialized, so widget_render runs it once when the widget tree is still empty (nativeInit: false turns this off; the reply says initializedWithoutPlayer).
  • game_run after Live Coding: a new game process loads the C++ modules on disk, not the patch in the editor's memory. game_run now refuses to start after a Live Coding patch (LIVE_CODING_PATCHED; rebuild with editor_restart {"build": true}, or pass allowLiveCodingPatch: true) and warns when C++ source changed after the last build. The live_coding_compile description says the same.
  • game_run with 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_run screenshot runs: shotsExpected: n ends the run when n new PNG files are written, with a PASSED verdict (stopReason: SHOTS_DONE) instead of a timeout. Useful with -ExecCmds=HighResShot in 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 / describe and 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-Id are counted together.
  • editor_restart (close, build, reopen) is Windows-only.
  • APIs may still change before 1.0.

Tests

  • tests/run_all.py + build on a UE 5.8.4 test project: 17 suites, 435 checks, all passed (including a real -game run 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 doctor answered with server version 0.3.1.
  • In a real game project with a C++ UI: widget_render drew a C++ menu page from its class path; game_run ran the game's own UI test at 1920x1080 (PASSED, URL confirmed, 13 screenshots); with a heavy level open in the editor game_run reported it with a hint, and a -ExecCmds=HighResShot 1 run ended after 53 s with shotsExpected: 1 (PASSED, SHOTS_DONE) instead of a timeout. No files were left in the project outside Saved/.

Enginewright v0.3.0

Choose a tag to compare

@shanyup shanyup released this 08 Nov 20:41

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

  1. Close the editor. Unzip into your project's Plugins/ folder, so you get <YourProject>/Plugins/Enginewright/Enginewright.uplugin.
  2. Open the project. The Output Log prints Enginewright: MCP server on http://127.0.0.1:3100/mcp.
  3. Connect your client with the ready-to-paste config in <YourProject>/Saved/Enginewright/clients/ (Claude Code, Codex, Cursor, VS Code, Hermes).
  4. 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, and widget_render (a Widget Blueprint to PNG at any resolution, no Play In Editor needed).
  • Runtime UI with CommonUI support: ui_state lists what a player's screen shows (widgets in the viewport, CommonUI activatable widgets and stacks, visible buttons with label, selected state and rectangle); ui_click clicks by name or label and refuses a button that another widget covers; ui_open / ui_close show 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_run starts the game (this editor in -game mode, 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_status follows or stops a long run.
  • Compare images: image_compose puts 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.py compiles 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. See docs/EWTOOL.md.

Changed

  • asset_rename reports text and IDs that still name the old asset (a redirector cannot fix those); dryRun previews referencers and such text.
  • object_set on a class default also updates placed instances and widget templates that still had the old default.
  • automation_list / automation_run keep the editor at full speed while it is in the background (UE otherwise throttles it and tests time out).
  • screenshot of a running game (Play In Editor) now includes the UI drawn over it (UMG / CommonUI), as the player sees it; ui: false captures 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_click checks covering widgets at the UMG level; it does not press keys or gamepad buttons (use pie_input).
  • game_run starts 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_PORT to 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).