unreal-engine-mcp-server 0.5.19 → 0.5.21

package/CHANGELOG.md

@@ -7,6 +7,138 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [Unreleased]
+
+### Added
+- `MCP_ADDITIONAL_PATH_PREFIXES` environment variable to whitelist custom UE content mount points (plugins with `CanContainContent`). Default is empty (no change to existing behavior). Enables projects with modular plugin architecture to access Blueprint assets at custom mount points like `/ProjectObject/`, `/ProjectAnimation/`, etc.
+
+---
+
+## 🏷️ [0.5.20] - 2026-03-21
+
+> [!IMPORTANT]
+> ### 🛡️ Security Fix & UE 5.0 Compatibility
+> This release includes a critical path traversal fix in export_asset, UE 5.0 compatibility improvements, and external actors support for World Partition.
+
+### 🛡️ Security
+
+<details>
+<summary><b>🔒 Path Traversal in export_asset</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/5cf2a3c">5cf2a3c</a>)</summary>
+
+| Aspect | Details |
+|--------|---------|
+| **Severity** | 🚨 CRITICAL |
+| **Vulnerability** | Path traversal in `export_asset` action |
+| **Fix** | Added path validation to prevent directory traversal attacks |
+
+**Files Modified:**
+- `McpAutomationBridge_SystemControlHandlers.cpp`
+
+</details>
+
+### ✨ Added
+
+<details>
+<summary><b>🌍 External Actors Support</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/51143c3">51143c3</a>)</summary>
+
+| Feature | Description |
+|---------|-------------|
+| **External Actors** | Support for World Partition external actors in level structure handlers |
+| **Streaming Reference** | Streaming reference creation for external actor packages |
+
+**Files Modified:**
+- `McpAutomationBridge_LevelStructureHandlers.cpp` (+127 lines)
+
+</details>
+
+### 🛠️ Fixed
+
+<details>
+<summary><b>🎮 UE 5.0 Compatibility</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/1057023">1057023</a>)</summary>
+
+| Bug | Fix |
+|-----|-----|
+| `bIsWorldInitialized` API not available in UE 5.0 | Direct access to `bIsWorldInitialized` for UE 5.0 compatibility |
+
+**Files Modified:**
+- `McpAutomationBridgeHelpers.h`
+- `McpAutomationBridge_LevelStructureHandlers.cpp`
+
+</details>
+
+<details>
+<summary><b>🐛 Tick Task Manager Crashes</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/8c311d7">8c311d7</a>)</summary>
+
+| Bug | Fix |
+|-----|-----|
+| Crashes from tick task manager during world operations | Added safety checks and proper cleanup in world management |
+| World cleanup issues | Enhanced cleanup with `FlushRenderingCommands` safety |
+
+**Files Modified:**
+- `McpAutomationBridgeHelpers.h` (+36 lines)
+- `McpAutomationBridge_LevelStructureHandlers.cpp` (+65 lines)
+- `McpSafeOperations.h` (+16 lines)
+
+</details>
+
+<details>
+<summary><b>🐛 Sublevel Creation</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/bffb68c">bffb68c</a>)</summary>
+
+| Bug | Fix |
+|-----|-----|
+| Sublevel creation path handling issues | Enhanced sublevel creation process with proper path handling |
+
+**Files Modified:**
+- `McpAutomationBridge_LevelStructureHandlers.cpp` (+201 lines)
+
+</details>
+
+<details>
+<summary><b>🔧 UE 5.7 Build</b> (<a href="https://github.com/ChiR24/Unreal_mcp/pull/295">#295</a>)</summary>
+
+| Bug | Fix |
+|-----|-----|
+| Missing includes causing build failures on UE 5.7 | Added missing includes in `McpHandlerUtils.cpp` and `McpPropertyReflection.cpp` |
+
+**Contributors:** @a2448825647
+
+</details>
+
+### 🔄 Dependencies
+
+<details>
+<summary><b>GitHub Actions Updates</b></summary>
+
+| Package | From | To | PR |
+|---------|------|-----|-----|
+| `release-drafter/release-drafter` | 7.0.0 | 7.1.1 | [#300](https://github.com/ChiR24/Unreal_mcp/pull/300) |
+| `softprops/action-gh-release` | 2.5.3 | 2.6.1 | [#301](https://github.com/ChiR24/Unreal_mcp/pull/301) |
+| `github/codeql-action` | 4.32.6 | 4.33.0 | [#299](https://github.com/ChiR24/Unreal_mcp/pull/299) |
+
+</details>
+
+<details>
+<summary><b>NPM Package Updates</b></summary>
+
+| Package | From | To | PR |
+|---------|------|-----|-----|
+| `flatted` | 3.3.3 | 3.4.2 | [#304](https://github.com/ChiR24/Unreal_mcp/pull/304) |
+
+</details>
+
+### 🔌 Plugin
+
+<details>
+<summary><b>MCP Automation Bridge v0.1.3</b></summary>
+
+Updated plugin version to 0.1.3 with all fixes and features from this release.
+
+See [Plugin CHANGELOG](Plugins/McpAutomationBridge/CHANGELOG.md) for details.
+
+</details>
+
+---
+
 ## 🏷️ [0.5.19] - 2026-03-18
 
 > [!IMPORTANT]

package/README.md

@@ -202,6 +202,10 @@ LOG_LEVEL=info  # debug | info | warn | error
 # Optional
 MCP_AUTOMATION_REQUEST_TIMEOUT_MS=120000
 ASSET_LIST_TTL_MS=10000
+
+# Custom content mount points (comma-separated)
+# Plugins with CanContainContent register mount points beyond /Game/.
+# MCP_ADDITIONAL_PATH_PREFIXES=/ProjectObject/,/ProjectAnimation/
 ```
 
 ### LAN Access Configuration
@@ -325,6 +329,7 @@ Blueprints • Materials • Textures • Static Meshes • Skeletal Meshes •
 
 ---
 
+## GraphQL API
 
 Optional GraphQL endpoint for complex queries. **Disabled by default.**
 

package/dist/config.d.ts

@@ -20,8 +20,10 @@ export declare const EnvSchema: z.ZodObject<{
     MCP_CONNECTION_TIMEOUT_MS: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodDefault<z.ZodNumber>>;
     MCP_REQUEST_TIMEOUT_MS: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodDefault<z.ZodNumber>>;
     MCP_DEFAULT_CATEGORIES: z.ZodDefault<z.ZodString>;
+    MCP_ADDITIONAL_PATH_PREFIXES: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 export type Config = z.infer<typeof EnvSchema>;
 declare let config: Config;
 export { config };
+export declare function getAdditionalPathPrefixes(): string[];
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;iBAsBpB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,QAAA,IAAI,MAAM,EAAE,MAAM,CAAC;AAgBnB,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;iBA2BpB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,QAAA,IAAI,MAAM,EAAE,MAAM,CAAC;AAgBnB,OAAO,EAAE,MAAM,EAAE,CAAC;AAOlB,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAcpD"}

package/dist/config.js

@@ -40,6 +40,7 @@ export const EnvSchema = z.object({
     MCP_CONNECTION_TIMEOUT_MS: z.preprocess((v) => stringToNumber(v, 5000), z.number().default(5000)),
     MCP_REQUEST_TIMEOUT_MS: z.preprocess((v) => stringToNumber(v, 30000), z.number().default(30000)),
     MCP_DEFAULT_CATEGORIES: z.string().default('core'),
+    MCP_ADDITIONAL_PATH_PREFIXES: z.string().default(''),
 });
 let config;
 try {
@@ -57,4 +58,22 @@ catch (error) {
     }
 }
 export { config };
+export function getAdditionalPathPrefixes() {
+    const raw = config.MCP_ADDITIONAL_PATH_PREFIXES;
+    if (!raw || raw.trim() === '')
+        return [];
+    return raw
+        .split(',')
+        .map(s => s.trim())
+        .filter(s => s.length > 0)
+        .map(s => {
+        let p = s.startsWith('/') ? s : `/${s}`;
+        if (!p.endsWith('/'))
+            p += '/';
+        if (p === '/' || p.includes('..') || p.includes('//'))
+            return '';
+        return p;
+    })
+        .filter(s => s.length > 0);
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -28,7 +28,7 @@ const DEFAULT_SERVER_NAME = typeof packageInfo.name === 'string' && packageInfo.
     : 'unreal-engine-mcp';
 const DEFAULT_SERVER_VERSION = typeof packageInfo.version === 'string' && packageInfo.version.trim().length > 0
     ? packageInfo.version
-    : '0.5.19';
+    : '0.5.21';
 function routeStdoutLogsToStderr() {
     if (!config.MCP_ROUTE_STDOUT_LOGS) {
         return;

package/dist/tools/consolidated-tool-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidated-tool-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/consolidated-tool-definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,2BAA2B,EAAE,cAAc,EAolJvD,CAAC"}
+{"version":3,"file":"consolidated-tool-definitions.d.ts","sourceRoot":"","sources":["../../src/tools/consolidated-tool-definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,2BAA2B,EAAE,cAAc,EAylJvD,CAAC"}

package/dist/tools/consolidated-tool-definitions.js

@@ -37,7 +37,7 @@ export const consolidatedToolDefinitions = [
                     description: 'list_tools: show all tools with status. list_categories: show categories. enable/disable_tools: toggle specific tools. enable/disable_category: toggle category. get_status: current state. reset: restore defaults.'
                 },
                 tools: { type: 'array', items: commonSchemas.stringProp, description: 'Tool names to enable/disable' },
-                category: { type: 'string', description: 'Category name to enable/disable (core, world, authoring, gameplay, utility)' }
+                category: { type: 'string', description: 'Category name to enable/disable (core, world, authoring, gameplay, utility, all)' }
             },
             required: ['action']
         },
@@ -77,6 +77,7 @@ export const consolidatedToolDefinitions = [
                 recursivePaths: commonSchemas.booleanProp,
                 recursiveClasses: commonSchemas.booleanProp,
                 limit: commonSchemas.numberProp,
+                offset: commonSchemas.numberProp,
                 sourcePath: commonSchemas.sourcePath,
                 destinationPath: commonSchemas.destinationPath,
                 assetPaths: commonSchemas.arrayOfStrings,
@@ -156,7 +157,10 @@ export const consolidatedToolDefinitions = [
                 paths: commonSchemas.arrayOfStrings,
                 path: commonSchemas.stringProp,
                 nodeId: commonSchemas.nodeId,
-                details: commonSchemas.objectProp
+                details: commonSchemas.objectProp,
+                totalCount: commonSchemas.numberProp,
+                offset: commonSchemas.numberProp,
+                limit: commonSchemas.numberProp
             }
         }
     },
@@ -3785,7 +3789,7 @@ export const consolidatedToolDefinitions = [
     {
         name: 'manage_sessions',
         category: 'utility',
-        description: 'Configure local multiplayer: split-screen layouts, LAN hosting/joining, voice chat channels, and push-to-talk.',
+        description: 'Configure local multiplayer: split-screen layouts, LAN hosting/joining, voice chat channels, and push-to-talk.\n\nRequired parameters by action:\n- configure_local_session_settings: At least one setting param required\n- configure_session_interface: interfaceType\n- configure_split_screen: enabled or splitScreenType\n- set_split_screen_type: splitScreenType\n- add_local_player: controllerId (requires PIE)\n- remove_local_player: playerIndex (requires PIE)\n- configure_lan_play: enabled, serverPort, or serverPassword\n- host_lan_server: mapName (requires PIE)\n- join_lan_server: serverAddress (requires PIE)\n- enable_voice_chat: voiceEnabled\n- configure_voice_settings: voiceSettings\n- set_voice_channel: channelName\n- mute_player: playerName or targetPlayerId\n- set_voice_attenuation: attenuationRadius\n- configure_push_to_talk: pushToTalkEnabled\n- get_sessions_info: No additional params required',
         inputSchema: {
             type: 'object',
             properties: {
@@ -3813,23 +3817,23 @@ export const consolidatedToolDefinitions = [
                 interfaceType: {
                     type: 'string',
                     enum: ['Default', 'LAN', 'Null'],
-                    description: 'Type of session interface to use.'
+                    description: 'Type of session interface to use. REQUIRED for configure_session_interface.'
                 },
                 enabled: commonSchemas.enabled,
                 splitScreenType: {
                     type: 'string',
                     enum: ['None', 'TwoPlayer_Horizontal', 'TwoPlayer_Vertical', 'ThreePlayer_FavorTop', 'ThreePlayer_FavorBottom', 'FourPlayer_Grid'],
-                    description: 'Split-screen layout type.'
+                    description: 'Split-screen layout type. REQUIRED for set_split_screen_type.'
                 },
-                playerIndex: commonSchemas.numberProp,
-                controllerId: commonSchemas.numberProp,
-                serverAddress: commonSchemas.serverAddress,
+                playerIndex: { ...commonSchemas.numberProp, description: 'Local player index. REQUIRED for remove_local_player.' },
+                controllerId: { ...commonSchemas.numberProp, description: 'Controller ID for player input. REQUIRED for add_local_player.' },
+                serverAddress: { ...commonSchemas.serverAddress, description: 'Server IP address. REQUIRED for join_lan_server.' },
                 serverPort: commonSchemas.numberProp,
                 serverPassword: { type: 'string', description: 'Server password for protected games.' },
                 serverName: { type: 'string', description: 'Display name for the server.' },
-                mapName: { type: 'string', description: 'Map to load for hosting.' },
+                mapName: { type: 'string', description: 'Map to load for hosting. REQUIRED for host_lan_server.' },
                 travelOptions: { type: 'string', description: 'Travel URL options string.' },
-                voiceEnabled: { type: 'boolean', description: 'Enable/disable voice chat.' },
+                voiceEnabled: { type: 'boolean', description: 'Enable/disable voice chat. REQUIRED for enable_voice_chat.' },
                 voiceSettings: {
                     type: 'object',
                     properties: {
@@ -3839,20 +3843,20 @@ export const consolidatedToolDefinitions = [
                         echoCancellation: { type: 'boolean', description: 'Enable echo cancellation.' },
                         sampleRate: { type: 'number', description: 'Audio sample rate in Hz.' }
                     },
-                    description: 'Voice processing settings.'
+                    description: 'Voice processing settings. REQUIRED for configure_voice_settings.'
                 },
-                channelName: commonSchemas.channelName,
+                channelName: { ...commonSchemas.channelName, description: 'Voice channel name. REQUIRED for set_voice_channel.' },
                 channelType: {
                     type: 'string',
                     enum: ['Team', 'Global', 'Proximity', 'Party'],
                     description: 'Voice channel type.'
                 },
-                playerName: { type: 'string', description: 'Player name for voice operations.' },
-                targetPlayerId: { type: 'string', description: 'Target player ID.' },
+                playerName: { type: 'string', description: 'Player name for voice operations. REQUIRED for mute_player (or targetPlayerId).' },
+                targetPlayerId: { type: 'string', description: 'Target player ID. REQUIRED for mute_player (or playerName).' },
                 muted: commonSchemas.muted,
-                attenuationRadius: { type: 'number', description: 'Radius for voice attenuation (Proximity chat).' },
+                attenuationRadius: { type: 'number', description: 'Radius for voice attenuation (Proximity chat). REQUIRED for set_voice_attenuation.' },
                 attenuationFalloff: { type: 'number', description: 'Falloff rate for voice attenuation.' },
-                pushToTalkEnabled: { type: 'boolean', description: 'Enable push-to-talk mode.' },
+                pushToTalkEnabled: { type: 'boolean', description: 'Enable push-to-talk mode. REQUIRED for configure_push_to_talk.' },
                 pushToTalkKey: { type: 'string', description: 'Key binding for push-to-talk.' }
             },
             required: ['action']
@@ -3916,6 +3920,7 @@ export const consolidatedToolDefinitions = [
                 parentLevel: commonSchemas.parentLevel,
                 templateLevel: commonSchemas.templateLevel,
                 bCreateWorldPartition: { type: 'boolean', description: 'Create with World Partition enabled.' },
+                bUseExternalActors: { type: 'boolean', description: 'Enable One File Per Actor (OFPA/External Actors) for Data Layer compatibility. Automatically enabled when bCreateWorldPartition is true.' },
                 sublevelName: commonSchemas.sublevelName,
                 sublevelPath: commonSchemas.levelPath,
                 streamingMethod: {