unreal-engine-mcp-server 0.4.7 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (438) hide show
  1. package/.env.example +26 -0
  2. package/.env.production +38 -7
  3. package/.eslintrc.json +0 -54
  4. package/.eslintrc.override.json +8 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.yml +94 -0
  6. package/.github/ISSUE_TEMPLATE/config.yml +8 -0
  7. package/.github/ISSUE_TEMPLATE/feature_request.yml +56 -0
  8. package/.github/copilot-instructions.md +478 -45
  9. package/.github/dependabot.yml +19 -0
  10. package/.github/labeler.yml +24 -0
  11. package/.github/labels.yml +70 -0
  12. package/.github/pull_request_template.md +42 -0
  13. package/.github/release-drafter.yml +148 -0
  14. package/.github/workflows/auto-merge.yml +38 -0
  15. package/.github/workflows/ci.yml +38 -0
  16. package/.github/workflows/dependency-review.yml +17 -0
  17. package/.github/workflows/gemini-issue-triage.yml +172 -0
  18. package/.github/workflows/greetings.yml +23 -0
  19. package/.github/workflows/labeler.yml +16 -0
  20. package/.github/workflows/links.yml +80 -0
  21. package/.github/workflows/pr-size-labeler.yml +137 -0
  22. package/.github/workflows/publish-mcp.yml +12 -7
  23. package/.github/workflows/release-drafter.yml +23 -0
  24. package/.github/workflows/release.yml +112 -0
  25. package/.github/workflows/semantic-pull-request.yml +35 -0
  26. package/.github/workflows/smoke-test.yml +36 -0
  27. package/.github/workflows/stale.yml +28 -0
  28. package/CHANGELOG.md +267 -31
  29. package/CONTRIBUTING.md +140 -0
  30. package/README.md +166 -71
  31. package/claude_desktop_config_example.json +7 -6
  32. package/dist/automation/bridge.d.ts +50 -0
  33. package/dist/automation/bridge.js +452 -0
  34. package/dist/automation/connection-manager.d.ts +23 -0
  35. package/dist/automation/connection-manager.js +107 -0
  36. package/dist/automation/handshake.d.ts +11 -0
  37. package/dist/automation/handshake.js +89 -0
  38. package/dist/automation/index.d.ts +3 -0
  39. package/dist/automation/index.js +3 -0
  40. package/dist/automation/message-handler.d.ts +12 -0
  41. package/dist/automation/message-handler.js +149 -0
  42. package/dist/automation/request-tracker.d.ts +25 -0
  43. package/dist/automation/request-tracker.js +98 -0
  44. package/dist/automation/types.d.ts +130 -0
  45. package/dist/automation/types.js +2 -0
  46. package/dist/cli.js +32 -5
  47. package/dist/config.d.ts +27 -0
  48. package/dist/config.js +60 -0
  49. package/dist/constants.d.ts +12 -0
  50. package/dist/constants.js +12 -0
  51. package/dist/graphql/resolvers.d.ts +268 -0
  52. package/dist/graphql/resolvers.js +743 -0
  53. package/dist/graphql/schema.d.ts +5 -0
  54. package/dist/graphql/schema.js +437 -0
  55. package/dist/graphql/server.d.ts +26 -0
  56. package/dist/graphql/server.js +115 -0
  57. package/dist/graphql/types.d.ts +7 -0
  58. package/dist/graphql/types.js +2 -0
  59. package/dist/handlers/resource-handlers.d.ts +20 -0
  60. package/dist/handlers/resource-handlers.js +180 -0
  61. package/dist/index.d.ts +31 -18
  62. package/dist/index.js +119 -619
  63. package/dist/prompts/index.js +4 -4
  64. package/dist/resources/actors.d.ts +17 -12
  65. package/dist/resources/actors.js +56 -76
  66. package/dist/resources/assets.d.ts +6 -14
  67. package/dist/resources/assets.js +115 -147
  68. package/dist/resources/levels.d.ts +13 -13
  69. package/dist/resources/levels.js +25 -34
  70. package/dist/server/resource-registry.d.ts +20 -0
  71. package/dist/server/resource-registry.js +37 -0
  72. package/dist/server/tool-registry.d.ts +23 -0
  73. package/dist/server/tool-registry.js +322 -0
  74. package/dist/server-setup.d.ts +21 -0
  75. package/dist/server-setup.js +111 -0
  76. package/dist/services/health-monitor.d.ts +34 -0
  77. package/dist/services/health-monitor.js +105 -0
  78. package/dist/services/metrics-server.d.ts +11 -0
  79. package/dist/services/metrics-server.js +105 -0
  80. package/dist/tools/actors.d.ts +147 -9
  81. package/dist/tools/actors.js +350 -311
  82. package/dist/tools/animation.d.ts +135 -4
  83. package/dist/tools/animation.js +510 -411
  84. package/dist/tools/assets.d.ts +117 -19
  85. package/dist/tools/assets.js +259 -284
  86. package/dist/tools/audio.d.ts +102 -42
  87. package/dist/tools/audio.js +272 -685
  88. package/dist/tools/base-tool.d.ts +17 -0
  89. package/dist/tools/base-tool.js +46 -0
  90. package/dist/tools/behavior-tree.d.ts +94 -0
  91. package/dist/tools/behavior-tree.js +39 -0
  92. package/dist/tools/blueprint/helpers.d.ts +29 -0
  93. package/dist/tools/blueprint/helpers.js +182 -0
  94. package/dist/tools/blueprint.d.ts +228 -118
  95. package/dist/tools/blueprint.js +685 -832
  96. package/dist/tools/consolidated-tool-definitions.d.ts +5462 -1781
  97. package/dist/tools/consolidated-tool-definitions.js +829 -496
  98. package/dist/tools/consolidated-tool-handlers.d.ts +2 -1
  99. package/dist/tools/consolidated-tool-handlers.js +211 -1026
  100. package/dist/tools/debug.d.ts +143 -85
  101. package/dist/tools/debug.js +234 -180
  102. package/dist/tools/dynamic-handler-registry.d.ts +11 -0
  103. package/dist/tools/dynamic-handler-registry.js +101 -0
  104. package/dist/tools/editor.d.ts +139 -18
  105. package/dist/tools/editor.js +239 -244
  106. package/dist/tools/engine.d.ts +10 -4
  107. package/dist/tools/engine.js +13 -5
  108. package/dist/tools/environment.d.ts +36 -0
  109. package/dist/tools/environment.js +267 -0
  110. package/dist/tools/foliage.d.ts +105 -14
  111. package/dist/tools/foliage.js +219 -331
  112. package/dist/tools/handlers/actor-handlers.d.ts +3 -0
  113. package/dist/tools/handlers/actor-handlers.js +232 -0
  114. package/dist/tools/handlers/animation-handlers.d.ts +3 -0
  115. package/dist/tools/handlers/animation-handlers.js +185 -0
  116. package/dist/tools/handlers/argument-helper.d.ts +16 -0
  117. package/dist/tools/handlers/argument-helper.js +80 -0
  118. package/dist/tools/handlers/asset-handlers.d.ts +3 -0
  119. package/dist/tools/handlers/asset-handlers.js +496 -0
  120. package/dist/tools/handlers/audio-handlers.d.ts +3 -0
  121. package/dist/tools/handlers/audio-handlers.js +166 -0
  122. package/dist/tools/handlers/blueprint-handlers.d.ts +4 -0
  123. package/dist/tools/handlers/blueprint-handlers.js +358 -0
  124. package/dist/tools/handlers/common-handlers.d.ts +14 -0
  125. package/dist/tools/handlers/common-handlers.js +56 -0
  126. package/dist/tools/handlers/editor-handlers.d.ts +3 -0
  127. package/dist/tools/handlers/editor-handlers.js +119 -0
  128. package/dist/tools/handlers/effect-handlers.d.ts +3 -0
  129. package/dist/tools/handlers/effect-handlers.js +171 -0
  130. package/dist/tools/handlers/environment-handlers.d.ts +3 -0
  131. package/dist/tools/handlers/environment-handlers.js +170 -0
  132. package/dist/tools/handlers/graph-handlers.d.ts +3 -0
  133. package/dist/tools/handlers/graph-handlers.js +90 -0
  134. package/dist/tools/handlers/input-handlers.d.ts +3 -0
  135. package/dist/tools/handlers/input-handlers.js +21 -0
  136. package/dist/tools/handlers/inspect-handlers.d.ts +3 -0
  137. package/dist/tools/handlers/inspect-handlers.js +383 -0
  138. package/dist/tools/handlers/level-handlers.d.ts +3 -0
  139. package/dist/tools/handlers/level-handlers.js +237 -0
  140. package/dist/tools/handlers/lighting-handlers.d.ts +3 -0
  141. package/dist/tools/handlers/lighting-handlers.js +144 -0
  142. package/dist/tools/handlers/performance-handlers.d.ts +3 -0
  143. package/dist/tools/handlers/performance-handlers.js +130 -0
  144. package/dist/tools/handlers/pipeline-handlers.d.ts +3 -0
  145. package/dist/tools/handlers/pipeline-handlers.js +110 -0
  146. package/dist/tools/handlers/sequence-handlers.d.ts +3 -0
  147. package/dist/tools/handlers/sequence-handlers.js +376 -0
  148. package/dist/tools/handlers/system-handlers.d.ts +4 -0
  149. package/dist/tools/handlers/system-handlers.js +506 -0
  150. package/dist/tools/input.d.ts +19 -0
  151. package/dist/tools/input.js +89 -0
  152. package/dist/tools/introspection.d.ts +103 -40
  153. package/dist/tools/introspection.js +425 -568
  154. package/dist/tools/landscape.d.ts +97 -36
  155. package/dist/tools/landscape.js +280 -409
  156. package/dist/tools/level.d.ts +130 -10
  157. package/dist/tools/level.js +639 -675
  158. package/dist/tools/lighting.d.ts +77 -38
  159. package/dist/tools/lighting.js +441 -943
  160. package/dist/tools/logs.d.ts +3 -3
  161. package/dist/tools/logs.js +5 -57
  162. package/dist/tools/materials.d.ts +91 -24
  163. package/dist/tools/materials.js +190 -118
  164. package/dist/tools/niagara.d.ts +149 -39
  165. package/dist/tools/niagara.js +232 -182
  166. package/dist/tools/performance.d.ts +27 -12
  167. package/dist/tools/performance.js +204 -122
  168. package/dist/tools/physics.d.ts +32 -77
  169. package/dist/tools/physics.js +171 -582
  170. package/dist/tools/property-dictionary.d.ts +13 -0
  171. package/dist/tools/property-dictionary.js +82 -0
  172. package/dist/tools/sequence.d.ts +73 -48
  173. package/dist/tools/sequence.js +196 -748
  174. package/dist/tools/tool-definition-utils.d.ts +59 -0
  175. package/dist/tools/tool-definition-utils.js +35 -0
  176. package/dist/tools/ui.d.ts +66 -34
  177. package/dist/tools/ui.js +134 -214
  178. package/dist/types/env.d.ts +0 -3
  179. package/dist/types/env.js +0 -7
  180. package/dist/types/tool-interfaces.d.ts +898 -0
  181. package/dist/types/tool-interfaces.js +2 -0
  182. package/dist/types/tool-types.d.ts +183 -19
  183. package/dist/types/tool-types.js +0 -4
  184. package/dist/unreal-bridge.d.ts +24 -131
  185. package/dist/unreal-bridge.js +364 -1506
  186. package/dist/utils/command-validator.d.ts +9 -0
  187. package/dist/utils/command-validator.js +67 -0
  188. package/dist/utils/elicitation.d.ts +1 -1
  189. package/dist/utils/elicitation.js +12 -15
  190. package/dist/utils/error-handler.d.ts +2 -51
  191. package/dist/utils/error-handler.js +11 -87
  192. package/dist/utils/ini-reader.d.ts +3 -0
  193. package/dist/utils/ini-reader.js +69 -0
  194. package/dist/utils/logger.js +9 -6
  195. package/dist/utils/normalize.d.ts +3 -0
  196. package/dist/utils/normalize.js +56 -0
  197. package/dist/utils/response-factory.d.ts +7 -0
  198. package/dist/utils/response-factory.js +33 -0
  199. package/dist/utils/response-validator.d.ts +3 -24
  200. package/dist/utils/response-validator.js +130 -81
  201. package/dist/utils/result-helpers.d.ts +4 -5
  202. package/dist/utils/result-helpers.js +15 -16
  203. package/dist/utils/safe-json.js +5 -11
  204. package/dist/utils/unreal-command-queue.d.ts +24 -0
  205. package/dist/utils/unreal-command-queue.js +120 -0
  206. package/dist/utils/validation.d.ts +0 -40
  207. package/dist/utils/validation.js +1 -78
  208. package/dist/wasm/index.d.ts +70 -0
  209. package/dist/wasm/index.js +535 -0
  210. package/docs/GraphQL-API.md +888 -0
  211. package/docs/Migration-Guide-v0.5.0.md +692 -0
  212. package/docs/Roadmap.md +53 -0
  213. package/docs/WebAssembly-Integration.md +628 -0
  214. package/docs/editor-plugin-extension.md +370 -0
  215. package/docs/handler-mapping.md +242 -0
  216. package/docs/native-automation-progress.md +128 -0
  217. package/docs/testing-guide.md +423 -0
  218. package/mcp-config-example.json +6 -6
  219. package/package.json +60 -27
  220. package/plugins/McpAutomationBridge/Config/FilterPlugin.ini +8 -0
  221. package/plugins/McpAutomationBridge/McpAutomationBridge.uplugin +64 -0
  222. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/McpAutomationBridge.Build.cs +189 -0
  223. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.cpp +22 -0
  224. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeGlobals.h +30 -0
  225. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeHelpers.h +1983 -0
  226. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeModule.cpp +72 -0
  227. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSettings.cpp +46 -0
  228. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridgeSubsystem.cpp +581 -0
  229. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AnimationHandlers.cpp +2394 -0
  230. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetQueryHandlers.cpp +300 -0
  231. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AssetWorkflowHandlers.cpp +2807 -0
  232. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_AudioHandlers.cpp +1087 -0
  233. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BehaviorTreeHandlers.cpp +488 -0
  234. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.cpp +643 -0
  235. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintCreationHandlers.h +31 -0
  236. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintGraphHandlers.cpp +1184 -0
  237. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers.cpp +5652 -0
  238. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_BlueprintHandlers_List.cpp +152 -0
  239. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ControlHandlers.cpp +2614 -0
  240. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_DebugHandlers.cpp +42 -0
  241. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EditorFunctionHandlers.cpp +1237 -0
  242. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EffectHandlers.cpp +1701 -0
  243. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_EnvironmentHandlers.cpp +2145 -0
  244. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_FoliageHandlers.cpp +954 -0
  245. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InputHandlers.cpp +209 -0
  246. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_InsightsHandlers.cpp +41 -0
  247. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LandscapeHandlers.cpp +1164 -0
  248. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LevelHandlers.cpp +762 -0
  249. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LightingHandlers.cpp +634 -0
  250. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_LogHandlers.cpp +136 -0
  251. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_MaterialGraphHandlers.cpp +494 -0
  252. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraGraphHandlers.cpp +278 -0
  253. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_NiagaraHandlers.cpp +625 -0
  254. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PerformanceHandlers.cpp +401 -0
  255. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PipelineHandlers.cpp +67 -0
  256. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_ProcessRequest.cpp +735 -0
  257. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_PropertyHandlers.cpp +2634 -0
  258. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_RenderHandlers.cpp +189 -0
  259. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.cpp +917 -0
  260. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SCSHandlers.h +39 -0
  261. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequenceHandlers.cpp +2670 -0
  262. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_SequencerHandlers.cpp +519 -0
  263. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_TestHandlers.cpp +38 -0
  264. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_UiHandlers.cpp +668 -0
  265. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpAutomationBridge_WorldPartitionHandlers.cpp +346 -0
  266. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.cpp +1330 -0
  267. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpBridgeWebSocket.h +149 -0
  268. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/McpConnectionManager.cpp +783 -0
  269. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSettings.h +115 -0
  270. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpAutomationBridgeSubsystem.h +796 -0
  271. package/plugins/McpAutomationBridge/Source/McpAutomationBridge/Public/McpConnectionManager.h +117 -0
  272. package/scripts/check-unreal-connection.mjs +19 -0
  273. package/scripts/clean-tmp.js +23 -0
  274. package/scripts/patch-wasm.js +26 -0
  275. package/scripts/run-all-tests.mjs +131 -0
  276. package/scripts/smoke-test.ts +94 -0
  277. package/scripts/sync-mcp-plugin.js +143 -0
  278. package/scripts/test-no-plugin-alternates.mjs +113 -0
  279. package/scripts/validate-server.js +46 -0
  280. package/scripts/verify-automation-bridge.js +200 -0
  281. package/server.json +57 -21
  282. package/src/automation/bridge.ts +558 -0
  283. package/src/automation/connection-manager.ts +130 -0
  284. package/src/automation/handshake.ts +99 -0
  285. package/src/automation/index.ts +2 -0
  286. package/src/automation/message-handler.ts +167 -0
  287. package/src/automation/request-tracker.ts +123 -0
  288. package/src/automation/types.ts +107 -0
  289. package/src/cli.ts +33 -6
  290. package/src/config.ts +73 -0
  291. package/src/constants.ts +12 -0
  292. package/src/graphql/resolvers.ts +1010 -0
  293. package/src/graphql/schema.ts +452 -0
  294. package/src/graphql/server.ts +154 -0
  295. package/src/graphql/types.ts +7 -0
  296. package/src/handlers/resource-handlers.ts +186 -0
  297. package/src/index.ts +152 -663
  298. package/src/prompts/index.ts +4 -4
  299. package/src/resources/actors.ts +58 -76
  300. package/src/resources/assets.ts +147 -134
  301. package/src/resources/levels.ts +28 -33
  302. package/src/server/resource-registry.ts +47 -0
  303. package/src/server/tool-registry.ts +354 -0
  304. package/src/server-setup.ts +148 -0
  305. package/src/services/health-monitor.ts +132 -0
  306. package/src/services/metrics-server.ts +142 -0
  307. package/src/tools/actors.ts +417 -322
  308. package/src/tools/animation.ts +671 -461
  309. package/src/tools/assets.ts +353 -289
  310. package/src/tools/audio.ts +323 -766
  311. package/src/tools/base-tool.ts +52 -0
  312. package/src/tools/behavior-tree.ts +45 -0
  313. package/src/tools/blueprint/helpers.ts +189 -0
  314. package/src/tools/blueprint.ts +787 -965
  315. package/src/tools/consolidated-tool-definitions.ts +993 -515
  316. package/src/tools/consolidated-tool-handlers.ts +272 -1139
  317. package/src/tools/debug.ts +292 -187
  318. package/src/tools/dynamic-handler-registry.ts +151 -0
  319. package/src/tools/editor.ts +309 -246
  320. package/src/tools/engine.ts +14 -3
  321. package/src/tools/environment.ts +287 -0
  322. package/src/tools/foliage.ts +314 -379
  323. package/src/tools/handlers/actor-handlers.ts +271 -0
  324. package/src/tools/handlers/animation-handlers.ts +237 -0
  325. package/src/tools/handlers/argument-helper.ts +142 -0
  326. package/src/tools/handlers/asset-handlers.ts +532 -0
  327. package/src/tools/handlers/audio-handlers.ts +194 -0
  328. package/src/tools/handlers/blueprint-handlers.ts +380 -0
  329. package/src/tools/handlers/common-handlers.ts +87 -0
  330. package/src/tools/handlers/editor-handlers.ts +123 -0
  331. package/src/tools/handlers/effect-handlers.ts +220 -0
  332. package/src/tools/handlers/environment-handlers.ts +183 -0
  333. package/src/tools/handlers/graph-handlers.ts +116 -0
  334. package/src/tools/handlers/input-handlers.ts +28 -0
  335. package/src/tools/handlers/inspect-handlers.ts +450 -0
  336. package/src/tools/handlers/level-handlers.ts +252 -0
  337. package/src/tools/handlers/lighting-handlers.ts +147 -0
  338. package/src/tools/handlers/performance-handlers.ts +132 -0
  339. package/src/tools/handlers/pipeline-handlers.ts +127 -0
  340. package/src/tools/handlers/sequence-handlers.ts +415 -0
  341. package/src/tools/handlers/system-handlers.ts +564 -0
  342. package/src/tools/input.ts +101 -0
  343. package/src/tools/introspection.ts +493 -584
  344. package/src/tools/landscape.ts +394 -489
  345. package/src/tools/level.ts +752 -694
  346. package/src/tools/lighting.ts +583 -984
  347. package/src/tools/logs.ts +9 -57
  348. package/src/tools/materials.ts +231 -121
  349. package/src/tools/niagara.ts +293 -168
  350. package/src/tools/performance.ts +320 -168
  351. package/src/tools/physics.ts +268 -613
  352. package/src/tools/property-dictionary.ts +98 -0
  353. package/src/tools/sequence.ts +255 -815
  354. package/src/tools/tool-definition-utils.ts +35 -0
  355. package/src/tools/ui.ts +207 -283
  356. package/src/types/env.ts +0 -10
  357. package/src/types/tool-interfaces.ts +250 -0
  358. package/src/types/tool-types.ts +243 -21
  359. package/src/unreal-bridge.ts +460 -1550
  360. package/src/utils/command-validator.ts +75 -0
  361. package/src/utils/elicitation.ts +10 -7
  362. package/src/utils/error-handler.ts +14 -90
  363. package/src/utils/ini-reader.ts +86 -0
  364. package/src/utils/logger.ts +8 -3
  365. package/src/utils/normalize.ts +60 -0
  366. package/src/utils/response-factory.ts +39 -0
  367. package/src/utils/response-validator.ts +176 -56
  368. package/src/utils/result-helpers.ts +21 -19
  369. package/src/utils/safe-json.ts +14 -11
  370. package/src/utils/unreal-command-queue.ts +152 -0
  371. package/src/utils/validation.ts +4 -1
  372. package/src/wasm/index.ts +838 -0
  373. package/test-server.mjs +100 -0
  374. package/tests/run-unreal-tool-tests.mjs +242 -14
  375. package/tests/test-animation.mjs +44 -0
  376. package/tests/test-asset-advanced.mjs +82 -0
  377. package/tests/test-asset-errors.mjs +35 -0
  378. package/tests/test-audio.mjs +219 -0
  379. package/tests/test-automation-timeouts.mjs +98 -0
  380. package/tests/test-behavior-tree.mjs +261 -0
  381. package/tests/test-blueprint-events.mjs +35 -0
  382. package/tests/test-blueprint-graph.mjs +79 -0
  383. package/tests/test-blueprint.mjs +577 -0
  384. package/tests/test-client-mode.mjs +86 -0
  385. package/tests/test-console-command.mjs +56 -0
  386. package/tests/test-control-actor.mjs +425 -0
  387. package/tests/test-control-editor.mjs +80 -0
  388. package/tests/test-extra-tools.mjs +38 -0
  389. package/tests/test-graphql.mjs +322 -0
  390. package/tests/test-inspect.mjs +72 -0
  391. package/tests/test-landscape.mjs +60 -0
  392. package/tests/test-manage-asset.mjs +438 -0
  393. package/tests/test-manage-level.mjs +70 -0
  394. package/tests/test-materials.mjs +356 -0
  395. package/tests/test-niagara.mjs +185 -0
  396. package/tests/test-no-inline-python.mjs +122 -0
  397. package/tests/test-plugin-handshake.mjs +82 -0
  398. package/tests/test-render.mjs +33 -0
  399. package/tests/test-runner.mjs +933 -0
  400. package/tests/test-search-assets.mjs +66 -0
  401. package/tests/test-sequence.mjs +68 -0
  402. package/tests/test-system.mjs +57 -0
  403. package/tests/test-wasm.mjs +193 -0
  404. package/tests/test-world-partition.mjs +215 -0
  405. package/tsconfig.json +3 -3
  406. package/wasm/Cargo.lock +363 -0
  407. package/wasm/Cargo.toml +42 -0
  408. package/wasm/LICENSE +21 -0
  409. package/wasm/README.md +253 -0
  410. package/wasm/src/dependency_resolver.rs +377 -0
  411. package/wasm/src/lib.rs +153 -0
  412. package/wasm/src/property_parser.rs +271 -0
  413. package/wasm/src/transform_math.rs +396 -0
  414. package/wasm/tests/integration.rs +109 -0
  415. package/.github/workflows/smithery-build.yml +0 -29
  416. package/dist/tools/build_environment_advanced.d.ts +0 -65
  417. package/dist/tools/build_environment_advanced.js +0 -633
  418. package/dist/tools/rc.d.ts +0 -110
  419. package/dist/tools/rc.js +0 -437
  420. package/dist/tools/visual.d.ts +0 -40
  421. package/dist/tools/visual.js +0 -282
  422. package/dist/utils/http.d.ts +0 -6
  423. package/dist/utils/http.js +0 -151
  424. package/dist/utils/python-output.d.ts +0 -18
  425. package/dist/utils/python-output.js +0 -290
  426. package/dist/utils/python.d.ts +0 -2
  427. package/dist/utils/python.js +0 -4
  428. package/dist/utils/stdio-redirect.d.ts +0 -2
  429. package/dist/utils/stdio-redirect.js +0 -20
  430. package/docs/unreal-tool-test-cases.md +0 -574
  431. package/smithery.yaml +0 -29
  432. package/src/tools/build_environment_advanced.ts +0 -732
  433. package/src/tools/rc.ts +0 -515
  434. package/src/tools/visual.ts +0 -281
  435. package/src/utils/http.ts +0 -187
  436. package/src/utils/python-output.ts +0 -351
  437. package/src/utils/python.ts +0 -3
  438. package/src/utils/stdio-redirect.ts +0 -18
