unreal-engine-mcp-server 0.5.0 → 0.5.1

package/tests/test-animation.mjs

@@ -1,44 +1,369 @@
 #!/usr/bin/env node
 /**
- * Condensed Animation & Physics Test Suite (15 cases) — safe operations.
+ * Comprehensive Animation & Physics Test Suite
  * Tool: animation_physics
+ * Coverage: All 15 actions with success, error, and edge cases
  */
 
 import { runToolTests } from './test-runner.mjs';
 
+// Use the tutorial skeleton that comes with UE
+const tutorialSkeleton = '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton';
+
 const testCases = [
-  { scenario: 'Create simple animation blueprint (best-effort)', toolName: 'animation_physics', arguments: { action: 'create_animation_bp', name: 'ABP_TC', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', savePath: '/Game/Animations' }, expected: 'success or not found' },
-  { scenario: 'Play montage (no-op safe)', toolName: 'animation_physics', arguments: { action: 'play_montage', actorName: 'SkeletalCharacter', montagePath: '/Game/Animations/AM_Test', playRate: 1.0 }, expected: 'success or not found' },
-  { scenario: 'Setup ragdoll (best-effort)', toolName: 'animation_physics', arguments: { action: 'setup_ragdoll', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', actorName: 'RagdollCharacter', physicsAssetName: 'PA_Mannequin', blendWeight: 1.0 }, expected: 'success or not found' },
-  { scenario: 'Create blend space (safe)', toolName: 'animation_physics', arguments: { action: 'create_blend_space', name: 'TC_Locomotion', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', horizontalAxis: { name: 'Speed', minValue: 0, maxValue: 100 }, verticalAxis: { name: 'Direction', minValue: -180, maxValue: 180 }, animations: [] }, expected: 'success - blend space created' },
-  { scenario: 'Create state machine skeleton', toolName: 'animation_physics', arguments: { action: 'create_state_machine', machineName: 'TC_States', states: [{ name: 'Idle' }, { name: 'Run' }], transitions: [] }, expected: 'success' },
-  { scenario: 'Create simple IK setup', toolName: 'animation_physics', arguments: { action: 'setup_ik', actorName: 'Character', chain: { rootBone: 'pelvis', endBone: 'foot_l' }, effector: { targetActor: 'TargetActor' } }, expected: 'success' },
-  { scenario: 'Create procedural animation', toolName: 'animation_physics', arguments: { action: 'create_procedural_anim', systemName: 'TC_Procedural', baseAnimation: '/Game/Animations/BasePose', settings: {} }, expected: 'success' },
-  { scenario: 'Create animation blueprint minimal', toolName: 'animation_physics', arguments: { action: 'create_animation_bp', blueprintName: 'TC_AnimBP', parentClass: 'AnimInstance', targetSkeleton: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', stateMachines: [] }, expected: 'success or not found' },
-  // { scenario: 'Activate ragdoll trigger (no-op)', toolName: 'animation_physics', arguments: { action: 'activate_ragdoll', actorName: 'Character', blendTime: 0.2 }, expected: 'success' },
-  { scenario: 'Create blend tree', toolName: 'animation_physics', arguments: { action: 'create_blend_tree', treeName: 'TC_UpperBody', basePose: '/Game/Animations/BasePose', additiveAnimations: [] }, expected: 'success' },
-  { scenario: 'Create simple animation asset', toolName: 'animation_physics', arguments: { action: 'create_animation_asset', name: 'ANIM_TC', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', savePath: '/Game/Animations', assetType: 'sequence' }, expected: 'success or not found' },
-
-  // PRE-CLEANUP: Ensure target doesn't exist to avoid "DuplicateAsset failed"
-  { scenario: 'Pre-cleanup Retargeted asset', toolName: 'manage_asset', arguments: { action: 'delete_asset', assetPath: '/Game/Animations/Retargeted/ANIM_TC_Retargeted' }, expected: 'success|not_found|error' },
-
-  { scenario: 'Retargeting sequence (best-effort)', toolName: 'animation_physics', arguments: { action: 'setup_retargeting', sourceSkeleton: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', targetSkeleton: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', assets: ['/Game/Animations/ANIM_TC'], savePath: '/Game/Animations/Retargeted', overwrite: true }, expected: 'success or not connected or not found' },
-  { scenario: 'Setup physics simulation (best-effort)', toolName: 'animation_physics', arguments: { action: 'setup_physics_simulation', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', savePath: '/Game/Physics', physicsAssetName: 'PA_TC', assignToMesh: false }, expected: 'success or not found' },
-  { scenario: 'Play and stop a short montage (best-effort)', toolName: 'animation_physics', arguments: { action: 'play_montage', actorName: 'SkeletalCharacter', montagePath: '/Game/Animations/AM_Test', playRate: 1.0 }, expected: 'success or not found' },
-
-  { scenario: 'Anim Setup - Create Montage', toolName: 'animation_physics', arguments: { action: 'create_animation_asset', name: 'AM_Setup', skeletonPath: '/Engine/Tutorial/SubEditors/TutorialAssets/Character/TutorialTPP_Skeleton', savePath: '/Game/Animations', assetType: 'montage' }, expected: 'success or not found' },
-  { scenario: 'Anim Setup - Add Notify', toolName: 'animation_physics', arguments: { action: 'add_notify', assetPath: '/Game/Animations/AM_Setup', notifyName: 'AnimNotify_PlaySound', time: 0.5 }, expected: 'success or not found or AUTOMATION_BRIDGE_UNAVAILABLE' },
-
-  // Edge cases
-  { scenario: 'Error: Invalid skeleton path', toolName: 'animation_physics', arguments: { action: 'create_animation_asset', assetName: 'InvalidAnim', skeletonPath: '/Game/Invalid/Skeleton' }, expected: 'error|asset_not_found' },
-  { scenario: 'Edge: Play rate 0 (pause)', toolName: 'animation_physics', arguments: { action: 'play_montage', actorName: 'SkeletalCharacter', montagePath: '/Game/Animations/AM_Setup', playRate: 0 }, expected: 'success|no_op' },
-  { scenario: 'Border: Negative RPM vehicle', toolName: 'animation_physics', arguments: { action: 'configure_vehicle', vehicleName: 'TestVehicle', maxRPM: -1000 }, expected: 'success|clamped' },
-  { scenario: 'Error: Empty wheels array', toolName: 'animation_physics', arguments: { action: 'configure_vehicle', vehicleName: 'TestVehicle', wheels: [] }, expected: 'success|default_wheels' },
-  { scenario: 'Edge: No plugin deps', toolName: 'animation_physics', arguments: { action: 'configure_vehicle', vehicleName: 'TestVehicle', plugins: ['InvalidPlugin'] }, expected: 'error|plugin_missing|MISSING_ENGINE_PLUGINS' },
-
-  // FINAL CLEANUP
-  { scenario: 'Cleanup all animation artifacts', toolName: 'animation_physics', arguments: { action: 'cleanup', artifacts: ['ABP_TC', 'TC_AnimBP', 'ANIM_TC', 'AM_Setup', 'TC_Locomotion', 'PA_TC', 'TC_States', 'TC_UpperBody'] }, expected: 'success or no matching' },
-  { scenario: 'Cleanup retargeted asset', toolName: 'manage_asset', arguments: { action: 'delete_asset', assetPath: '/Game/Animations/Retargeted/ANIM_TC_Retargeted' }, expected: 'success|not_found' }
+  // === PRE-CLEANUP ===
+  {
+    scenario: 'Pre-cleanup animation artifacts',
+    toolName: 'animation_physics',
+    arguments: { action: 'cleanup', filter: 'TC_*' },
+    expected: 'success|no matching'
+  },
+
+  // === CREATE ANIMATION BLUEPRINT ===
+  {
+    scenario: 'Create Animation Blueprint',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_animation_bp',
+      name: 'TC_ABP_Character',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations'
+    },
+    expected: 'success or not found'
+  },
+  {
+    scenario: 'Create Animation Blueprint (minimal)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_animation_bp',
+      name: 'TC_ABP_Minimal',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations',
+      stateMachines: []
+    },
+    expected: 'success or not found'
+  },
+
+  // === CREATE ANIMATION ASSET ===
+  {
+    scenario: 'Create Animation Sequence',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_animation_asset',
+      name: 'TC_Anim_Sequence',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations',
+      assetType: 'sequence'
+    },
+    expected: 'success or not found'
+  },
+  {
+    scenario: 'Create Animation Montage',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_animation_asset',
+      name: 'TC_Anim_Montage',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations',
+      assetType: 'montage'
+    },
+    expected: 'success or not found'
+  },
+
+  // === ADD NOTIFY ===
+  {
+    scenario: 'Add Notify to Montage',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'add_notify',
+      assetPath: '/Game/Animations/TC_Anim_Montage',
+      notifyName: 'AnimNotify_PlaySound',
+      time: 0.5
+    },
+    expected: 'success or not found or AUTOMATION_BRIDGE_UNAVAILABLE'
+  },
+  {
+    scenario: 'Add Second Notify',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'add_notify',
+      assetPath: '/Game/Animations/TC_Anim_Montage',
+      notifyName: 'AnimNotify_PlayParticleEffect',
+      time: 1.0
+    },
+    expected: 'success or not found'
+  },
+
+  // === PLAY MONTAGE ===
+  {
+    scenario: 'Play Montage',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'play_montage',
+      actorName: 'SkeletalCharacter',
+      montagePath: '/Game/Animations/TC_Anim_Montage',
+      playRate: 1.0
+    },
+    expected: 'success or not found'
+  },
+  {
+    scenario: 'Play Montage (slow)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'play_montage',
+      actorName: 'SkeletalCharacter',
+      montagePath: '/Game/Animations/TC_Anim_Montage',
+      playRate: 0.5
+    },
+    expected: 'success or not found'
+  },
+
+  // === CREATE BLEND SPACE ===
+  {
+    scenario: 'Create Blend Space 1D',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_blend_space',
+      name: 'TC_BS_Locomotion',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations',
+      horizontalAxis: { name: 'Speed', minValue: 0, maxValue: 600 },
+      animations: []
+    },
+    expected: 'success - blend space created'
+  },
+  {
+    scenario: 'Create Blend Space 2D',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_blend_space',
+      name: 'TC_BS_Movement',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Animations',
+      horizontalAxis: { name: 'Speed', minValue: 0, maxValue: 600 },
+      verticalAxis: { name: 'Direction', minValue: -180, maxValue: 180 },
+      animations: []
+    },
+    expected: 'success'
+  },
+
+  // === CREATE STATE MACHINE ===
+  {
+    scenario: 'Create State Machine',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_state_machine',
+      machineName: 'TC_StateMachine',
+      states: [{ name: 'Idle' }, { name: 'Walk' }, { name: 'Run' }, { name: 'Jump' }],
+      transitions: []
+    },
+    expected: 'success'
+  },
+
+  // === CREATE BLEND TREE ===
+  {
+    scenario: 'Create Blend Tree',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_blend_tree',
+      treeName: 'TC_BlendTree',
+      basePose: '/Game/Animations/TC_Anim_Sequence',
+      additiveAnimations: []
+    },
+    expected: 'success'
+  },
+
+  // === SETUP IK ===
+  {
+    scenario: 'Setup IK (Foot)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'setup_ik',
+      actorName: 'Character',
+      chain: { rootBone: 'pelvis', endBone: 'foot_l' },
+      effector: { targetActor: 'TargetActor' }
+    },
+    expected: 'success'
+  },
+  {
+    scenario: 'Setup IK (Hand)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'setup_ik',
+      actorName: 'Character',
+      chain: { rootBone: 'spine_01', endBone: 'hand_r' },
+      effector: { targetActor: 'HandTarget' }
+    },
+    expected: 'success'
+  },
+
+  // === CREATE PROCEDURAL ANIM ===
+  {
+    scenario: 'Create Procedural Animation',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_procedural_anim',
+      systemName: 'TC_ProceduralAnim',
+      baseAnimation: '/Game/Animations/TC_Anim_Sequence',
+      settings: {}
+    },
+    expected: 'success'
+  },
+
+  // === RAGDOLL ===
+  {
+    scenario: 'Setup Ragdoll',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'setup_ragdoll',
+      skeletonPath: tutorialSkeleton,
+      actorName: 'RagdollCharacter',
+      physicsAssetName: 'TC_PhysicsAsset',
+      blendWeight: 1.0
+    },
+    expected: 'success or not found'
+  },
+  {
+    scenario: 'Activate Ragdoll',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'activate_ragdoll',
+      actorName: 'RagdollCharacter',
+      blendTime: 0.2
+    },
+    expected: 'success|not_found'
+  },
+
+  // === PHYSICS SIMULATION ===
+  {
+    scenario: 'Setup Physics Simulation',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'setup_physics_simulation',
+      skeletonPath: tutorialSkeleton,
+      savePath: '/Game/Physics',
+      physicsAssetName: 'TC_PhysAsset',
+      assignToMesh: false
+    },
+    expected: 'success or not found'
+  },
+
+  // === CONFIGURE VEHICLE ===
+  {
+    scenario: 'Configure Vehicle (4 wheels)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'configure_vehicle',
+      vehicleName: 'TC_Vehicle',
+      vehicleType: 'FourWheel'
+    },
+    expected: 'success|handled'
+  },
+  {
+    scenario: 'Configure Vehicle (custom)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'configure_vehicle',
+      vehicleName: 'TC_Vehicle',
+      maxRPM: 6000,
+      wheels: []
+    },
+    expected: 'success|default_wheels'
+  },
+
+  // === RETARGETING ===
+  {
+    scenario: 'Pre-cleanup Retargeted asset',
+    toolName: 'manage_asset',
+    arguments: { action: 'delete', assetPaths: ['/Game/Animations/Retargeted/TC_Anim_Retargeted'] },
+    expected: 'success|not_found|error'
+  },
+  {
+    scenario: 'Setup Retargeting',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'setup_retargeting',
+      sourceSkeleton: tutorialSkeleton,
+      targetSkeleton: tutorialSkeleton,
+      assets: ['/Game/Animations/TC_Anim_Sequence'],
+      savePath: '/Game/Animations/Retargeted',
+      overwrite: true
+    },
+    expected: 'success or not connected or not found'
+  },
+
+  // === ERROR CASES ===
+  {
+    scenario: 'Error: Invalid skeleton path',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'create_animation_asset',
+      name: 'InvalidAnim',
+      skeletonPath: '/Game/Invalid/Skeleton',
+      assetType: 'sequence'
+    },
+    expected: 'error|asset_not_found'
+  },
+  {
+    scenario: 'Error: Play rate 0 (pause)',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'play_montage',
+      actorName: 'SkeletalCharacter',
+      montagePath: '/Game/Animations/TC_Anim_Montage',
+      playRate: 0
+    },
+    expected: 'success|no_op'
+  },
+  {
+    scenario: 'Error: Negative RPM vehicle',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'configure_vehicle',
+      vehicleName: 'TestVehicle',
+      maxRPM: -1000
+    },
+    expected: 'success|clamped'
+  },
+  {
+    scenario: 'Error: Invalid plugin deps',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'configure_vehicle',
+      vehicleName: 'TestVehicle',
+      plugins: ['InvalidPlugin']
+    },
+    expected: 'error|plugin_missing|MISSING_ENGINE_PLUGINS'
+  },
+
+  // === CLEANUP ===
+  {
+    scenario: 'Cleanup all animation artifacts',
+    toolName: 'animation_physics',
+    arguments: {
+      action: 'cleanup',
+      filter: 'TC_*'
+    },
+    expected: 'success or no matching'
+  },
+  {
+    scenario: 'Cleanup animation assets',
+    toolName: 'manage_asset',
+    arguments: {
+      action: 'delete',
+      assetPaths: [
+        '/Game/Animations/TC_ABP_Character',
+        '/Game/Animations/TC_ABP_Minimal',
+        '/Game/Animations/TC_Anim_Sequence',
+        '/Game/Animations/TC_Anim_Montage',
+        '/Game/Animations/TC_BS_Locomotion',
+        '/Game/Animations/TC_BS_Movement',
+        '/Game/Animations/Retargeted',
+        '/Game/Physics/TC_PhysAsset'
+      ]
+    },
+    expected: 'success|not_found'
+  }
 ];
 
 await runToolTests('Animation & Physics', testCases);