unreal-engine-mcp-server 0.6.0-beta-e → 0.6.0

package/CHANGELOG.md

@@ -13,6 +13,191 @@ _Nothing yet._
 
 ---
 
+## 🏷️ [0.6.0] - 2026-10-27
+
+> [!NOTE]
+> **Stable.** The 0.6 line's stable release, published under the npm `latest` dist-tag. This section is everything since the `v0.6.0-beta-f` tag, written from the code diff.
+
+<details>
+<summary><b>✨ Added</b></summary>
+
+- **Blueprint runtime errors name their node** and an Accessed None its `cause`; **`lint_blueprint`** finds such mistakes before Play, and Validate Assets and saves report them too; **logpoints** record a node's pin values each time it runs in Play, without pausing; **`read_graph_as_code`** and **`write_graph_from_code`** read and write graphs as Epic's 5.8 Blueprint DSL text, on every 5.x (a rewrite keeps the nodes its ids name); `create_node` `menuId`, `arrange_nodes` `layout: 'layered'`.
+- **MCP 2026-07-28**: sessionless requests, client consent and tasks; older clients unchanged.
+- **Reads**: `get_editor_state` `focus`; `describe_view` `points`, `labels`, `coveredBy`, `compareWith` (what changed since `saveAs`); **`analyze_view`** (saliency, palette, light, shader cost); **`contact_sheet`** (an actor from every side); **`audit_materials`** (base colours, metallic and roughness off physically based ranges, stretched or crammed textures, meshes to instance); `get_stats` `frame`; `get_ai_info` `info: 'path'` (can a pawn walk there, and why not); **`analyze_level_layout`** (a level's rooms, corridors, chokes and dead ends); **`audit_widget`** (a menu or HUD checked at several screen sizes: cut-off text, overlaps, contrast, safe area).
+- **Large results come in pages** (`page.nextCall`), and **search hands over a clear first hit** (`signature`, `executeCall`).
+- **`nanite_rebuild_mesh` `assetPaths`**, **`inspect_asset` `diff`**, `get_niagara_info` values, `setup_global_illumination` `saveToProject`, four `edit_dynamic_mesh` operations.
+- **Renders and sequences**: **`frame_shot`** (a camera placed so one or two actors sit where asked on screen, in clear view), **`fly_through`** (a camera flown smoothly through points, clear of geometry, keyed into a sequence), **`auto_edit`** (a sequence cut between its cameras as an editor would: no crossing the line, no jump cuts), `cancel_render`, the path tracer's denoiser by name, camera shutter and overscan, `set_section` `playRate`, clips and keyed bones in the readers.
+- **Sound**: **`measure_loudness`** and **`normalize_loudness`** (Sound Waves measured in LUFS as broadcast measures them, and set to play at one loudness); **`analyze_acoustics`** (how long a room rings where a listener stands, and the reverb that fits it).
+- **Animation**: **`auto_blend_space`** (a locomotion blend space laid out from how its clips move).
+- **World building**: a hip **roof** over any footprint (`create_primitive` `roof`), its faces meeting along ridges, hips and valleys; **`erode_landscape`** wears terrain down the way water does (valleys, gullies, filled hollows) so every cell drains, and lists its rivers; **`plan_road`** finds a drivable road under a grade limit, round obstacles and wide enough at every turn, switchbacks on steep slopes; **`assemble_modules`** lays a modular kit out over a grid so every face where two pieces meet fits.
+- **Assets found by what they show**: **`thumbnail_sheet`** (a folder's thumbnails as one numbered picture), **`caption_assets`** (captions kept beside the project, never in the assets), **`find_assets_like`** (by words, an example asset, colour or size).
+- **Writes are checked**: sunk, floating, intersecting, z-fighting or untextured actors, placeholder text, pasted twins, Map Check findings, and Data Validation on assets.
+- **Replies say what undo can revert**; **`restore_point`** undoes only this server's steps and offers the delete of what they created.
+- **`inspect explain`** says why something does not happen and names the call that fixes it.
+- **A call failing three times unchanged is refused** (`REPEATED_FAILURE`).
+- **Batches check every step first**; `build_graph`, `build_material_graph` and `add_widget_tree` take `dryRun`; **`run_script`** runs many calls with loops and conditions in one request, rolled back on a failure; **recipes** keep such a script in the project to run again with other values, and search lists the ones a request names.
+- **`run_map_check`**, **`fix_placement`**, **`describe_relations`**, **`arrange_by_relations`**, **`arrange_widgets`** (a menu or HUD laid out by relations, held at every screen size), **`playtest`** (a pawn walked to a goal in Play, judged with evidence), **`settle_physics`** (props dropped and kept where they come to rest), **`explore_level`** (a pawn explores the level: falls, traps, unreachable areas), and execute's **`expect`/`require`**, checked after or before a call.
+- **`inspect changes_since`** and `ue://changes` subscriptions: what changed since a cursor, and by whom.
+- **Domain playbooks** as MCP prompts: Blueprint logic, input, UI, Niagara, materials, world building, animation, cinematics and play testing, each with the traps of its domain.
+- **`remove_sublevel`**: a sublevel leaves the open level, as the Levels panel's Remove does; its map file stays.
+
+</details>
+
+<details>
+<summary><b>🔄 Changed</b></summary>
+
+- **The npm package is a stdio proxy** to the plugin's `/mcp` with no runtime dependencies: `NOT_CONNECTED` while the editor is down; `UNREAL_MCP_URL` picks the endpoint, `UE_PROJECT_PATH` finds the token.
+- **Enable Native MCP Server is on by default.**
+- **Consent grants need the nonce `describe` minted**: a missing or made-up one is refused (`CONSENT_NOT_ISSUED`).
+
+</details>
+
+<details>
+<summary><b>🗑️ Removed</b></summary>
+
+- **The TypeScript gateway and WebSocket client**, with their resources, telemetry, mock mode and `test:smoke`; `.env` is not read.
+- **Over stdio**: search and describe with the editor down, the `ue://assets`/`actors`/`editor`/`selection` resources, TLS to a remote editor, protocols `2024-11-05` and `2024-10-07`.
+
+</details>
+
+<details>
+<summary><b>🔧 Fixed</b></summary>
+
+- **Crashes**: Ability System actions on non-Actor Blueprints, creates or bakes over another class's asset, and `validate_assets` `dataValidation` with the Data Validation plugin off are refused.
+- **`run_benchmark` measures** frames, FPS and thread times (it measured nothing).
+- **Builds and links on UE 5.0-5.8, Windows and Mac**: every file compiles on its own, Smart Objects and State Trees need no experimental engine module, and older Apple clang and UE 5.8's unreachable-code rule pass.
+- **Small fixes**: `RayTraced` GI refused from 5.4, `runtime_report` filters, retry hints, reads return 0 and false, a material instance can be another's parent, `list_tracks` answers again, a thumbnail's `outputPath` is a PNG on every 5.x, `set_bone_key` keys a sequence's last frame, `create_primitive` says its meshes have no collision, `configure_landscape_splines` shapes the terrain where its points are, placement warnings judge a spline mesh road where its segments lie and an actor on a landscape by its surface, undo takes back a new primitive mesh.
+- **Removals** take exact components, keep assets others use (through a chain of uses too) and undo for tracks and keys.
+- **Nothing is overwritten unasked**: taken names and paths are refused, unsent fields kept, engine content never edited in place.
+- **Family variants** enforce their own requirements, shown by describe.
+- **Renders** honour `renderTimeoutMs`; `save_all` and `restart_editor` wait for them.
+- **An open editor dialog** answers calls `EDITOR_MODAL_ACTIVE` with its title instead of a timeout.
+- **Viewport screenshots wait for streaming** and name video memory over budget.
+- **Property writes** refuse deprecated properties, restart placed Niagara effects, take object references and run components' own change handling.
+- **Placement checks** count simulated bodies and player starts; `fix_coplanar` handles several neighbours.
+- **Animation and effects**: whole track names, partial `set_bone_key`, key times across frame rates, curve read-back; Niagara creates refuse taken names.
+- **Undo** covers spawns, transforms, properties, meshes, landscape, foliage, sequences and more.
+- **Finds stop at `limit`** (default 200) and say how many matched.
+- **Replies say what happened**, failed saves and compiles included.
+- **Successes that did nothing now act** (foliage, water, AI, Play audio, splines, landscape and more).
+- **`manage_effect cleanup`** needs destructive consent and a `filter`, is one undo step and refuses Play; debug shapes clear through `debug_shape`.
+- **Object paths** work in `open_level`, `load` and `add_sublevel`; relative `.t3d` exports land in the project.
+- **Git**: any commit message is safe (a quote could inject options); checkout and submit list skipped paths.
+- **`/mcp` discovery**: search rows, `describe` by domain and family, `cursor` and param `suggestions`.
+- **A disabled tool's `nextCall` turns it back on** (`configure` `enable_tools`).
+
+</details>
+
+<details>
+<summary><b>🔄 Dependencies</b></summary>
+
+- `@modelcontextprotocol/sdk`, `ws` and `zod` left the runtime (`zod` stays for the record build).
+
+</details>
+
+---
+
+## 🏷️ [0.6.0-beta-f] - 2026-10-16
+
+> [!NOTE]
+> **Beta.** Published as a semver prerelease (`0.6.0-beta-f`) under the npm `beta` dist-tag, so `npm install` keeps serving the newest stable release, **`0.5.30`**. This section is everything on `dev` since the `v0.6.0-beta-e` tag, written from the code diff.
+
+<details>
+<summary><b>✨ Added</b></summary>
+
+- **Gameplay in one call**: `add_behaviour`, with a shortcut action for each kind (`add_health`, `add_patrol` and so on), writes health, damage on touch, pickups, sprint, shooting, chase, patrol, turrets, stomps, explosives, moving and falling platforms, player controls, respawn with checkpoints, goals, launch pads, teleporters, a time limit, spawners, dashes, HUD bars and counters, hints and game over into an Actor Blueprint as plain engine nodes.
+- **Blueprint authoring**: Blueprint Interfaces (`implement_interface`), timelines (`edit_timeline`), Bind Event, Switch on Enum, animation-graph nodes by class, a Math Expression's `expression` in batches, and `remove_variable` `variableNames`.
+- **Reading graphs**: `find_functions` finds a function by plain words, `get_graph_details` `filter` finds what reads or moves a variable, `unusedOnly` lists nodes that do nothing, and `compile` takes a `folder`.
+- **Graph checks**: edits and compiles flag pure nodes and random values read twice, timers that name nothing or restart every frame, waits inside loops, values changed in place, event values read after a wait, and sounds that never end on play-and-forget nodes.
+- **Packaging**: `package_project` `executableName` names the game's .exe, `launch_build` `map` smoke-runs one level, and `enable_plugin` `targets` keeps an editor-only plugin out of the packaged game.
+- **Project setup**: `configure_rendering` (Lumen, shadows, anti-aliasing, ray tracing, MegaLights) and `create_cpp_class`.
+- **Many actors at once**: spawn batch `repeat` (rows and grids) and `properties`, `set_transform` and `edit_component` with `actorNames`, `set_folder` and spawn `folder` and `tags`, and spawns and moves that name z-fighting faces.
+- **Motion and physics**: motion reads that wait for a spawn (`spawnOf`), name surfaces passed through and actors overlapped, and return what the game logged, as `step_frame` now does; `analyze_animation`, collision presets and per-channel responses, physical materials and `apply_damage`.
+- **Effects and audio**: several parameters on a placed effect at once, `add_emitter` from another system, `get_niagara_info` for one emitter, `list_metasound_nodes` and box-shaped sound zones.
+- **More reads**: `get_property` `objectPaths`, a child Blueprint's own values for its parent's components, `widget_list` texts and parent panels, `describe_view` `actors`, `get_widget_animation`, screenshot field of view, video memory over budget and `validate_assets` `materialUsage`.
+- **More edits**: skeletal mesh import onto a skeleton, a dynamic mesh started from a static mesh (`meshPath`), `mesh_materials` `assetPaths`, SDF `relativeTo`, input `replaceKey` and `play` `unpauseGame`.
+
+</details>
+
+<details>
+<summary><b>🔄 Changed</b></summary>
+
+- **The editor plugin is now EngineWire** (was McpAutomationBridge), shipped as `EngineWire-plugin-<version>.zip`, with file names short enough for Fab; settings saved under the old name still load.
+- **A Blueprint graph batch is all or nothing**: a failed step undoes the steps before it, and a step works in the graph of the node it names.
+- **Leaner replies**: each actor is named once, `runtime_report` reports the session unless asked for more, `get_component_details` sends values only for `propertyNames` or `detailed`, spawn batches past 20 items list only failures, and transforms read as typed.
+- **The HTTP door takes capability IDs** as the stdio door does.
+- **Widget templates take their content**: a shop its `items` and `currency`, a dialog its `text` and `buttons`.
+
+</details>
+
+<details>
+<summary><b>🔧 Fixed</b></summary>
+
+- **Replies say what really happened**: a widget rename refuses a taken name, a clean compile drops stale warnings, a Shipping smoke run says it wrote no log, compiler warnings reach the receipt, `stop` answers once play has ended, a link through a conversion node reads connected, and a self-destroying spawn, a destroyed actor, a game's own pause, a paused world, a minimized editor, a non-realtime screenshot and a widget holding the keyboard focus are named.
+- **Blueprint graphs**: enums keep their type, array pins say so, pins show a literal only where the graph reads one, call nodes take the names the editor shows, nodes made without a position find a free slot, refused nodes leave nothing, misspelled types are refused, child Blueprints edit their parent's components, and Math Expressions take a unary minus and `&&`/`||` comparisons and still compile in a duplicated Blueprint.
+- **Property values**: Map, Set, array, float and Blueprint struct values read and write as sent, actor arrays take labels, a mesh component's StaticMesh goes through its setter, unknown variable names are refused, and `set_project_setting` resolves a class name and refuses an unknown one.
+- **Gameplay**: projectiles hit, hurt and expire, weapons fire, doors, chests, switches and triggers work, `apply_force` pushes, placed props simulate, batch references land before BeginPlay, and a mouse move reaches a running game.
+- **Input and motion**: a key held across stepped frames counts game time and its reply says it is still down, `remove_mapping` names the action's own `actionMappings`, a scripted mover reads its real velocity, and a reloaded level reads as `levelChanged`.
+- **Placement checks**: no false off-map, sunk or floating reports for floors over pits, enclosures, stacked items, stretched parts and complex collision.
+- **Niagara**: edits act only on the emitter the caller named (#658), create actions refuse a folder that cannot be a package (#668), modules go where their dependencies hold and are named as their inputs are, a duplicated system plays at once, and placed-effect parameters are typed and fully bindable.
+- **Assets**: deletes count what they removed, a filtered list names only matching folders, imports name the mesh, Fab adds a pack's Unreal build, dead material branches list as orphaned, and material usage flags are saved.
+- **Geometry**: appended faces face outwards, arrays are no longer one copy short, and SDF shapes mesh at the resolution asked for.
+- **Editor**: a level load answers once the level has settled, `console_command` keeps lines logged on other threads, and native replies write negative zero as `0`, which strict clients rejected (#662).
+- **Builds**: the plugin declares Win64, Mac and Linux, so an Android build skips it (#666), and it compiles again with Fab's UE 5.0-5.4 toolchains.
+- **Undo, search and guidance**: volume and single-actor component edits are one undo step, more plain requests are found, a refusal names the parameter a stray key belongs to, a reply keeps the typed and project paths it quotes, and every pointer in record text names a real action.
+
+</details>
+
+<details>
+<summary><b>🗑️ Removed</b></summary>
+
+- **Level-call aliases that were always refused**: `open_level` `path` and `assetPath`, `focus_actor` `name`, `manage_level` `delete` `path` and `levelPaths`, `duplicate_level` `targetPath`, and `set_metadata` and `validate_level` `assetPath`. Send `levelPath`, `actorName` or `destinationPath`.
+
+</details>
+
+<details>
+<summary><b>⚠️ Migration</b></summary>
+
+- **Plugin rename**: delete `Plugins/McpAutomationBridge` and unpack `EngineWire-plugin-<version>.zip` in its place; a `.uproject` that names `McpAutomationBridge` should name `EngineWire`. Settings under `[/Script/McpAutomationBridge.McpAutomationBridgeSettings]` still load while `[/Script/EngineWire.EngineWireSettings]` is empty.
+- **`get_component_details`** lists property values only with `propertyNames` or `detailed: true`.
+- **`resume`** answers `GAME_PAUSED` when the game paused itself (a pause menu or a title screen); pass `unpauseGame: true` to lift that pause too.
+- **A spawn whose actor destroys itself** answers `SPAWNED_THEN_DESTROYED`, and property reads and writes refuse a destroyed actor.
+- **Reply fields**: `remove_mapping` and a per-mapping `set_modifier` return `actionMappings` (was `mappingCount` and `mappings`), and `set_camera` returns `requestedLocation` and `requestedRotation` only when the pose was not taken.
+
+</details>
+
+<details>
+<summary><b>🔄 Dependencies</b></summary>
+
+- GitHub Actions only: release-drafter 7.10.0, CodeQL 4.38.3 and setup-node 7.1.0 (#670-#674). No npm package changed.
+
+</details>
+
+<details>
+<summary><b>👥 Contributors</b></summary>
+
+- @SoloGorilla for making Niagara edits act only on the emitter the caller named (#658), and Niagara create actions refuse a folder that cannot be a package instead of reporting success with nothing saved (#668).
+- @Robin7-hub-code for reporting the negative zero that strict MCP clients rejected (#661), and @HeCPDF for reporting the Android packaging failure (#665).
+
+</details>
+
+<details>
+<summary><b>📊 Change Statistics</b></summary>
+
+| Metric | Count |
+|--------|-------|
+| Diff range | `v0.6.0-beta-e..v0.6.0-beta-f` |
+| Commits | 212, the version bump and this release entry included |
+| Files changed | 1,976 (1,950 hand-written, not counting generated files or line-ending-only changes) |
+| Insertions / deletions | 34,715 / 11,597 (hand-written: 26,407 / 10,792) |
+| Capability records | 416 |
+| Callable `{tool, action}` pairs | 1,554 |
+| C++ domain directories | 55 |
+
+</details>
+
+---
+
 ## 🏷️ [0.6.0-beta-e] - 2026-10-09
 
 > [!NOTE]

package/README.md

@@ -1,11 +1,13 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/wiki/ChiR24/Unreal_mcp/assets/banner.svg" alt="Unreal Engine MCP Server: let any AI assistant work inside the Unreal Editor" width="100%">
+  <img src="Public/banner.svg" alt="EngineWire: let any AI assistant work inside the Unreal Editor" width="100%">
 </p>
 
+<h1 align="center">EngineWire</h1>
+
 <p align="center">
   <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
   <a href="https://www.npmjs.com/package/unreal-engine-mcp-server"><img alt="npm" src="https://img.shields.io/npm/v/unreal-engine-mcp-server"></a>
-  <a href="https://www.npmjs.com/package/unreal-engine-mcp-server?activeTab=versions"><img alt="npm beta" src="https://img.shields.io/npm/v/unreal-engine-mcp-server/beta?label=npm%20%40beta&color=8957e5"></a>
+  <a href="https://www.fab.com/listings/9407137f-14b3-44a8-af0e-e9c6a9c9f6fc"><img alt="Get it on Fab" src="https://img.shields.io/badge/Fab-Get%20EngineWire-0a0a0a"></a>
   <a href="https://github.com/modelcontextprotocol/sdk"><img alt="MCP SDK" src="https://img.shields.io/badge/MCP%20SDK-TypeScript-blue"></a>
   <a href="https://www.unrealengine.com/"><img alt="Unreal Engine 5.0-5.8" src="https://img.shields.io/badge/Unreal%20Engine-5.0--5.8-orange"></a>
   <a href="https://registry.modelcontextprotocol.io/"><img alt="MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-Published-green"></a>
@@ -15,7 +17,7 @@
 </p>
 
 <p align="center">
-  <b>Connect Claude, Cursor, VS Code or any other MCP client to a running Unreal Editor,</b><br>
+  <b>EngineWire connects Claude, Cursor, VS Code or any other MCP client to a running Unreal Editor,</b><br>
   and let it build levels, Blueprints, UI, materials, effects and more, through a native C++ editor plugin.
 </p>
 
@@ -24,13 +26,15 @@
 </p>
 
 <p align="center">
+  <a href="https://enginewire.dev"><b>🌐 enginewire.dev</b></a> &nbsp;·&nbsp;
+  <a href="https://www.fab.com/listings/9407137f-14b3-44a8-af0e-e9c6a9c9f6fc"><b>🛒 Fab</b></a> &nbsp;·&nbsp;
   <a href="https://github.com/ChiR24/Unreal_mcp/wiki/Quick-Start"><b>🚀 Quick Start</b></a> &nbsp;·&nbsp;
   <a href="https://github.com/ChiR24/Unreal_mcp/wiki"><b>📖 Wiki</b></a> &nbsp;·&nbsp;
   <a href="https://github.com/ChiR24/Unreal_mcp/releases"><b>📦 Releases</b></a> &nbsp;·&nbsp;
   <a href="https://github.com/ChiR24/Unreal_mcp/discussions"><b>💬 Discussions</b></a>
 </p>
 
-> 📌 **Which version is this?** This README describes the **0.6** line: the `dev` branch and npm `unreal-engine-mcp-server@beta`. The previous stable release, **0.5.30** (npm `latest`), exposes 23 separate tools instead of one; see [Upgrading from 0.5.x](https://github.com/ChiR24/Unreal_mcp/wiki/Upgrading).
+> 📌 **Which version is this?** This README describes **0.6.0**, the stable release: npm `unreal-engine-mcp-server` (`latest`) and the plugin on the [Releases page](https://github.com/ChiR24/Unreal_mcp/releases) and on [Fab](https://www.fab.com/listings/9407137f-14b3-44a8-af0e-e9c6a9c9f6fc). The previous release, **0.5.30**, exposes 23 separate tools instead of one; see [Upgrading from 0.5.x](https://github.com/ChiR24/Unreal_mcp/wiki/Upgrading).
 
 **Contents** · [What it does](#what-it-does) · [How it works](#how-it-works) · [Quick start](#quick-start) · [The `unreal` tool](#the-unreal-tool) · [Configuration](#configuration) · [Security](#security) · [Engine plugins](#engine-plugins) · [Docker](#docker) · [Documentation](#documentation) · [Development](#development) · [Community](#community)
 
@@ -91,35 +95,38 @@ Nearly 400 capabilities in all, behind a single MCP tool. The assistant finds th
 ## How it works
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/wiki/ChiR24/Unreal_mcp/assets/diagrams/architecture.svg" alt="Architecture: an AI client reaches the MCP Automation Bridge plugin inside the Unreal Editor either over Streamable HTTP on port 3000 (Route A) or through the Node.js server over stdio and a WebSocket on port 8090 (Route B); the plugin drives the editor APIs on the game thread" width="100%">
+  <img src="Public/architecture.svg" alt="Architecture: an AI client reaches the EngineWire plugin inside the Unreal Editor over Streamable HTTP on port 3000, either directly (Route A) or through the Node.js stdio proxy (Route B); the plugin drives the editor APIs on the game thread" width="100%">
 </p>
 
-The **MCP Automation Bridge** plugin runs inside the editor and does all the work, on the editor's game thread. Clients reach it in one of two ways, and both expose the same single tool, `unreal`:
+The **EngineWire** plugin runs inside the editor and does all the work, on the editor's game thread, and serves MCP itself. Clients reach it in one of two ways, and both get the same single tool, `unreal`:
 
 | | 🌐 Route A · Native HTTP | 🧩 Route B · stdio |
 | --- | --- | --- |
-| **Path** | Client → the plugin's Streamable HTTP server at `http://127.0.0.1:3000/mcp` | Client → `unreal-engine-mcp-server` (Node.js, stdio) → the plugin's WebSocket on `127.0.0.1:8090` |
+| **Path** | Client → the plugin's Streamable HTTP server at `http://127.0.0.1:3000/mcp` | Client → `unreal-engine-mcp-server` (Node.js, stdio) → the same `/mcp` |
 | **Node.js** | Not needed | 20.19 or later |
 | **Capability token** | The client sends it in the `X-MCP-Capability-Token` header | Read from the project, given `UE_PROJECT_PATH` |
-| **Best for** | Claude Code, Cursor, VS Code, and several clients sharing one editor | Claude Desktop, and clients that only launch local commands |
+| **Editor restarts** | The client reconnects by hand | The session stays: calls answer `NOT_CONNECTED` until the editor is back |
+| **Best for** | Claude Code, Cursor, VS Code, and several clients sharing one editor | Claude Desktop, clients that only launch local commands, and long sessions across editor restarts |
 
 Everything listens on `127.0.0.1` and requires the project's capability token unless you change it.
 
 ## Quick start
 
-The [Quick Start](https://github.com/ChiR24/Unreal_mcp/wiki/Quick-Start) page walks through this with screenshots. You need Unreal Engine 5.0 to 5.8 and a project with C++ code; a Blueprint-only project can use [prebuilt binaries](https://github.com/ChiR24/Unreal_mcp/wiki/Installation#option-c-prebuilt-binaries).
+The [Quick Start](https://github.com/ChiR24/Unreal_mcp/wiki/Quick-Start) page walks through this with screenshots. You need Unreal Engine 5.0 to 5.8. Installing from Fab needs nothing else; building the plugin from source needs a project with C++ code (a Blueprint-only project can install from Fab or use [prebuilt binaries](https://github.com/ChiR24/Unreal_mcp/wiki/Installation#option-c-prebuilt-binaries)).
 
 ### 1. Add the plugin
 
-Download `McpAutomationBridge-plugin-<version>.zip` from the newest `v0.6` pre-release on the [Releases page](https://github.com/ChiR24/Unreal_mcp/releases), and copy the `McpAutomationBridge` folder it contains into your project:
+**From Fab (no compiler needed).** Get [EngineWire on Fab](https://www.fab.com/listings/9407137f-14b3-44a8-af0e-e9c6a9c9f6fc). In the Epic Games Launcher, open **Unreal Engine › Library › Fab Library**, find **EngineWire** and click **Install to Engine** for your engine version. Open your project, enable **EngineWire** in **Edit › Plugins** and restart the editor. The Fab build ships with the native server off: turn on **Enable Native MCP Server** in **Edit › Project Settings › Plugins › EngineWire › Native MCP** and restart once more. Fab updates follow Epic's review, so the Fab build can trail the newest release here.
+
+**From a release.** Download `EngineWire-plugin-<version>.zip` from the newest release on the [Releases page](https://github.com/ChiR24/Unreal_mcp/releases), and copy the `EngineWire` folder it contains into your project:
 
 ```text
-MyGame/Plugins/McpAutomationBridge/
+MyGame/Plugins/EngineWire/
 ```
 
-Or use a clone of this repository: copy `plugins/McpAutomationBridge/`, or reference the folder from your `.uproject` with `"AdditionalPluginDirectories": ["C:/Path/To/Unreal_mcp/plugins"]`.
+Or use a clone of this repository: copy `plugins/EngineWire/`, or reference the folder from your `.uproject` with `"AdditionalPluginDirectories": ["C:/Path/To/Unreal_mcp/plugins"]`.
 
-Open the project and let Unreal rebuild the plugin. When it's loaded, the status bar shows **`MCP off`**. If you see *"Engine modules cannot be compiled at runtime"*, build the project once in Visual Studio, Rider or Xcode. More in [Installation](https://github.com/ChiR24/Unreal_mcp/wiki/Installation).
+Open the project and let Unreal rebuild the plugin. When it's loaded, the status bar shows **`MCP :3000 (0)`**: the plugin serves MCP on port `3000`. If you see *"Engine modules cannot be compiled at runtime"*, build the project once in Visual Studio, Rider or Xcode. More in [Installation](https://github.com/ChiR24/Unreal_mcp/wiki/Installation).
 
 https://github.com/user-attachments/assets/d8b86ebc-4364-48c9-9781-de854bf3ef7d
 
@@ -134,7 +141,7 @@ Build the plugin once on a machine with the engine and a compiler, then hand out
 node scripts/package-plugin.mjs "C:/Program Files/Epic Games/UE_5.7"
 ```
 
-This writes `build/McpAutomationBridge-v<version>-UE5.7-<Platform>.zip`, where `<version>` is the `package.json` version (currently `0.6.0-beta-e`). Unzip it into `YourProject/Plugins/`. Binaries only work with the engine minor and platform they were built for: a 5.6 build won't load in 5.5, 5.7 or 5.8.
+This writes `build/EngineWire-v<version>-UE5.7-<Platform>.zip`, where `<version>` is the `package.json` version (currently `0.6.0`). Unzip it into `YourProject/Plugins/`. Binaries only work with the engine minor and platform they were built for: a 5.6 build won't load in 5.5, 5.7 or 5.8.
 
 </details>
 
@@ -142,7 +149,7 @@ This writes `build/McpAutomationBridge-v<version>-UE5.7-<Platform>.zip`, where `
 
 **Route A · Native HTTP (no Node.js)**
 
-1. In **Edit › Project Settings › Plugins › MCP Automation Bridge**, tick **Enable Native MCP Server** (port `3000` by default), then restart the editor. The status bar now reads **`MCP :3000 (0)`**.
+1. **Enable Native MCP Server** is on by default (**Edit › Project Settings › Plugins › EngineWire**, port `3000`); the Fab build ships with it off. A project where it is off needs it on and an editor restart.
 
    <img src="https://raw.githubusercontent.com/wiki/ChiR24/Unreal_mcp/assets/screenshots/settings-native-mcp.png" alt="The Native MCP section of the plugin settings, with Enable Native MCP Server ticked" width="520">
 
@@ -173,31 +180,10 @@ This writes `build/McpAutomationBridge-v<version>-UE5.7-<Platform>.zip`, where `
 
    <img src="https://raw.githubusercontent.com/wiki/ChiR24/Unreal_mcp/assets/screenshots/status-bar.png" alt="Unreal Editor status bar showing MCP :3000 (1): the native MCP server on port 3000 with one client connected" width="520">
 
-<details>
-<summary><b>Keep the session when the editor restarts (proxy, Node.js 20.19+)</b></summary>
-
-<br>
-
-A client connected straight to `/mcp` loses its session whenever the editor closes or crashes, and has to reconnect by hand. The package's `proxy` command sits in between over stdio: while the editor is down every call answers `NOT_CONNECTED`, and the first call after it is back reaches it, with no reconnect. It keeps the editor's last tool list, so a session that starts before the editor still gets the real tool.
-
-```json
-{
-  "mcpServers": {
-    "unreal-engine": {
-      "command": "npx",
-      "args": ["-y", "unreal-engine-mcp-server@beta", "proxy"],
-      "env": { "UE_PROJECT_PATH": "C:/Path/To/YourProject" }
-    }
-  }
-}
-```
-
-The token is found the same way as on Route B (`MCP_AUTOMATION_CAPABILITY_TOKEN`, else the project's token file). `UNREAL_MCP_URL` points it at another endpoint (default `http://127.0.0.1:3000/mcp`). Route B survives editor restarts the same way on its own.
-
-</details>
-
 **Route B · stdio (Node.js 20.19+)**
 
+The package is a small stdio proxy in front of the same `/mcp`. A client connected straight to `/mcp` loses its session whenever the editor closes or crashes, and has to reconnect by hand. Through the proxy, every call answers `NOT_CONNECTED` while the editor is down, and the first call after it is back reaches it, with no reconnect. It keeps the editor's last tool list, so a session that starts before the editor still gets the real tool.
+
 Add this to your client's MCP configuration, for example Claude Desktop's `claude_desktop_config.json`:
 
 ```json
@@ -205,7 +191,7 @@ Add this to your client's MCP configuration, for example Claude Desktop's `claud
   "mcpServers": {
     "unreal-engine": {
       "command": "npx",
-      "args": ["-y", "unreal-engine-mcp-server@beta"],
+      "args": ["-y", "unreal-engine-mcp-server"],
       "env": {
         "UE_PROJECT_PATH": "C:/Path/To/YourProject"
       }
@@ -214,7 +200,7 @@ Add this to your client's MCP configuration, for example Claude Desktop's `claud
 }
 ```
 
-`UE_PROJECT_PATH` (the project folder or its `.uproject`) is how the server finds the capability token and the plugin's port, so nothing else needs setting. Keep the `@beta` tag: without it, npm installs 0.5.30, which doesn't match a 0.6 plugin.
+`UE_PROJECT_PATH` (the project folder or its `.uproject`) is how the proxy finds the capability token (`MCP_AUTOMATION_CAPABILITY_TOKEN` overrides it). `UNREAL_MCP_URL` points it at another endpoint (default `http://127.0.0.1:3000/mcp`). Pair it with a 0.6 plugin; a 0.5.x plugin serves its 23 separate tools instead of the `unreal` gateway.
 
 ### 3. Try it
 
@@ -232,7 +218,7 @@ Both routes expose exactly **one** MCP tool, `unreal`, with four operations. Onl
 | `configure` | Enables or disables groups of internal tools; never touches the editor |
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/wiki/ChiR24/Unreal_mcp/assets/diagrams/gateway.svg" alt="The gateway flow: search with a query returns rows with a nextCall; describe with tool and action returns the contract; execute with params, and consent when needed, returns data and a receipt listing changes, handles and warnings" width="100%">
+  <img src="Public/gateway.svg" alt="The gateway flow: search with a query returns rows with a nextCall; describe with tool and action returns the contract; execute with params, and consent when needed, returns data and a receipt listing changes, handles and warnings" width="100%">
 </p>
 
 A typical exchange:
@@ -256,7 +242,7 @@ A typical exchange:
 
 - **Parameters are strict.** An undeclared name is refused with `UNDECLARED_PARAMETER` and the list of allowed names; every error carries an executable `nextCall`.
 - **Deletes need consent.** 62 capabilities (all destructive ones, plus some writes) only run with the `consentGrant` from `describe`, passed back as a top-level `consent` field.
-- **Names.** Both routes accept the `tool` + `action` pair; the stdio route also accepts a capability id, such as `"capability": "control_actor.spawn"`.
+- **Names.** A call names the `tool` + `action` pair or a capability id, such as `"capability": "control_actor.spawn"`.
 
 Full reference with real replies: [Using the Gateway](https://github.com/ChiR24/Unreal_mcp/wiki/Using-the-Gateway).
 
@@ -266,7 +252,7 @@ The single `unreal` tool is permanent on both routes; there is no opt-out and no
 
 ### Protocol versions
 
-Both routes negotiate the MCP protocol version at `initialize`. The native `/mcp` transport supports `2025-11-25` (latest), `2025-06-18` and `2025-03-26`; the stdio server also accepts the legacy `2024-11-05` and `2024-10-07`. An unsupported `MCP-Protocol-Version` header on the native route gets HTTP 400. Both also answer `server/discover` without a session, listing those versions, so a client on the newer 2026-07-28 revision falls back to `initialize`. Details: [docs/protocol.md](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/protocol.md).
+Both routes negotiate the MCP protocol version at `initialize`: `2025-11-25` (latest), `2025-06-18` or `2025-03-26`. A client asking for an older version is answered with `2025-11-25`. An unsupported `MCP-Protocol-Version` header on the native route gets HTTP 400. Both also serve MCP 2026-07-28 per request, with no `initialize` or session, and answer `server/discover` with it. Details: [docs/protocol.md](https://github.com/ChiR24/Unreal_mcp/blob/dev/docs/protocol.md).
 
 <details>
 <summary><b>The 23 internal tools behind <code>unreal</code></b></summary>
@@ -305,15 +291,15 @@ These route requests inside the gateway; clients never list them. More in the [T
 
 ## Configuration
 
-Most setups touch one setting: **Enable Native MCP Server** for Route A, or `UE_PROJECT_PATH` for Route B. Everything is listed on the [Configuration](https://github.com/ChiR24/Unreal_mcp/wiki/Configuration) page.
+Most setups touch one setting: `UE_PROJECT_PATH` for Route B; Route A needs none. Everything is listed on the [Configuration](https://github.com/ChiR24/Unreal_mcp/wiki/Configuration) page.
 
-**Plugin settings** (Project Settings › Plugins › MCP Automation Bridge, saved in `Config/DefaultGame.ini`):
+**Plugin settings** (Project Settings › Plugins › EngineWire, saved in `Config/DefaultGame.ini`):
 
 | Setting | Default | |
 | --- | --- | --- |
-| Enable Native MCP Server | off | Serve MCP over HTTP at `/mcp` |
+| Enable Native MCP Server | on | Serve MCP over HTTP at `/mcp` (both routes use it) |
 | Native MCP Port | `3000` | The `MCP_NATIVE_PORT` environment variable of the editor process overrides it |
-| Listen Ports | `8090,8091` | WebSocket ports for Route B |
+| Listen Ports | `8090,8091` | The plugin's WebSocket listener; neither route uses it |
 | Require Capability Token | on | Both routes refuse clients without the token |
 | Allow Non Loopback | off | LAN access for both listeners. See [Security](https://github.com/ChiR24/Unreal_mcp/wiki/Security#lan-access). |
 
@@ -321,11 +307,9 @@ Most setups touch one setting: **Enable Native MCP Server** for Route A, or `UE_
 
 | Variable | Default | |
 | --- | --- | --- |
-| `UE_PROJECT_PATH` | unset | Project folder or `.uproject`; used to find the token and the port |
-| `MCP_AUTOMATION_PORT` | the project's first Listen Ports entry, else `8090` | Editor WebSocket port |
-| `MCP_AUTOMATION_HOST` | `127.0.0.1` | A LAN address also needs `MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true` |
-| `MCP_AUTOMATION_CAPABILITY_TOKEN` | read from the token file | Token to present, when the server can't read the project folder |
-| `MCP_ADDITIONAL_PATH_PREFIXES` | empty | Extra content roots such as `/MyPluginContent/`, comma-separated; most content-path arguments also accept the mounts the connected editor reports, so this is needed only with no editor connected, for a mount the editor does not report or the server ignores, and for arguments the server treats as files (`filePath`, `outputPath` and a few others), even where `outputPath` names an asset |
+| `UE_PROJECT_PATH` | unset | Project folder or `.uproject`; used to find the token |
+| `MCP_AUTOMATION_CAPABILITY_TOKEN` | read from the token file | Token to present, when the proxy can't read the project folder |
+| `UNREAL_MCP_URL` | `http://127.0.0.1:3000/mcp` | The editor's `/mcp` endpoint |
 | `LOG_LEVEL` | `info` | `debug`, `info`, `warn` or `error`; logs go to stderr |
 
 ## Security
@@ -333,7 +317,7 @@ Most setups touch one setting: **Enable Native MCP Server** for Route A, or `UE_
 - **Local by default.** Both routes listen on `127.0.0.1` only. LAN access needs **Allow Non Loopback**, and the native server refuses to bind off-loopback unless **Require Capability Token** is on.
 - **Capability token.** Generated per project at `<Project>/Saved/MCP/capability-token` (a value typed into **Capability Token** overrides it) and compared in constant time. Delete the file and restart the editor to rotate it.
 - **Consent for destructive work.** Deletes and some other writes need a per-call consent grant, which the plugin checks itself.
-- **Guard rails.** Asset paths are limited to `/Game`, `/Engine`, `/Script`, `/Temp`, `/Niagara` plus configured prefixes, and a content path may also sit under a mount the connected editor reports; arguments the server treats as files (such as `filePath`, and `outputPath` even where it names an asset) never use the reported mounts; console commands that chain or quit the editor are blocked; the plugin's own settings are out of reach of automation.
+- **Guard rails.** Asset paths are limited to `/Game`, `/Engine`, `/Script`, `/Temp` and `/Niagara`, and a content path may also sit under a mount the connected editor reports; arguments the server treats as files (such as `filePath`, and `outputPath` even where it names an asset) never use the reported mounts; console commands that chain or quit the editor are blocked; the plugin's own settings are out of reach of automation.
 
 Details: [Security](https://github.com/ChiR24/Unreal_mcp/wiki/Security). Please report vulnerabilities privately through [GitHub security advisories](https://github.com/ChiR24/Unreal_mcp/security/advisories/new).
 
@@ -373,7 +357,7 @@ The bridge declares its engine-plugin dependencies, so Unreal enables them toget
 | **MetaSound**, **Synthesis** | `manage_audio`: MetaSound authoring |
 | **Enhanced Input**, **Online Subsystem**, **Online Subsystem Utils** | `manage_networking`: input mappings, sessions |
 | **Interchange**, **Interchange OpenUSD**, **Data Validation**, **StructUtils** | Import/export, validation, struct helpers |
-| **Fab**, **Bridge** | Fab asset library access (optional `McpAutomationBridgeFab` module) |
+| **Fab**, **Bridge** | Fab asset library access (optional `EngineWireFab` module) |
 
 </details>
 
@@ -381,7 +365,7 @@ The plugin targets every Unreal Engine minor from 5.0 to 5.8. If it fails to bui
 
 ## Docker
 
-The image runs the stdio server. It has to reach the editor's WebSocket on `127.0.0.1`, so use host networking (Linux), and pass the token because the container can't read your project folder:
+The image runs the stdio proxy. It has to reach the editor's `/mcp` on `127.0.0.1:3000`, so use host networking (Linux), and pass the token because the container can't read your project folder:
 
 ```bash
 docker build -t unreal-mcp .
@@ -413,19 +397,18 @@ npm run dev                # run from source with ts-node
 npm run lint               # ESLint (CI fails on any warning)
 npm run type-check         # tsc --noEmit, sources and tests
 npm run test:unit          # Vitest unit tests (no Unreal required)
-npm run test:smoke         # offline mock-mode MCP check (needs built dist/)
 npm run test:params        # strict parameter audit
 npm run registry:generate  # capability records -> generated contracts, native shards, action reference
 npm run registry:check     # fail if generated artifacts drift
 npm run manifest:check     # fail if the gateway manifest drifts
 npm run eval:check         # search-ranking corpus
 npm run version:check      # all version sources agree
-npm test                   # integration suite (needs a live Unreal Editor + bridge)
+npm test                   # integration suite (needs a live Unreal Editor serving /mcp)
 ```
 
 The capability records in `src/tools/catalog/capabilities/records/` are the single source of truth; every `*.generated.*` file, the plugin's `MCP/Generated/` shards and the action reference are generated from them. Never hand-edit generated files. How to add a capability: [Development](https://github.com/ChiR24/Unreal_mcp/wiki/Development).
 
-**CI** runs, in order: ESLint (`npx eslint . --max-warnings=0`), type-check, unit tests, `registry:check`, `manifest:check`, `headers:check`, the strict parameter audit (`test:params`) and `eval:check`, then a blocking runtime dependency audit (`npm audit --omit=dev --audit-level=moderate`) and an informational full-tree audit. A Node 20.19 / 26 matrix adds `build` and `test:smoke`. Plugin packaging runs only when an Unreal Engine root is configured, because CI runners don't ship an engine. Release archives exclude `Binaries/`, `Intermediate/` and `Saved/`.
+**CI** runs, in order: ESLint (`npx eslint . --max-warnings=0`), type-check, unit tests, `registry:check`, `manifest:check`, `headers:check`, the strict parameter audit (`test:params`) and `eval:check`, then a blocking runtime dependency audit (`npm audit --omit=dev --audit-level=moderate`) and an informational full-tree audit. A Node 20.19 / 26 matrix adds `build`. Plugin packaging runs only when an Unreal Engine root is configured, because CI runners don't ship an engine. Release archives exclude `Binaries/`, `Intermediate/` and `Saved/`.
 
 ## Community
 

package/dist/cli.js

@@ -1,15 +1,5 @@
 #!/usr/bin/env node
-import { Logger } from './utils/logging/logger.js';
-if (process.argv[2] === 'proxy') {
-    const { startNativeProxy } = await import('./proxy/native-proxy.js');
-    startNativeProxy();
-    process.stdin.once('end', () => process.exit(0));
-}
-else {
-    const { startStdioServer } = await import('./index.js');
-    startStdioServer().catch((err) => {
-        new Logger('CLI').error('Failed to start server:', err instanceof Error ? err : String(err));
-        process.exit(1);
-    });
-}
+import { startNativeProxy } from './proxy/native-proxy.js';
+startNativeProxy();
+process.stdin.once('end', () => process.exit(0));
 //# sourceMappingURL=cli.js.map

package/dist/constants.js

@@ -1,18 +1,3 @@
 import { createRequire } from 'node:module';
 export const PACKAGE = createRequire(import.meta.url)('../package.json');
-export const DEFAULT_AUTOMATION_HOST = '127.0.0.1';
-export const DEFAULT_AUTOMATION_PORT = 8090;
-export const DEFAULT_NEGOTIATED_PROTOCOLS = ['mcp-automation'];
-export const DEFAULT_HEARTBEAT_INTERVAL_MS = 10000;
-export const DEFAULT_MAX_PENDING_REQUESTS = 25;
-export const DEFAULT_MAX_QUEUED_REQUESTS = 100;
-export const DEFAULT_MAX_INBOUND_MESSAGES_PER_MINUTE = 600;
-export const LONG_RUNNING_OP_TIMEOUT_MS = 300000;
-export const CONSOLE_COMMAND_TIMEOUT_MS = 30000;
-export const ENGINE_QUERY_TIMEOUT_MS = 15000;
-export const PROGRESS_EXTENSION_MS = 30000;
-export const MAX_PROGRESS_EXTENSIONS = 10;
-export const PROGRESS_STALE_THRESHOLD = 3;
-export const ABSOLUTE_MAX_TIMEOUT_MS = 300000;
-export const MAX_WS_MESSAGE_SIZE_BYTES = 5 * 1024 * 1024;
 //# sourceMappingURL=constants.js.map