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

package/CHANGELOG.md

@@ -13,6 +13,69 @@ _Nothing yet._
 
 ---
 
+## 🏷️ [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` writes health, damage on touch, pickups, sprint, shooting, chase, patrol, turrets, player controls, respawn, goals, jump pads, explosives, stomps, moving and falling platforms, countdowns, teleporters, spawners, dashes, HUD bars and counters, hints and game over into an Actor Blueprint as plain engine nodes.
+- **Blueprint authoring**: Blueprint Interfaces, 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**: `inspect_graph` `functions` finds a function by plain words, `get_graph_details` `filter` finds what reads or moves a variable and `unusedOnly` lists dead nodes, graph edits warn about pure nodes that run twice, and `compile` takes a `folder`.
+- **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 spawns and moves that name z-fighting faces.
+- **Motion and physics**: motion reads that wait for a spawn (`spawnOf`) and name surfaces passed through and actors overlapped, `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 and edits**: `get_property` `objectPaths`, `widget_list` texts and parent panels, `describe_view` `actors`, `get_widget_animation`, screenshot field of view, skeletal mesh import onto a skeleton, `validate_assets` `materialUsage`, `mesh_materials` `assetPaths`, SDF `relativeTo` and input `replaceKey`.
+
+</details>
+
+<details>
+<summary><b>🔄 Changed</b></summary>
+
+- **The editor plugin is now EngineWire** (was McpAutomationBridge), with short file names that fit 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.
+- **Leaner replies**: each actor is named once, `runtime_report` reports the session unless asked for more, spawn batches past 20 items list only failures, and transforms read as typed.
+- **The HTTP door takes capability IDs** as the stdio door does, and level calls list only the names they take.
+- **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, and a self-destroying spawn, a game's own pause, a minimized editor and a non-realtime screenshot are named.
+- **Blueprint graphs**: enums keep their type, array pins say so, 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, and Math Expressions take a unary minus and `&&`/`||` comparisons.
+- **Property values**: Map, Set, array, float and Blueprint struct values read and write as sent, actor arrays take labels, and unknown variable names are refused.
+- **Gameplay**: projectiles hit and hurt, weapons fire, doors and switches open, `apply_force` pushes, placed props simulate, batch references land before BeginPlay, and a mouse move reaches a running game.
+- **Placement checks**: no false off-map, sunk or floating reports for floors over pits, enclosures, stacked items and complex collision.
+- **Niagara**: modules go where their dependencies hold, a duplicated system plays at once, and placed-effect parameters are typed and fully bindable.
+- **Assets**: deletes count what they removed, 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.
+- **Undo, search and guidance**: volume and single-actor component edits are one undo step, more plain requests are found, and every pointer in record text names a real action.
+
+</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,7 +1,9 @@
 <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>
@@ -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>
 
@@ -91,10 +93,10 @@ 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 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%">
 </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. Clients reach it in one of two ways, and both expose the same single tool, `unreal`:
 
 | | 🌐 Route A · Native HTTP | 🧩 Route B · stdio |
 | --- | --- | --- |
@@ -111,13 +113,13 @@ The [Quick Start](https://github.com/ChiR24/Unreal_mcp/wiki/Quick-Start) page wa
 
 ### 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:
+Download `EngineWire-plugin-<version>.zip` from the newest `v0.6` pre-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).
 
@@ -134,7 +136,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-beta-f`). 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 +144,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. In **Edit › Project Settings › Plugins › EngineWire**, tick **Enable Native MCP Server** (port `3000` by default), then restart the editor. The status bar now reads **`MCP :3000 (0)`**.
 
    <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">
 
@@ -232,7 +234,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:
@@ -307,7 +309,7 @@ These route requests inside the gateway; clients never list them. More in the [T
 
 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.
 
-**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 | |
 | --- | --- | --- |
@@ -373,7 +375,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>
 

package/dist/automation/bridge-config.js

@@ -2,7 +2,8 @@ import net from 'node:net';
 import { DEFAULT_AUTOMATION_HOST, DEFAULT_AUTOMATION_PORT, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_MAX_INBOUND_MESSAGES_PER_MINUTE, DEFAULT_MAX_PENDING_REQUESTS, DEFAULT_MAX_QUEUED_REQUESTS, DEFAULT_NEGOTIATED_PROTOCOLS, PACKAGE } from '../constants.js';
 import { config } from '../config.js';
 import { readProjectIniValue } from '../utils/config/ini-reader.js';
-const BRIDGE_SETTINGS_SECTION = '/Script/McpAutomationBridge.McpAutomationBridgeSettings';
+const BRIDGE_SETTINGS_SECTION = '/Script/EngineWire.EngineWireSettings';
+const LEGACY_BRIDGE_SETTINGS_SECTION = '/Script/McpAutomationBridge.McpAutomationBridgeSettings';
 const BRIDGE_SETTINGS_CATEGORY = 'Game';
 function readProjectListenPort(log) {
     const projectPath = process.env.UE_PROJECT_PATH;
@@ -10,7 +11,8 @@ function readProjectListenPort(log) {
         return null;
     }
     try {
-        const raw = readProjectIniValue(projectPath, BRIDGE_SETTINGS_CATEGORY, BRIDGE_SETTINGS_SECTION, 'ListenPorts');
+        const raw = readProjectIniValue(projectPath, BRIDGE_SETTINGS_CATEGORY, BRIDGE_SETTINGS_SECTION, 'ListenPorts')
+            ?? readProjectIniValue(projectPath, BRIDGE_SETTINGS_CATEGORY, LEGACY_BRIDGE_SETTINGS_SECTION, 'ListenPorts');
         if (raw === undefined) {
             return null;
         }

package/dist/automation/message-schema.js

@@ -60,8 +60,8 @@ export function pluginVersionMismatch(metadata) {
     const server = `${PACKAGE.name} ${PACKAGE.version}`;
     const install = `install the ${PACKAGE.version} plugin from ${RELEASE_TAG_URL}${PACKAGE.version} and restart the editor`;
     return typeof plugin === 'string'
-        ? `Version mismatch: this server is ${server} but the editor runs McpAutomationBridge ${plugin}, so actions and parameters can differ. Fix: ${install}, or pin the server to the plugin with npx -y ${PACKAGE.name}@${plugin} and restart the MCP client.`
-        : `Version mismatch: this server is ${server} but the editor runs a McpAutomationBridge plugin that predates version reporting, so actions and parameters can differ. Fix: ${install}.`;
+        ? `Version mismatch: this server is ${server} but the editor runs EngineWire ${plugin}, so actions and parameters can differ. Fix: ${install}, or pin the server to the plugin with npx -y ${PACKAGE.name}@${plugin} and restart the MCP client.`
+        : `Version mismatch: this server is ${server} but the editor runs an EngineWire plugin that predates version reporting, so actions and parameters can differ. Fix: ${install}.`;
 }
 export const bridgeErrorSchema = z.looseObject({
     type: z.literal('bridge_error'),