unreal-engine-mcp-server 0.3.0 → 0.3.1

package/dist/tools/tool-definitions.js

@@ -563,7 +563,7 @@ Example:
         description: `Stream in/out a sublevel and set visibility.
 
 Example:
-- {'levelName':'Sublevel_A','shouldBeLoaded':true,'shouldBeVisible':true}`,
+- {"levelName":"Sublevel_A","shouldBeLoaded":true,"shouldBeVisible":true}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -589,8 +589,8 @@ Example:
         description: `Create a light (Directional/Point/Spot/Rect/Sky) with optional transform/intensity.
 
 Examples:
-- {'lightType':'Directional','name':'KeyLight','intensity':5.0}
-- {'lightType':'Point','name':'Fill','location':{'x':0,'y':100,'z':200},'intensity':2000}`,
+- {"lightType":"Directional","name":"KeyLight","intensity":5.0}
+- {"lightType":"Point","name":"Fill","location":{"x":0,"y":100,"z":200},"intensity":2000}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -619,7 +619,13 @@ Examples:
     },
     {
         name: 'build_lighting',
-        description: 'Start a lighting build at an optional quality level (Preview/Medium/High/Production).',
+        description: `Start a lighting build.
+
+When to use:
+- Bake lights for preview or final output (choose quality).
+
+Example:
+- {"quality":"High"}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -638,7 +644,13 @@ Examples:
     // Landscape Tools
     {
         name: 'create_landscape',
-        description: 'Attempt to create a landscape. Native Python APIs are limited; you may receive a guidance message to use Landscape Mode in the editor.',
+        description: `Attempt to create a landscape.
+
+Notes:
+- Native Python APIs are limited; you may be guided to use Landscape Mode in the editor.
+
+Example:
+- {"name":"Landscape_Basic","sizeX":1024,"sizeY":1024}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -660,7 +672,10 @@ Examples:
     },
     {
         name: 'sculpt_landscape',
-        description: 'Sculpt a landscape using editor tools (best-effort; some operations may require manual Landscape Mode).',
+        description: `Sculpt a landscape using editor tools (best-effort; some operations may require manual Landscape Mode).
+
+Example:
+- {"landscapeName":"Landscape_Basic","tool":"Smooth","brushSize":300,"strength":0.5}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -685,7 +700,7 @@ Examples:
         description: `Create or load a FoliageType asset for instanced foliage workflows.
 
 Example:
-- {'name':'FT_Grass','meshPath':'/Game/Foliage/SM_Grass','density':300}`,
+- {"name":"FT_Grass","meshPath":"/Game/Foliage/SM_Grass","density":300}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -706,7 +721,13 @@ Example:
     },
     {
         name: 'paint_foliage',
-        description: 'Paint foliage on landscape',
+        description: `Paint foliage onto the world.
+
+When to use:
+- Scatter instances using an existing FoliageType.
+
+Example:
+- {"foliageType":"/Game/Foliage/Types/FT_Grass","position":{"x":0,"y":0,"z":0},"brushSize":300}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -735,7 +756,10 @@ Example:
     // Debug Visualization Tools
     {
         name: 'draw_debug_shape',
-        description: 'Draw a debug shape',
+        description: `Draw a debug shape.
+
+Example:
+- {"shape":"Sphere","position":{"x":0,"y":0,"z":0},"size":100,"color":[255,0,0,255],"duration":3}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -768,7 +792,10 @@ Example:
     },
     {
         name: 'set_view_mode',
-        description: 'Set the viewport view mode',
+        description: `Set the viewport view mode.
+
+Example:
+- {"mode":"Wireframe"}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -788,7 +815,10 @@ Example:
     // Performance Tools
     {
         name: 'start_profiling',
-        description: 'Start performance profiling',
+        description: `Start performance profiling.
+
+Example:
+- {"type":"GPU","duration":10}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -808,7 +838,10 @@ Example:
     },
     {
         name: 'show_fps',
-        description: 'Show FPS counter',
+        description: `Show/hide the FPS counter.
+
+Example:
+- {"enabled":true,"verbose":false}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -828,7 +861,10 @@ Example:
     },
     {
         name: 'set_scalability',
-        description: 'Set scalability settings',
+        description: `Set scalability/quality levels.
+
+Example:
+- {"category":"Shadows","level":2}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -849,7 +885,10 @@ Example:
     // Audio Tools
     {
         name: 'play_sound',
-        description: 'Play a sound',
+        description: `Play a sound.
+
+Example:
+- {"soundPath":"/Game/Audio/SFX/Click","volume":0.5,"is3D":true}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -878,7 +917,10 @@ Example:
     },
     {
         name: 'create_ambient_sound',
-        description: 'Create an ambient sound',
+        description: `Create an ambient sound actor.
+
+Example:
+- {"name":"Amb_Wind","soundPath":"/Game/Audio/Amb/AMB_Wind","location":{"x":0,"y":0,"z":0},"radius":1000}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -908,7 +950,10 @@ Example:
     // UI Tools
     {
         name: 'create_widget',
-        description: 'Create a UI widget',
+        description: `Create a UI widget.
+
+Example:
+- {"name":"HUDMain","type":"HUD","savePath":"/Game/UI"}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -929,7 +974,10 @@ Example:
     },
     {
         name: 'show_widget',
-        description: 'Show or hide a widget',
+        description: `Show or hide a widget.
+
+Example:
+- {"widgetName":"HUDMain","visible":true}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -949,7 +997,10 @@ Example:
     },
     {
         name: 'create_hud',
-        description: 'Create a HUD',
+        description: `Create a HUD description/layout.
+
+Example:
+- {"name":"GameHUD","elements":[{"type":"Text","position":[10,10]}]}`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -982,7 +1033,14 @@ Example:
     // Console command (universal tool)
     {
         name: 'console_command',
-        description: 'Execute any console command in Unreal Engine',
+        description: `Execute a console command.
+
+When to use:
+- Quick toggles like "stat fps", "viewmode wireframe", or r.* cvars.
+
+Examples:
+- {"command":"stat fps"}
+- {"command":"r.ScreenPercentage 75"}`,
         inputSchema: {
             type: 'object',
             properties: {

package/dist/unreal-bridge.d.ts

@@ -14,6 +14,7 @@ export declare class UnrealBridge {
     private reconnectAttempts;
     private readonly MAX_RECONNECT_ATTEMPTS;
     private readonly BASE_RECONNECT_DELAY;
+    private autoReconnectEnabled;
     private commandQueue;
     private isProcessing;
     private readonly MIN_COMMAND_DELAY;
@@ -32,6 +33,7 @@ export declare class UnrealBridge {
      * @param retryDelayMs Delay between retry attempts in milliseconds
      * @returns Promise that resolves when connected or rejects after all attempts fail
      */
+    private connectPromise?;
     tryConnect(maxAttempts?: number, timeoutMs?: number, retryDelayMs?: number): Promise<boolean>;
     connect(timeoutMs?: number): Promise<void>;
     httpCall<T = any>(path: string, method?: 'GET' | 'POST' | 'PUT', body?: any): Promise<T>;
@@ -39,6 +41,7 @@ export declare class UnrealBridge {
     getExposed(): Promise<any>;
     executeConsoleCommand(command: string): Promise<any>;
     executePython(command: string): Promise<any>;
+    setAutoReconnectEnabled(enabled: boolean): void;
     private scheduleReconnect;
     disconnect(): Promise<void>;
     /**
@@ -49,7 +52,7 @@ export declare class UnrealBridge {
     /**
      * Execute Python script and parse the result
      */
-    private executePythonWithResult;
+    executePythonWithResult(script: string): Promise<any>;
     /**
      * Get the Unreal Engine version via Python and parse major/minor/patch.
      */