@@ -0,0 +1,668 @@
1
+ #include "McpAutomationBridgeGlobals.h"
2
+ #include "McpAutomationBridgeHelpers.h"
3
+ #include "McpAutomationBridgeSubsystem.h"
4
+ #if WITH_EDITOR
5
+ #include "AssetToolsModule.h"
6
+ #include "Blueprint/UserWidget.h"
7
+ #include "Blueprint/WidgetBlueprintLibrary.h"
8
+ #include "Blueprint/WidgetTree.h"
9
+ #include "Components/Image.h"
10
+ #include "Components/PanelWidget.h"
11
+ #include "Components/TextBlock.h"
12
+ #include "EditorAssetLibrary.h"
13
+ #include "Engine/GameViewportClient.h"
14
+ #include "HAL/FileManager.h"
15
+ #include "IImageWrapper.h"
16
+ #include "IImageWrapperModule.h"
17
+ #include "ImageUtils.h"
18
+ #include "Misc/Base64.h"
19
+ #include "Misc/FileHelper.h"
20
+ #include "Misc/Paths.h"
21
+ #include "Modules/ModuleManager.h"
22
+ #include "UnrealClient.h"
23
+ #include "WidgetBlueprint.h"
24
+ #if __has_include("Factories/WidgetBlueprintFactory.h")
25
+ #include "Factories/WidgetBlueprintFactory.h"
26
+ #define MCP_HAS_WIDGET_FACTORY 1
27
+ #else
28
+ #define MCP_HAS_WIDGET_FACTORY 0
29
+ #endif
30
+ #endif
31
+
32
+ bool UMcpAutomationBridgeSubsystem::HandleUiAction(
33
+ const FString &RequestId, const FString &Action,
34
+ const TSharedPtr<FJsonObject> &Payload,
35
+ TSharedPtr<FMcpBridgeWebSocket> RequestingSocket) {
36
+ const FString LowerAction = Action.ToLower();
37
+ bool bIsSystemControl =
38
+ LowerAction.Equals(TEXT("system_control"), ESearchCase::IgnoreCase);
39
+ bool bIsManageUi =
40
+ LowerAction.Equals(TEXT("manage_ui"), ESearchCase::IgnoreCase);
41
+
42
+ if (!bIsSystemControl && !bIsManageUi) {
43
+ return false;
44
+ }
45
+
46
+ if (!Payload.IsValid()) {
47
+ SendAutomationError(RequestingSocket, RequestId, TEXT("Payload missing."),
48
+ TEXT("INVALID_PAYLOAD"));
49
+ return true;
50
+ }
51
+
52
+ FString SubAction;
53
+ if (Payload->HasField(TEXT("subAction"))) {
54
+ SubAction = Payload->GetStringField(TEXT("subAction"));
55
+ } else {
56
+ Payload->TryGetStringField(TEXT("action"), SubAction);
57
+ }
58
+ const FString LowerSub = SubAction.ToLower();
59
+
60
+ TSharedPtr<FJsonObject> Resp = MakeShared<FJsonObject>();
61
+ Resp->SetStringField(TEXT("action"), LowerSub);
62
+
63
+ bool bSuccess = false;
64
+ FString Message;
65
+ FString ErrorCode;
66
+
67
+ #if WITH_EDITOR
68
+ if (LowerSub == TEXT("create_widget")) {
69
+ #if WITH_EDITOR && MCP_HAS_WIDGET_FACTORY
70
+ FString WidgetName;
71
+ if (!Payload->TryGetStringField(TEXT("name"), WidgetName) ||
72
+ WidgetName.IsEmpty()) {
73
+ Message = TEXT("name field required for create_widget");
74
+ ErrorCode = TEXT("INVALID_ARGUMENT");
75
+ Resp->SetStringField(TEXT("error"), Message);
76
+ } else {
77
+ FString SavePath;
78
+ Payload->TryGetStringField(TEXT("savePath"), SavePath);
79
+ if (SavePath.IsEmpty()) {
80
+ SavePath = TEXT("/Game/UI/Widgets");
81
+ }
82
+
83
+ FString WidgetType;
84
+ Payload->TryGetStringField(TEXT("widgetType"), WidgetType);
85
+
86
+ const FString NormalizedPath = SavePath.TrimStartAndEnd();
87
+ const FString TargetPath =
88
+ FString::Printf(TEXT("%s/%s"), *NormalizedPath, *WidgetName);
89
+ if (UEditorAssetLibrary::DoesAssetExist(TargetPath)) {
90
+ bSuccess = true;
91
+ Message = FString::Printf(TEXT("Widget blueprint already exists at %s"),
92
+ *TargetPath);
93
+ Resp->SetStringField(TEXT("widgetPath"), TargetPath);
94
+ Resp->SetBoolField(TEXT("exists"), true);
95
+ if (!WidgetType.IsEmpty()) {
96
+ Resp->SetStringField(TEXT("widgetType"), WidgetType);
97
+ }
98
+ Resp->SetStringField(TEXT("widgetName"), WidgetName);
99
+ } else {
100
+ UWidgetBlueprintFactory *Factory = NewObject<UWidgetBlueprintFactory>();
101
+ if (!Factory) {
102
+ Message = TEXT("Failed to create widget blueprint factory");
103
+ ErrorCode = TEXT("FACTORY_CREATION_FAILED");
104
+ Resp->SetStringField(TEXT("error"), Message);
105
+ } else {
106
+ UObject *NewAsset = Factory->FactoryCreateNew(
107
+ UWidgetBlueprint::StaticClass(),
108
+ UEditorAssetLibrary::DoesAssetExist(NormalizedPath)
109
+ ? UEditorAssetLibrary::LoadAsset(NormalizedPath)
110
+ : nullptr,
111
+ FName(*WidgetName), RF_Standalone, nullptr, GWarn);
112
+
113
+ UWidgetBlueprint *WidgetBlueprint = Cast<UWidgetBlueprint>(NewAsset);
114
+
115
+ if (!WidgetBlueprint) {
116
+ Message = TEXT("Failed to create widget blueprint asset");
117
+ ErrorCode = TEXT("ASSET_CREATION_FAILED");
118
+ Resp->SetStringField(TEXT("error"), Message);
119
+ } else {
120
+ // Force immediate save and registry scan
121
+ SaveLoadedAssetThrottled(WidgetBlueprint, -1.0, true);
122
+ ScanPathSynchronous(WidgetBlueprint->GetOutermost()->GetName());
123
+
124
+ bSuccess = true;
125
+ Message = FString::Printf(TEXT("Widget blueprint created at %s"),
126
+ *WidgetBlueprint->GetPathName());
127
+ Resp->SetStringField(TEXT("widgetPath"),
128
+ WidgetBlueprint->GetPathName());
129
+ Resp->SetStringField(TEXT("widgetName"), WidgetName);
130
+ if (!WidgetType.IsEmpty()) {
131
+ Resp->SetStringField(TEXT("widgetType"), WidgetType);
132
+ }
133
+ }
134
+ }
135
+ }
136
+ }
137
+ #else
138
+ Message =
139
+ TEXT("create_widget requires editor build with widget factory support");
140
+ ErrorCode = TEXT("NOT_AVAILABLE");
141
+ Resp->SetStringField(TEXT("error"), Message);
142
+ #endif
143
+ } else if (LowerSub == TEXT("add_widget_child")) {
144
+ #if WITH_EDITOR && MCP_HAS_WIDGET_FACTORY
145
+ FString WidgetPath;
146
+ if (!Payload->TryGetStringField(TEXT("widgetPath"), WidgetPath) ||
147
+ WidgetPath.IsEmpty()) {
148
+ Message = TEXT("widgetPath required for add_widget_child");
149
+ ErrorCode = TEXT("INVALID_ARGUMENT");
150
+ Resp->SetStringField(TEXT("error"), Message);
151
+ } else {
152
+ UWidgetBlueprint *WidgetBP =
153
+ LoadObject<UWidgetBlueprint>(nullptr, *WidgetPath);
154
+ if (!WidgetBP) {
155
+ Message = FString::Printf(TEXT("Could not find Widget Blueprint at %s"),
156
+ *WidgetPath);
157
+ ErrorCode = TEXT("ASSET_NOT_FOUND");
158
+ Resp->SetStringField(TEXT("error"), Message);
159
+ } else {
160
+ FString ChildClassPath;
161
+ if (!Payload->TryGetStringField(TEXT("childClass"), ChildClassPath) ||
162
+ ChildClassPath.IsEmpty()) {
163
+ // Fallback to commonly used types if only short name provided?
164
+ // For now require full path or class name if it can be found.
165
+ Message = TEXT("childClass required (e.g. /Script/UMG.Button)");
166
+ ErrorCode = TEXT("INVALID_ARGUMENT");
167
+ Resp->SetStringField(TEXT("error"), Message);
168
+ } else {
169
+ UClass *WidgetClass =
170
+ UEditorAssetLibrary::FindAssetData(ChildClassPath)
171
+ .GetAsset()
172
+ .IsValid()
173
+ ? LoadClass<UObject>(nullptr, *ChildClassPath)
174
+ : FindObject<UClass>(nullptr, *ChildClassPath);
175
+
176
+ // Try partial search for common UMG widgets
177
+ if (!WidgetClass) {
178
+ if (ChildClassPath.Contains(TEXT(".")))
179
+ WidgetClass = FindObject<UClass>(nullptr, *ChildClassPath);
180
+ else
181
+ WidgetClass = FindObject<UClass>(
182
+ nullptr,
183
+ *FString::Printf(TEXT("/Script/UMG.%s"), *ChildClassPath));
184
+ }
185
+
186
+ if (!WidgetClass || !WidgetClass->IsChildOf(UWidget::StaticClass())) {
187
+ Message = FString::Printf(
188
+ TEXT("Could not resolve valid UWidget class from '%s'"),
189
+ *ChildClassPath);
190
+ ErrorCode = TEXT("CLASS_NOT_FOUND");
191
+ Resp->SetStringField(TEXT("error"), Message);
192
+ } else {
193
+ FString ParentName;
194
+ Payload->TryGetStringField(TEXT("parentName"), ParentName);
195
+
196
+ WidgetBP->Modify();
197
+
198
+ UWidget *NewWidget =
199
+ WidgetBP->WidgetTree->ConstructWidget<UWidget>(WidgetClass);
200
+
201
+ bool bAdded = false;
202
+ bool bIsRoot = false;
203
+
204
+ if (ParentName.IsEmpty()) {
205
+ // Try to set as RootWidget if empty
206
+ if (WidgetBP->WidgetTree->RootWidget == nullptr) {
207
+ WidgetBP->WidgetTree->RootWidget = NewWidget;
208
+ bAdded = true;
209
+ bIsRoot = true;
210
+ } else {
211
+ // Try to add to existing root if it's a panel
212
+ UPanelWidget *RootPanel =
213
+ Cast<UPanelWidget>(WidgetBP->WidgetTree->RootWidget);
214
+ if (RootPanel) {
215
+ RootPanel->AddChild(NewWidget);
216
+ bAdded = true;
217
+ } else {
218
+ Message = TEXT("Root widget is not a panel and already "
219
+ "exists. Specify parentName.");
220
+ ErrorCode = TEXT("ROOT_Full");
221
+ }
222
+ }
223
+ } else {
224
+ // Find parent
225
+ UWidget *ParentWidget =
226
+ WidgetBP->WidgetTree->FindWidget(FName(*ParentName));
227
+ UPanelWidget *ParentPanel = Cast<UPanelWidget>(ParentWidget);
228
+ if (ParentPanel) {
229
+ ParentPanel->AddChild(NewWidget);
230
+ bAdded = true;
231
+ } else {
232
+ Message = FString::Printf(
233
+ TEXT("Parent '%s' not found or is not a PanelWidget"),
234
+ *ParentName);
235
+ ErrorCode = TEXT("PARENT_NOT_FOUND");
236
+ }
237
+ }
238
+
239
+ if (bAdded) {
240
+ UEditorAssetLibrary::SaveAsset(WidgetBP->GetPathName());
241
+ bSuccess = true;
242
+ Message = FString::Printf(TEXT("Added %s to %s"),
243
+ *WidgetClass->GetName(),
244
+ *WidgetBP->GetName());
245
+ Resp->SetStringField(TEXT("widgetName"), NewWidget->GetName());
246
+ Resp->SetStringField(TEXT("childClass"), WidgetClass->GetName());
247
+ } else {
248
+ if (Message.IsEmpty())
249
+ Message = TEXT("Failed to add widget child.");
250
+ Resp->SetStringField(TEXT("error"), Message);
251
+ }
252
+ }
253
+ }
254
+ }
255
+ }
256
+ #else
257
+ Message = TEXT("add_widget_child requires editor build");
258
+ ErrorCode = TEXT("NOT_AVAILABLE");
259
+ Resp->SetStringField(TEXT("error"), Message);
260
+ #endif
261
+ } else if (LowerSub == TEXT("screenshot")) {
262
+ // Take a screenshot of the viewport and return as base64
263
+ FString ScreenshotPath;
264
+ Payload->TryGetStringField(TEXT("path"), ScreenshotPath);
265
+ if (ScreenshotPath.IsEmpty()) {
266
+ ScreenshotPath =
267
+ FPaths::ProjectSavedDir() / TEXT("Screenshots/WindowsEditor");
268
+ }
269
+
270
+ FString Filename;
271
+ Payload->TryGetStringField(TEXT("filename"), Filename);
272
+ if (Filename.IsEmpty()) {
273
+ Filename = FString::Printf(TEXT("Screenshot_%lld"),
274
+ FDateTime::Now().ToUnixTimestamp());
275
+ }
276
+
277
+ bool bReturnBase64 = true;
278
+ Payload->TryGetBoolField(TEXT("returnBase64"), bReturnBase64);
279
+
280
+ // Get viewport
281
+ if (!GEngine || !GEngine->GameViewport) {
282
+ Message = TEXT("No game viewport available");
283
+ ErrorCode = TEXT("NO_VIEWPORT");
284
+ Resp->SetStringField(TEXT("error"), Message);
285
+ } else {
286
+ UGameViewportClient *ViewportClient = GEngine->GameViewport;
287
+ FViewport *Viewport = ViewportClient->Viewport;
288
+
289
+ if (!Viewport) {
290
+ Message = TEXT("No viewport available");
291
+ ErrorCode = TEXT("NO_VIEWPORT");
292
+ Resp->SetStringField(TEXT("error"), Message);
293
+ } else {
294
+ // Capture viewport pixels
295
+ TArray<FColor> Bitmap;
296
+ FIntVector Size(Viewport->GetSizeXY().X, Viewport->GetSizeXY().Y, 0);
297
+
298
+ bool bReadSuccess = Viewport->ReadPixels(Bitmap);
299
+
300
+ if (!bReadSuccess || Bitmap.Num() == 0) {
301
+ Message = TEXT("Failed to read viewport pixels");
302
+ ErrorCode = TEXT("CAPTURE_FAILED");
303
+ Resp->SetStringField(TEXT("error"), Message);
304
+ } else {
305
+ // Ensure we have the right size
306
+ const int32 Width = Size.X;
307
+ const int32 Height = Size.Y;
308
+
309
+ // Compress to PNG
310
+ TArray<uint8> PngData;
311
+ FImageUtils::ThumbnailCompressImageArray(Width, Height, Bitmap,
312
+ PngData);
313
+
314
+ if (PngData.Num() == 0) {
315
+ // Alternative: compress as PNG using IImageWrapper
316
+ IImageWrapperModule &ImageWrapperModule =
317
+ FModuleManager::LoadModuleChecked<IImageWrapperModule>(
318
+ FName("ImageWrapper"));
319
+ TSharedPtr<IImageWrapper> ImageWrapper =
320
+ ImageWrapperModule.CreateImageWrapper(EImageFormat::PNG);
321
+
322
+ if (ImageWrapper.IsValid()) {
323
+ TArray<uint8> RawData;
324
+ RawData.SetNum(Width * Height * 4);
325
+ for (int32 i = 0; i < Bitmap.Num(); ++i) {
326
+ RawData[i * 4 + 0] = Bitmap[i].R;
327
+ RawData[i * 4 + 1] = Bitmap[i].G;
328
+ RawData[i * 4 + 2] = Bitmap[i].B;
329
+ RawData[i * 4 + 3] = Bitmap[i].A;
330
+ }
331
+
332
+ if (ImageWrapper->SetRaw(RawData.GetData(), RawData.Num(), Width,
333
+ Height, ERGBFormat::RGBA, 8)) {
334
+ PngData = ImageWrapper->GetCompressed(100);
335
+ }
336
+ }
337
+ }
338
+
339
+ FString FullPath =
340
+ FPaths::Combine(ScreenshotPath, Filename + TEXT(".png"));
341
+ FPaths::MakeStandardFilename(FullPath);
342
+
343
+ // Always save to disk
344
+ IFileManager::Get().MakeDirectory(*ScreenshotPath, true);
345
+ bool bSaved = FFileHelper::SaveArrayToFile(PngData, *FullPath);
346
+
347
+ bSuccess = true;
348
+ Message = FString::Printf(TEXT("Screenshot captured (%dx%d)"), Width,
349
+ Height);
350
+ Resp->SetStringField(TEXT("screenshotPath"), FullPath);
351
+ Resp->SetStringField(TEXT("filename"), Filename);
352
+ Resp->SetNumberField(TEXT("width"), Width);
353
+ Resp->SetNumberField(TEXT("height"), Height);
354
+ Resp->SetNumberField(TEXT("sizeBytes"), PngData.Num());
355
+
356
+ // Return base64 encoded image if requested
357
+ if (bReturnBase64 && PngData.Num() > 0) {
358
+ FString Base64Data = FBase64::Encode(PngData);
359
+ Resp->SetStringField(TEXT("imageBase64"), Base64Data);
360
+ Resp->SetStringField(TEXT("mimeType"), TEXT("image/png"));
361
+ }
362
+ }
363
+ }
364
+ }
365
+ } else if (LowerSub == TEXT("play_in_editor")) {
366
+ // Start play in editor
367
+ if (GEditor && GEditor->PlayWorld) {
368
+ Message = TEXT("Already playing in editor");
369
+ ErrorCode = TEXT("ALREADY_PLAYING");
370
+ Resp->SetStringField(TEXT("error"), Message);
371
+ } else {
372
+ // Execute play command
373
+ bool bCommandSuccess = GEditor->Exec(nullptr, TEXT("Play In Editor"));
374
+ if (bCommandSuccess) {
375
+ bSuccess = true;
376
+ Message = TEXT("Started play in editor");
377
+ Resp->SetStringField(TEXT("status"), TEXT("playing"));
378
+ } else {
379
+ Message = TEXT("Failed to start play in editor");
380
+ ErrorCode = TEXT("PLAY_FAILED");
381
+ Resp->SetStringField(TEXT("error"), Message);
382
+ }
383
+ }
384
+ } else if (LowerSub == TEXT("stop_play")) {
385
+ // Stop play in editor
386
+ if (GEditor && GEditor->PlayWorld) {
387
+ // Execute stop command
388
+ bool bCommandSuccess =
389
+ GEditor->Exec(nullptr, TEXT("Stop Play In Editor"));
390
+ if (bCommandSuccess) {
391
+ bSuccess = true;
392
+ Message = TEXT("Stopped play in editor");
393
+ Resp->SetStringField(TEXT("status"), TEXT("stopped"));
394
+ } else {
395
+ Message = TEXT("Failed to stop play in editor");
396
+ ErrorCode = TEXT("STOP_FAILED");
397
+ Resp->SetStringField(TEXT("error"), Message);
398
+ }
399
+ } else {
400
+ Message = TEXT("Not currently playing in editor");
401
+ ErrorCode = TEXT("NOT_PLAYING");
402
+ Resp->SetStringField(TEXT("error"), Message);
403
+ }
404
+ } else if (LowerSub == TEXT("save_all")) {
405
+ // Save all assets and levels
406
+ bool bCommandSuccess = GEditor->Exec(nullptr, TEXT("Asset Save All"));
407
+ if (bCommandSuccess) {
408
+ bSuccess = true;
409
+ Message = TEXT("Saved all assets");
410
+ Resp->SetStringField(TEXT("status"), TEXT("saved"));
411
+ } else {
412
+ Message = TEXT("Failed to save all assets");
413
+ ErrorCode = TEXT("SAVE_FAILED");
414
+ Resp->SetStringField(TEXT("error"), Message);
415
+ }
416
+ } else if (LowerSub == TEXT("simulate_input")) {
417
+ FString KeyName;
418
+ Payload->TryGetStringField(TEXT("keyName"),
419
+ KeyName); // Changed to keyName to match schema
420
+ if (KeyName.IsEmpty())
421
+ Payload->TryGetStringField(TEXT("key"), KeyName); // Fallback
422
+
423
+ FString EventType;
424
+ Payload->TryGetStringField(TEXT("eventType"), EventType);
425
+
426
+ FKey Key = FKey(FName(*KeyName));
427
+ if (Key.IsValid()) {
428
+ const uint32 CharacterCode = 0;
429
+ const uint32 KeyCode = 0;
430
+ const bool bIsRepeat = false;
431
+ FModifierKeysState ModifierState;
432
+
433
+ if (EventType == TEXT("KeyDown")) {
434
+ FKeyEvent KeyEvent(Key, ModifierState,
435
+ FSlateApplication::Get().GetUserIndexForKeyboard(),
436
+ bIsRepeat, CharacterCode, KeyCode);
437
+ FSlateApplication::Get().ProcessKeyDownEvent(KeyEvent);
438
+ } else if (EventType == TEXT("KeyUp")) {
439
+ FKeyEvent KeyEvent(Key, ModifierState,
440
+ FSlateApplication::Get().GetUserIndexForKeyboard(),
441
+ bIsRepeat, CharacterCode, KeyCode);
442
+ FSlateApplication::Get().ProcessKeyUpEvent(KeyEvent);
443
+ } else {
444
+ // Press and Release
445
+ FKeyEvent KeyDownEvent(
446
+ Key, ModifierState,
447
+ FSlateApplication::Get().GetUserIndexForKeyboard(), bIsRepeat,
448
+ CharacterCode, KeyCode);
449
+ FSlateApplication::Get().ProcessKeyDownEvent(KeyDownEvent);
450
+
451
+ FKeyEvent KeyUpEvent(Key, ModifierState,
452
+ FSlateApplication::Get().GetUserIndexForKeyboard(),
453
+ bIsRepeat, CharacterCode, KeyCode);
454
+ FSlateApplication::Get().ProcessKeyUpEvent(KeyUpEvent);
455
+ }
456
+
457
+ bSuccess = true;
458
+ Message = FString::Printf(TEXT("Simulated input for key: %s"), *KeyName);
459
+ } else {
460
+ Message = FString::Printf(TEXT("Invalid key name: %s"), *KeyName);
461
+ ErrorCode = TEXT("INVALID_KEY");
462
+ Resp->SetStringField(TEXT("error"), Message);
463
+ }
464
+ } else if (LowerSub == TEXT("create_hud")) {
465
+ FString WidgetPath;
466
+ Payload->TryGetStringField(TEXT("widgetPath"), WidgetPath);
467
+ UClass *WidgetClass = LoadClass<UUserWidget>(nullptr, *WidgetPath);
468
+ if (WidgetClass && GEngine && GEngine->GameViewport) {
469
+ UWorld *World = GEngine->GameViewport->GetWorld();
470
+ if (World) {
471
+ UUserWidget *Widget = CreateWidget<UUserWidget>(World, WidgetClass);
472
+ if (Widget) {
473
+ Widget->AddToViewport();
474
+ bSuccess = true;
475
+ Message = TEXT("HUD created and added to viewport");
476
+ Resp->SetStringField(TEXT("widgetName"), Widget->GetName());
477
+ } else {
478
+ Message = TEXT("Failed to create widget");
479
+ ErrorCode = TEXT("CREATE_FAILED");
480
+ }
481
+ } else {
482
+ Message = TEXT("No world context found (is PIE running?)");
483
+ ErrorCode = TEXT("NO_WORLD");
484
+ }
485
+ } else {
486
+ Message =
487
+ FString::Printf(TEXT("Failed to load widget class: %s"), *WidgetPath);
488
+ ErrorCode = TEXT("CLASS_NOT_FOUND");
489
+ }
490
+ } else if (LowerSub == TEXT("set_widget_text")) {
491
+ FString Key, Value;
492
+ Payload->TryGetStringField(TEXT("key"), Key);
493
+ Payload->TryGetStringField(TEXT("value"), Value);
494
+
495
+ bool bFound = false;
496
+ // Iterate all widgets to find one matching Key (Name)
497
+ TArray<UUserWidget *> Widgets;
498
+ UWidgetBlueprintLibrary::GetAllWidgetsOfClass(
499
+ GEditor->GetEditorWorldContext().World(), Widgets,
500
+ UUserWidget::StaticClass(), false);
501
+ // Also try Game Viewport world if Editor World is not right context (PIE)
502
+ if (GEngine && GEngine->GameViewport && GEngine->GameViewport->GetWorld()) {
503
+ UWidgetBlueprintLibrary::GetAllWidgetsOfClass(
504
+ GEngine->GameViewport->GetWorld(), Widgets,
505
+ UUserWidget::StaticClass(), false);
506
+ }
507
+
508
+ for (UUserWidget *Widget : Widgets) {
509
+ // Search inside this widget for a TextBlock named Key
510
+ UWidget *Child = Widget->GetWidgetFromName(FName(*Key));
511
+ if (UTextBlock *TextBlock = Cast<UTextBlock>(Child)) {
512
+ TextBlock->SetText(FText::FromString(Value));
513
+ bFound = true;
514
+ bSuccess = true;
515
+ Message =
516
+ FString::Printf(TEXT("Set text on '%s' to '%s'"), *Key, *Value);
517
+ break;
518
+ }
519
+ // Also check if the widget ITSELF is the one (though UserWidget !=
520
+ // TextBlock usually)
521
+ if (Widget->GetName() == Key) {
522
+ // Can't set text on UserWidget directly unless it implements interface?
523
+ // Assuming Key refers to child widget name usually
524
+ }
525
+ }
526
+
527
+ if (!bFound) {
528
+ // Fallback: Use TObjectIterator to find ANY UTextBlock with that name,
529
+ // risky but covers cases
530
+ for (TObjectIterator<UTextBlock> It; It; ++It) {
531
+ if (It->GetName() == Key && It->GetWorld()) {
532
+ It->SetText(FText::FromString(Value));
533
+ bFound = true;
534
+ bSuccess = true;
535
+ Message = FString::Printf(TEXT("Set text on global '%s'"), *Key);
536
+ break;
537
+ }
538
+ }
539
+ }
540
+
541
+ if (!bFound) {
542
+ Message = FString::Printf(TEXT("Widget/TextBlock '%s' not found"), *Key);
543
+ ErrorCode = TEXT("WIDGET_NOT_FOUND");
544
+ }
545
+ } else if (LowerSub == TEXT("set_widget_image")) {
546
+ FString Key, TexturePath;
547
+ Payload->TryGetStringField(TEXT("key"), Key);
548
+ Payload->TryGetStringField(TEXT("texturePath"), TexturePath);
549
+ UTexture2D *Texture = LoadObject<UTexture2D>(nullptr, *TexturePath);
550
+ if (Texture) {
551
+ bool bFound = false;
552
+ for (TObjectIterator<UImage> It; It; ++It) {
553
+ if (It->GetName() == Key && It->GetWorld()) {
554
+ It->SetBrushFromTexture(Texture);
555
+ bFound = true;
556
+ bSuccess = true;
557
+ Message = FString::Printf(TEXT("Set image on '%s'"), *Key);
558
+ break;
559
+ }
560
+ }
561
+ if (!bFound) {
562
+ Message = FString::Printf(TEXT("Image widget '%s' not found"), *Key);
563
+ ErrorCode = TEXT("WIDGET_NOT_FOUND");
564
+ }
565
+ } else {
566
+ Message = TEXT("Failed to load texture");
567
+ ErrorCode = TEXT("ASSET_NOT_FOUND");
568
+ }
569
+ } else if (LowerSub == TEXT("set_widget_visibility")) {
570
+ FString Key;
571
+ bool bVisible = true;
572
+ Payload->TryGetStringField(TEXT("key"), Key);
573
+ Payload->TryGetBoolField(TEXT("visible"), bVisible);
574
+
575
+ bool bFound = false;
576
+ // Try UserWidgets
577
+ for (TObjectIterator<UUserWidget> It; It; ++It) {
578
+ if (It->GetName() == Key && It->GetWorld()) {
579
+ It->SetVisibility(bVisible ? ESlateVisibility::Visible
580
+ : ESlateVisibility::Collapsed);
581
+ bFound = true;
582
+ bSuccess = true;
583
+ break;
584
+ }
585
+ }
586
+ // If not found, try generic UWidget
587
+ if (!bFound) {
588
+ for (TObjectIterator<UWidget> It; It; ++It) {
589
+ if (It->GetName() == Key && It->GetWorld()) {
590
+ It->SetVisibility(bVisible ? ESlateVisibility::Visible
591
+ : ESlateVisibility::Collapsed);
592
+ bFound = true;
593
+ bSuccess = true;
594
+ break;
595
+ }
596
+ }
597
+ }
598
+
599
+ if (bFound) {
600
+ Message = FString::Printf(TEXT("Set visibility on '%s' to %s"), *Key,
601
+ bVisible ? TEXT("Visible") : TEXT("Collapsed"));
602
+ } else {
603
+ Message = FString::Printf(TEXT("Widget '%s' not found"), *Key);
604
+ ErrorCode = TEXT("WIDGET_NOT_FOUND");
605
+ }
606
+ } else if (LowerSub == TEXT("remove_widget_from_viewport")) {
607
+ FString Key;
608
+ Payload->TryGetStringField(TEXT("key"),
609
+ Key); // If empty, remove all? OR specific
610
+
611
+ if (Key.IsEmpty()) {
612
+ // Remove all user widgets?
613
+ TArray<UUserWidget *> TempWidgets;
614
+ UWidgetBlueprintLibrary::GetAllWidgetsOfClass(
615
+ GEditor->GetEditorWorldContext().World(), TempWidgets,
616
+ UUserWidget::StaticClass(), true);
617
+ // Implementation:
618
+ if (GEngine && GEngine->GameViewport &&
619
+ GEngine->GameViewport->GetWorld()) {
620
+ TArray<UUserWidget *> Widgets;
621
+ UWidgetBlueprintLibrary::GetAllWidgetsOfClass(
622
+ GEngine->GameViewport->GetWorld(), Widgets,
623
+ UUserWidget::StaticClass(), true);
624
+ for (UUserWidget *W : Widgets) {
625
+ W->RemoveFromParent();
626
+ }
627
+ bSuccess = true;
628
+ Message = TEXT("Removed all widgets");
629
+ }
630
+ } else {
631
+ bool bFound = false;
632
+ for (TObjectIterator<UUserWidget> It; It; ++It) {
633
+ if (It->GetName() == Key && It->GetWorld()) {
634
+ It->RemoveFromParent();
635
+ bFound = true;
636
+ bSuccess = true;
637
+ break;
638
+ }
639
+ }
640
+ if (bFound) {
641
+ Message = FString::Printf(TEXT("Removed widget '%s'"), *Key);
642
+ } else {
643
+ Message = FString::Printf(TEXT("Widget '%s' not found"), *Key);
644
+ ErrorCode = TEXT("WIDGET_NOT_FOUND");
645
+ }
646
+ }
647
+ } else {
648
+ Message = FString::Printf(
649
+ TEXT("System control action '%s' not implemented"), *LowerSub);
650
+ ErrorCode = TEXT("NOT_IMPLEMENTED");
651
+ Resp->SetStringField(TEXT("error"), Message);
652
+ }
653
+ #else
654
+ Message = TEXT("System control actions require editor build.");
655
+ ErrorCode = TEXT("NOT_IMPLEMENTED");
656
+ Resp->SetStringField(TEXT("error"), Message);
657
+ #endif
658
+
659
+ Resp->SetBoolField(TEXT("success"), bSuccess);
660
+ if (Message.IsEmpty()) {
661
+ Message = bSuccess ? TEXT("System control action completed")
662
+ : TEXT("System control action failed");
663
+ }
664
+
665
+ SendAutomationResponse(RequestingSocket, RequestId, bSuccess, Message, Resp,
666
+ ErrorCode);
667
+ return true;
668
+ }