unreal-engine-mcp-server 0.4.7 → 0.5.1

package/tests/test-behavior-tree.mjs

@@ -0,0 +1,444 @@
+#!/usr/bin/env node
+/**
+ * Comprehensive Behavior Tree Test Suite
+ * Tool: manage_behavior_tree
+ * Coverage: All 6 actions with success, error, and edge cases
+ */
+
+import { runToolTests } from './test-runner.mjs';
+
+const btPath = '/Game/AI/BT_TestTree';
+
+const testCases = [
+  // === PRE-CLEANUP ===
+  {
+    scenario: 'Pre-cleanup: Delete existing BT',
+    toolName: 'manage_asset',
+    arguments: { action: 'delete', assetPaths: [btPath] },
+    expected: 'success|not_found'
+  },
+
+  // === CREATE ===
+  {
+    scenario: 'Create Behavior Tree',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'create',
+      name: 'BT_TestTree',
+      savePath: '/Game/AI'
+    },
+    expected: 'success'
+  },
+
+  // === ADD NODES (add_node) ===
+  {
+    scenario: 'Add Root Selector Node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Selector',
+      nodeId: 'RootSelector',
+      x: 0,
+      y: 0
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add Sequence Node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Sequence',
+      nodeId: 'MainSequence',
+      x: -200,
+      y: 150
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add Task Node (Wait)',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Task',
+      nodeId: 'WaitTask',
+      x: -300,
+      y: 300,
+      comment: 'Wait 5 seconds'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add Decorator Node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Decorator',
+      nodeId: 'BBDecorator',
+      parentNodeId: 'MainSequence',
+      x: -400,
+      y: 200
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add Service Node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Service',
+      nodeId: 'FocusService',
+      parentNodeId: 'RootSelector',
+      x: 100,
+      y: 100
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add SimpleParallel Node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'SimpleParallel',
+      nodeId: 'ParallelNode',
+      x: 200,
+      y: 150
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add MoveTo Task',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Task',
+      nodeId: 'MoveToTask',
+      x: 200,
+      y: 300
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Add FinishWithResult Task',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Task',
+      nodeId: 'FinishTask',
+      x: 300,
+      y: 300
+    },
+    expected: 'success'
+  },
+
+  // === CONNECT NODES (connect_nodes) ===
+  {
+    scenario: 'Connect Root to Sequence',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'RootSelector',
+      childNodeId: 'MainSequence'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Connect Sequence to WaitTask',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'MainSequence',
+      childNodeId: 'WaitTask'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Connect Root to Parallel',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'RootSelector',
+      childNodeId: 'ParallelNode'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Connect Parallel to MoveTo',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'ParallelNode',
+      childNodeId: 'MoveToTask'
+    },
+    expected: 'success'
+  },
+
+  // === SET NODE PROPERTIES (set_node_properties) ===
+  {
+    scenario: 'Set WaitTask property (WaitTime)',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'WaitTask',
+      properties: { WaitTime: 5.0 }
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Set Decorator property (BlackboardKey)',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'BBDecorator',
+      properties: { BlackboardKey: 'TargetActor' }
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Set RootSelector comment',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'RootSelector',
+      comment: 'Main Entry Point'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Set multiple properties',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'MoveToTask',
+      properties: { AcceptableRadius: 50.0, bStopOnOverlap: true }
+    },
+    expected: 'success'
+  },
+
+  // === BREAK CONNECTIONS (break_connections) ===
+  {
+    scenario: 'Break Root to Sequence connection',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'break_connections',
+      assetPath: btPath,
+      parentNodeId: 'RootSelector',
+      childNodeId: 'MainSequence'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Reconnect Root to Sequence',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'RootSelector',
+      childNodeId: 'MainSequence'
+    },
+    expected: 'success'
+  },
+
+  // === REMOVE NODES (remove_node) ===
+  {
+    scenario: 'Remove FinishTask',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'remove_node',
+      assetPath: btPath,
+      nodeId: 'FinishTask'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Remove FocusService',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'remove_node',
+      assetPath: btPath,
+      nodeId: 'FocusService'
+    },
+    expected: 'success'
+  },
+
+  // === REAL-WORLD SCENARIO: AI Patrol Tree ===
+  {
+    scenario: 'Patrol - Create Second BT',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'create',
+      name: 'BT_Patrol',
+      savePath: '/Game/AI'
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Patrol - Add Root',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: '/Game/AI/BT_Patrol',
+      nodeType: 'Sequence',
+      nodeId: 'PatrolRoot',
+      x: 0,
+      y: 0
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Patrol - Add MoveToPatrol',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: '/Game/AI/BT_Patrol',
+      nodeType: 'Task',
+      nodeId: 'MoveToPatrol',
+      x: 0,
+      y: 150
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Patrol - Add Wait',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: '/Game/AI/BT_Patrol',
+      nodeType: 'Task',
+      nodeId: 'WaitAtPatrol',
+      x: 100,
+      y: 150
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Patrol - Connect nodes',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: '/Game/AI/BT_Patrol',
+      parentNodeId: 'PatrolRoot',
+      childNodeId: 'MoveToPatrol'
+    },
+    expected: 'success'
+  },
+
+  // === ERROR CASES ===
+  {
+    scenario: 'Error: Add invalid node type',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'InvalidType'
+    },
+    expected: 'error'
+  },
+  {
+    scenario: 'Error: Connect cycle',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'MoveToTask',
+      childNodeId: 'RootSelector'
+    },
+    expected: 'error'
+  },
+  {
+    scenario: 'Error: Set property on invalid node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'NonExistentNode',
+      properties: { Val: 1 }
+    },
+    expected: 'error|not_found'
+  },
+  {
+    scenario: 'Error: Remove non-existent node',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'remove_node',
+      assetPath: btPath,
+      nodeId: 'GhostNode'
+    },
+    expected: 'error|not_found'
+  },
+  {
+    scenario: 'Error: Connect to non-existent parent',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'connect_nodes',
+      assetPath: btPath,
+      parentNodeId: 'NonExistentParent',
+      childNodeId: 'WaitTask'
+    },
+    expected: 'error|not_found'
+  },
+  {
+    scenario: 'Error: Create without name',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'create',
+      savePath: '/Game/AI'
+    },
+    expected: 'error|missing'
+  },
+
+  // === EDGE CASES ===
+  {
+    scenario: 'Edge: Negative coordinates',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'add_node',
+      assetPath: btPath,
+      nodeType: 'Selector',
+      nodeId: 'NegPosNode',
+      x: -1000,
+      y: -1000
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Edge: Empty properties object',
+    toolName: 'manage_behavior_tree',
+    arguments: {
+      action: 'set_node_properties',
+      assetPath: btPath,
+      nodeId: 'RootSelector',
+      properties: {}
+    },
+    expected: 'success'
+  },
+
+  // === CLEANUP ===
+  {
+    scenario: 'Cleanup: Delete test BT assets',
+    toolName: 'manage_asset',
+    arguments: {
+      action: 'delete',
+      assetPaths: [btPath, '/Game/AI/BT_Patrol']
+    },
+    expected: 'success'
+  }
+];
+
+await runToolTests('Behavior Tree', testCases);