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,898 @@
1
+ import { AutomationBridge } from '../automation/index.js';
2
+ export interface IBaseTool {
3
+ getAutomationBridge(): AutomationBridge;
4
+ }
5
+ export interface StandardActionResponse<T = any> {
6
+ success: boolean;
7
+ data?: T;
8
+ warnings?: string[];
9
+ error?: {
10
+ code: string;
11
+ message: string;
12
+ [key: string]: unknown;
13
+ } | null;
14
+ [key: string]: unknown;
15
+ }
16
+ export interface IActorTools {
17
+ spawn(params: {
18
+ classPath: string;
19
+ location?: {
20
+ x: number;
21
+ y: number;
22
+ z: number;
23
+ };
24
+ rotation?: {
25
+ pitch: number;
26
+ yaw: number;
27
+ roll: number;
28
+ };
29
+ actorName?: string;
30
+ meshPath?: string;
31
+ timeoutMs?: number;
32
+ }): Promise<StandardActionResponse>;
33
+ delete(params: {
34
+ actorName?: string;
35
+ actorNames?: string[];
36
+ }): Promise<StandardActionResponse>;
37
+ applyForce(params: {
38
+ actorName: string;
39
+ force: {
40
+ x: number;
41
+ y: number;
42
+ z: number;
43
+ };
44
+ }): Promise<StandardActionResponse>;
45
+ spawnBlueprint(params: {
46
+ blueprintPath: string;
47
+ actorName?: string;
48
+ location?: {
49
+ x: number;
50
+ y: number;
51
+ z: number;
52
+ };
53
+ rotation?: {
54
+ pitch: number;
55
+ yaw: number;
56
+ roll: number;
57
+ };
58
+ }): Promise<StandardActionResponse>;
59
+ setTransform(params: {
60
+ actorName: string;
61
+ location?: {
62
+ x: number;
63
+ y: number;
64
+ z: number;
65
+ };
66
+ rotation?: {
67
+ pitch: number;
68
+ yaw: number;
69
+ roll: number;
70
+ };
71
+ scale?: {
72
+ x: number;
73
+ y: number;
74
+ z: number;
75
+ };
76
+ }): Promise<StandardActionResponse>;
77
+ getTransform(actorName: string): Promise<StandardActionResponse>;
78
+ setVisibility(params: {
79
+ actorName: string;
80
+ visible: boolean;
81
+ }): Promise<StandardActionResponse>;
82
+ addComponent(params: {
83
+ actorName: string;
84
+ componentType: string;
85
+ componentName?: string;
86
+ properties?: Record<string, unknown>;
87
+ }): Promise<StandardActionResponse>;
88
+ setComponentProperties(params: {
89
+ actorName: string;
90
+ componentName: string;
91
+ properties: Record<string, unknown>;
92
+ }): Promise<StandardActionResponse>;
93
+ getComponents(actorName: string): Promise<StandardActionResponse>;
94
+ duplicate(params: {
95
+ actorName: string;
96
+ newName?: string;
97
+ offset?: {
98
+ x: number;
99
+ y: number;
100
+ z: number;
101
+ };
102
+ }): Promise<StandardActionResponse>;
103
+ addTag(params: {
104
+ actorName: string;
105
+ tag: string;
106
+ }): Promise<StandardActionResponse>;
107
+ removeTag(params: {
108
+ actorName: string;
109
+ tag: string;
110
+ }): Promise<StandardActionResponse>;
111
+ findByTag(params: {
112
+ tag: string;
113
+ matchType?: string;
114
+ }): Promise<StandardActionResponse>;
115
+ findByName(name: string): Promise<StandardActionResponse>;
116
+ detach(actorName: string): Promise<StandardActionResponse>;
117
+ attach(params: {
118
+ childActor: string;
119
+ parentActor: string;
120
+ }): Promise<StandardActionResponse>;
121
+ deleteByTag(tag: string): Promise<StandardActionResponse>;
122
+ setBlueprintVariables(params: {
123
+ actorName: string;
124
+ variables: Record<string, unknown>;
125
+ }): Promise<StandardActionResponse>;
126
+ createSnapshot(params: {
127
+ actorName: string;
128
+ snapshotName: string;
129
+ }): Promise<StandardActionResponse>;
130
+ restoreSnapshot(params: {
131
+ actorName: string;
132
+ snapshotName: string;
133
+ }): Promise<StandardActionResponse>;
134
+ listActors(params?: {
135
+ filter?: string;
136
+ }): Promise<StandardActionResponse>;
137
+ getMetadata(actorName: string): Promise<StandardActionResponse>;
138
+ exportActor(params: {
139
+ actorName: string;
140
+ destinationPath?: string;
141
+ }): Promise<StandardActionResponse>;
142
+ getBoundingBox(actorName: string): Promise<StandardActionResponse>;
143
+ }
144
+ export interface SourceControlState {
145
+ isCheckedOut: boolean;
146
+ isAdded: boolean;
147
+ isDeleted: boolean;
148
+ isModified: boolean;
149
+ whoCheckedOut?: string;
150
+ }
151
+ export interface IAssetTools {
152
+ importAsset(params: {
153
+ sourcePath: string;
154
+ destinationPath: string;
155
+ overwrite?: boolean;
156
+ save?: boolean;
157
+ }): Promise<any>;
158
+ createFolder(path: string): Promise<any>;
159
+ duplicateAsset(params: {
160
+ sourcePath: string;
161
+ destinationPath: string;
162
+ overwrite?: boolean;
163
+ }): Promise<any>;
164
+ renameAsset(params: {
165
+ sourcePath: string;
166
+ destinationPath: string;
167
+ }): Promise<any>;
168
+ moveAsset(params: {
169
+ sourcePath: string;
170
+ destinationPath: string;
171
+ }): Promise<any>;
172
+ deleteAssets(params: {
173
+ paths: string[];
174
+ fixupRedirectors?: boolean;
175
+ timeoutMs?: number;
176
+ }): Promise<any>;
177
+ searchAssets(params: {
178
+ classNames?: string[];
179
+ packagePaths?: string[];
180
+ recursivePaths?: boolean;
181
+ recursiveClasses?: boolean;
182
+ limit?: number;
183
+ }): Promise<any>;
184
+ saveAsset(assetPath: string): Promise<any>;
185
+ findByTag(params: {
186
+ tag: string;
187
+ value?: string;
188
+ }): Promise<any>;
189
+ getDependencies(params: {
190
+ assetPath: string;
191
+ recursive?: boolean;
192
+ }): Promise<any>;
193
+ getMetadata(params: {
194
+ assetPath: string;
195
+ }): Promise<any>;
196
+ getSourceControlState(params: {
197
+ assetPath: string;
198
+ }): Promise<SourceControlState | any>;
199
+ analyzeGraph(params: {
200
+ assetPath: string;
201
+ maxDepth?: number;
202
+ }): Promise<any>;
203
+ createThumbnail(params: {
204
+ assetPath: string;
205
+ width?: number;
206
+ height?: number;
207
+ }): Promise<any>;
208
+ setTags(params: {
209
+ assetPath: string;
210
+ tags: string[];
211
+ }): Promise<any>;
212
+ generateReport(params: {
213
+ directory: string;
214
+ reportType?: string;
215
+ outputPath?: string;
216
+ }): Promise<any>;
217
+ validate(params: {
218
+ assetPath: string;
219
+ }): Promise<any>;
220
+ generateLODs(params: {
221
+ assetPath: string;
222
+ lodCount: number;
223
+ reductionSettings?: Record<string, unknown>;
224
+ }): Promise<any>;
225
+ }
226
+ export interface ISequenceTools {
227
+ create(params: {
228
+ name: string;
229
+ path?: string;
230
+ timeoutMs?: number;
231
+ }): Promise<any>;
232
+ open(params: {
233
+ path: string;
234
+ }): Promise<any>;
235
+ addCamera(params: {
236
+ spawnable?: boolean;
237
+ path?: string;
238
+ }): Promise<any>;
239
+ addActor(params: {
240
+ actorName: string;
241
+ createBinding?: boolean;
242
+ path?: string;
243
+ }): Promise<any>;
244
+ addActors(params: {
245
+ actorNames: string[];
246
+ path?: string;
247
+ }): Promise<any>;
248
+ removeActors(params: {
249
+ actorNames: string[];
250
+ path?: string;
251
+ }): Promise<any>;
252
+ getBindings(params: {
253
+ path?: string;
254
+ }): Promise<any>;
255
+ addSpawnableFromClass(params: {
256
+ className: string;
257
+ path?: string;
258
+ }): Promise<any>;
259
+ play(params: {
260
+ path?: string;
261
+ startTime?: number;
262
+ loopMode?: 'once' | 'loop' | 'pingpong';
263
+ }): Promise<any>;
264
+ pause(params?: {
265
+ path?: string;
266
+ }): Promise<any>;
267
+ stop(params?: {
268
+ path?: string;
269
+ }): Promise<any>;
270
+ setSequenceProperties(params: {
271
+ path?: string;
272
+ frameRate?: number;
273
+ lengthInFrames?: number;
274
+ playbackStart?: number;
275
+ playbackEnd?: number;
276
+ }): Promise<any>;
277
+ getSequenceProperties(params: {
278
+ path?: string;
279
+ }): Promise<any>;
280
+ setPlaybackSpeed(params: {
281
+ speed: number;
282
+ path?: string;
283
+ }): Promise<any>;
284
+ list(params: {
285
+ path?: string;
286
+ }): Promise<any>;
287
+ duplicate(params: {
288
+ path: string;
289
+ destinationPath: string;
290
+ }): Promise<any>;
291
+ rename(params: {
292
+ path: string;
293
+ newName: string;
294
+ }): Promise<any>;
295
+ deleteSequence(params: {
296
+ path: string;
297
+ }): Promise<any>;
298
+ getMetadata(params: {
299
+ path: string;
300
+ }): Promise<any>;
301
+ listTracks(params: {
302
+ path: string;
303
+ }): Promise<any>;
304
+ setWorkRange(params: {
305
+ path?: string;
306
+ start: number;
307
+ end: number;
308
+ }): Promise<any>;
309
+ }
310
+ export interface IAssetResources {
311
+ list(directory?: string, recursive?: boolean, limit?: number): Promise<any>;
312
+ }
313
+ export interface IBlueprintTools {
314
+ createBlueprint(params: {
315
+ name: string;
316
+ blueprintType?: string;
317
+ savePath?: string;
318
+ parentClass?: string;
319
+ properties?: Record<string, unknown>;
320
+ timeoutMs?: number;
321
+ waitForCompletion?: boolean;
322
+ waitForCompletionTimeoutMs?: number;
323
+ }): Promise<any>;
324
+ modifyConstructionScript(params: {
325
+ blueprintPath: string;
326
+ operations: any[];
327
+ compile?: boolean;
328
+ save?: boolean;
329
+ timeoutMs?: number;
330
+ waitForCompletion?: boolean;
331
+ waitForCompletionTimeoutMs?: number;
332
+ }): Promise<any>;
333
+ addComponent(params: {
334
+ blueprintName: string;
335
+ componentType: string;
336
+ componentName: string;
337
+ attachTo?: string;
338
+ transform?: Record<string, unknown>;
339
+ properties?: Record<string, unknown>;
340
+ compile?: boolean;
341
+ save?: boolean;
342
+ timeoutMs?: number;
343
+ waitForCompletion?: boolean;
344
+ waitForCompletionTimeoutMs?: number;
345
+ }): Promise<any>;
346
+ waitForBlueprint(blueprintRef: string | string[], timeoutMs?: number): Promise<any>;
347
+ getBlueprint(params: {
348
+ blueprintName: string;
349
+ timeoutMs?: number;
350
+ }): Promise<any>;
351
+ getBlueprintInfo(params: {
352
+ blueprintPath: string;
353
+ timeoutMs?: number;
354
+ }): Promise<any>;
355
+ probeSubobjectDataHandle(opts?: {
356
+ componentClass?: string;
357
+ }): Promise<any>;
358
+ setBlueprintDefault(params: {
359
+ blueprintName: string;
360
+ propertyName: string;
361
+ value: unknown;
362
+ }): Promise<any>;
363
+ addVariable(params: {
364
+ blueprintName: string;
365
+ variableName: string;
366
+ variableType: string;
367
+ defaultValue?: any;
368
+ category?: string;
369
+ isReplicated?: boolean;
370
+ isPublic?: boolean;
371
+ variablePinType?: Record<string, unknown>;
372
+ timeoutMs?: number;
373
+ waitForCompletion?: boolean;
374
+ waitForCompletionTimeoutMs?: number;
375
+ }): Promise<any>;
376
+ removeVariable(params: {
377
+ blueprintName: string;
378
+ variableName: string;
379
+ timeoutMs?: number;
380
+ waitForCompletion?: boolean;
381
+ waitForCompletionTimeoutMs?: number;
382
+ }): Promise<any>;
383
+ renameVariable(params: {
384
+ blueprintName: string;
385
+ oldName: string;
386
+ newName: string;
387
+ timeoutMs?: number;
388
+ waitForCompletion?: boolean;
389
+ waitForCompletionTimeoutMs?: number;
390
+ }): Promise<any>;
391
+ addEvent(params: {
392
+ blueprintName: string;
393
+ eventType: string;
394
+ customEventName?: string;
395
+ parameters?: Array<{
396
+ name: string;
397
+ type: string;
398
+ }>;
399
+ timeoutMs?: number;
400
+ waitForCompletion?: boolean;
401
+ waitForCompletionTimeoutMs?: number;
402
+ }): Promise<any>;
403
+ removeEvent(params: {
404
+ blueprintName: string;
405
+ eventName: string;
406
+ customEventName?: string;
407
+ timeoutMs?: number;
408
+ waitForCompletion?: boolean;
409
+ waitForCompletionTimeoutMs?: number;
410
+ }): Promise<any>;
411
+ addFunction(params: {
412
+ blueprintName: string;
413
+ functionName: string;
414
+ inputs?: Array<{
415
+ name: string;
416
+ type: string;
417
+ }>;
418
+ outputs?: Array<{
419
+ name: string;
420
+ type: string;
421
+ }>;
422
+ isPublic?: boolean;
423
+ category?: string;
424
+ timeoutMs?: number;
425
+ waitForCompletion?: boolean;
426
+ waitForCompletionTimeoutMs?: number;
427
+ }): Promise<any>;
428
+ setVariableMetadata(params: {
429
+ blueprintName: string;
430
+ variableName: string;
431
+ metadata: Record<string, unknown>;
432
+ timeoutMs?: number;
433
+ }): Promise<any>;
434
+ renameVariable(params: {
435
+ blueprintName: string;
436
+ oldName: string;
437
+ newName: string;
438
+ timeoutMs?: number;
439
+ waitForCompletion?: boolean;
440
+ waitForCompletionTimeoutMs?: number;
441
+ }): Promise<any>;
442
+ addConstructionScript(params: {
443
+ blueprintName: string;
444
+ scriptName: string;
445
+ timeoutMs?: number;
446
+ waitForCompletion?: boolean;
447
+ waitForCompletionTimeoutMs?: number;
448
+ }): Promise<any>;
449
+ compileBlueprint(params: {
450
+ blueprintName: string;
451
+ saveAfterCompile?: boolean;
452
+ }): Promise<any>;
453
+ getBlueprintSCS(params: {
454
+ blueprintPath: string;
455
+ timeoutMs?: number;
456
+ }): Promise<any>;
457
+ addSCSComponent(params: {
458
+ blueprintPath: string;
459
+ componentClass: string;
460
+ componentName: string;
461
+ parentComponent?: string;
462
+ meshPath?: string;
463
+ materialPath?: string;
464
+ timeoutMs?: number;
465
+ }): Promise<any>;
466
+ removeSCSComponent(params: {
467
+ blueprintPath: string;
468
+ componentName: string;
469
+ timeoutMs?: number;
470
+ }): Promise<any>;
471
+ reparentSCSComponent(params: {
472
+ blueprintPath: string;
473
+ componentName: string;
474
+ newParent: string;
475
+ timeoutMs?: number;
476
+ }): Promise<any>;
477
+ setSCSComponentTransform(params: {
478
+ blueprintPath: string;
479
+ componentName: string;
480
+ location?: [number, number, number];
481
+ rotation?: [number, number, number];
482
+ scale?: [number, number, number];
483
+ timeoutMs?: number;
484
+ }): Promise<any>;
485
+ setSCSComponentProperty(params: {
486
+ blueprintPath: string;
487
+ componentName: string;
488
+ propertyName: string;
489
+ propertyValue: any;
490
+ timeoutMs?: number;
491
+ }): Promise<any>;
492
+ addNode(params: {
493
+ blueprintName: string;
494
+ nodeType: string;
495
+ graphName?: string;
496
+ functionName?: string;
497
+ variableName?: string;
498
+ nodeName?: string;
499
+ eventName?: string;
500
+ memberClass?: string;
501
+ posX?: number;
502
+ posY?: number;
503
+ timeoutMs?: number;
504
+ }): Promise<any>;
505
+ connectPins(params: {
506
+ blueprintName: string;
507
+ sourceNodeGuid: string;
508
+ targetNodeGuid: string;
509
+ sourcePinName?: string;
510
+ targetPinName?: string;
511
+ timeoutMs?: number;
512
+ }): Promise<any>;
513
+ }
514
+ export interface ILevelTools {
515
+ listLevels(): Promise<any>;
516
+ getLevelSummary(levelPath?: string): Promise<any>;
517
+ registerLight(levelPath: string | undefined, info: {
518
+ name: string;
519
+ type: string;
520
+ details?: Record<string, unknown>;
521
+ }): void;
522
+ exportLevel(params: {
523
+ levelPath?: string;
524
+ exportPath: string;
525
+ note?: string;
526
+ timeoutMs?: number;
527
+ }): Promise<any>;
528
+ importLevel(params: {
529
+ packagePath: string;
530
+ destinationPath?: string;
531
+ streaming?: boolean;
532
+ timeoutMs?: number;
533
+ }): Promise<any>;
534
+ saveLevelAs(params: {
535
+ sourcePath?: string;
536
+ targetPath: string;
537
+ }): Promise<any>;
538
+ deleteLevels(params: {
539
+ levelPaths: string[];
540
+ }): Promise<any>;
541
+ loadLevel(params: {
542
+ levelPath: string;
543
+ streaming?: boolean;
544
+ position?: [number, number, number];
545
+ }): Promise<any>;
546
+ saveLevel(params: {
547
+ levelName?: string;
548
+ savePath?: string;
549
+ }): Promise<any>;
550
+ createLevel(params: {
551
+ levelName: string;
552
+ template?: 'Empty' | 'Default' | 'VR' | 'TimeOfDay';
553
+ savePath?: string;
554
+ }): Promise<any>;
555
+ addSubLevel(params: {
556
+ parentLevel?: string;
557
+ subLevelPath: string;
558
+ streamingMethod?: 'Blueprint' | 'AlwaysLoaded';
559
+ }): Promise<any>;
560
+ streamLevel(params: {
561
+ levelPath?: string;
562
+ levelName?: string;
563
+ shouldBeLoaded: boolean;
564
+ shouldBeVisible?: boolean;
565
+ position?: [number, number, number];
566
+ }): Promise<any>;
567
+ setupWorldComposition(params: {
568
+ enableComposition: boolean;
569
+ tileSize?: number;
570
+ distanceStreaming?: boolean;
571
+ streamingDistance?: number;
572
+ }): Promise<any>;
573
+ editLevelBlueprint(params: {
574
+ eventType: 'BeginPlay' | 'EndPlay' | 'Tick' | 'Custom';
575
+ customEventName?: string;
576
+ nodes?: Array<{
577
+ nodeType: string;
578
+ position: [number, number];
579
+ connections?: string[];
580
+ }>;
581
+ }): Promise<any>;
582
+ createSubLevel(params: {
583
+ name: string;
584
+ type: 'Persistent' | 'Streaming' | 'Lighting' | 'Gameplay';
585
+ parent?: string;
586
+ }): Promise<any>;
587
+ setWorldSettings(params: {
588
+ gravity?: number;
589
+ worldScale?: number;
590
+ gameMode?: string;
591
+ defaultPawn?: string;
592
+ killZ?: number;
593
+ }): Promise<any>;
594
+ setLevelBounds(params: {
595
+ min: [number, number, number];
596
+ max: [number, number, number];
597
+ }): Promise<any>;
598
+ buildNavMesh(params: {
599
+ rebuildAll?: boolean;
600
+ selectedOnly?: boolean;
601
+ }): Promise<any>;
602
+ setLevelVisibility(params: {
603
+ levelName: string;
604
+ visible: boolean;
605
+ }): Promise<any>;
606
+ setWorldOrigin(params: {
607
+ location: [number, number, number];
608
+ }): Promise<any>;
609
+ createStreamingVolume(params: {
610
+ levelName: string;
611
+ position: [number, number, number];
612
+ size: [number, number, number];
613
+ streamingDistance?: number;
614
+ }): Promise<any>;
615
+ setLevelLOD(params: {
616
+ levelName: string;
617
+ lodLevel: number;
618
+ distance: number;
619
+ }): Promise<any>;
620
+ }
621
+ export interface IEditorTools {
622
+ isInPIE(): Promise<boolean>;
623
+ ensureNotInPIE(): Promise<void>;
624
+ playInEditor(timeoutMs?: number): Promise<any>;
625
+ stopPlayInEditor(): Promise<any>;
626
+ pausePlayInEditor(): Promise<any>;
627
+ pauseInEditor(): Promise<any>;
628
+ buildLighting(): Promise<any>;
629
+ setViewportCamera(location?: {
630
+ x: number;
631
+ y: number;
632
+ z: number;
633
+ } | [number, number, number] | null | undefined, rotation?: {
634
+ pitch: number;
635
+ yaw: number;
636
+ roll: number;
637
+ } | [number, number, number] | null | undefined): Promise<any>;
638
+ setCameraSpeed(speed: number): Promise<any>;
639
+ setFOV(fov: number): Promise<any>;
640
+ takeScreenshot(filename?: string, resolution?: string): Promise<any>;
641
+ resumePlayInEditor(): Promise<any>;
642
+ stepPIEFrame(steps?: number): Promise<any>;
643
+ startRecording(options?: {
644
+ filename?: string;
645
+ frameRate?: number;
646
+ durationSeconds?: number;
647
+ metadata?: Record<string, unknown>;
648
+ }): Promise<any>;
649
+ stopRecording(): Promise<any>;
650
+ createCameraBookmark(name: string): Promise<any>;
651
+ jumpToCameraBookmark(name: string): Promise<any>;
652
+ setEditorPreferences(category: string | undefined, preferences: Record<string, unknown>): Promise<any>;
653
+ setViewportResolution(width: number, height: number): Promise<any>;
654
+ executeConsoleCommand(command: string): Promise<any>;
655
+ }
656
+ export interface IEnvironmentTools {
657
+ setTimeOfDay(hour: unknown): Promise<any>;
658
+ setSunIntensity(intensity: unknown): Promise<any>;
659
+ setSkylightIntensity(intensity: unknown): Promise<any>;
660
+ exportSnapshot(params: {
661
+ path?: unknown;
662
+ filename?: unknown;
663
+ }): Promise<any>;
664
+ importSnapshot(params: {
665
+ path?: unknown;
666
+ filename?: unknown;
667
+ }): Promise<any>;
668
+ cleanup(params?: {
669
+ names?: unknown;
670
+ }): Promise<any>;
671
+ }
672
+ export interface ILandscapeTools {
673
+ createLandscape(params: {
674
+ name: string;
675
+ location?: [number, number, number];
676
+ sizeX?: number;
677
+ sizeY?: number;
678
+ quadsPerSection?: number;
679
+ sectionsPerComponent?: number;
680
+ componentCount?: number;
681
+ materialPath?: string;
682
+ enableWorldPartition?: boolean;
683
+ runtimeGrid?: string;
684
+ isSpatiallyLoaded?: boolean;
685
+ dataLayers?: string[];
686
+ }): Promise<any>;
687
+ sculptLandscape(params: {
688
+ landscapeName: string;
689
+ tool: string;
690
+ brushSize?: number;
691
+ brushFalloff?: number;
692
+ strength?: number;
693
+ location?: [number, number, number];
694
+ radius?: number;
695
+ }): Promise<any>;
696
+ paintLandscape(params: {
697
+ landscapeName: string;
698
+ layerName: string;
699
+ position: [number, number, number];
700
+ brushSize?: number;
701
+ strength?: number;
702
+ targetValue?: number;
703
+ radius?: number;
704
+ density?: number;
705
+ }): Promise<any>;
706
+ createProceduralTerrain(params: {
707
+ name: string;
708
+ location?: [number, number, number];
709
+ subdivisions?: number;
710
+ heightFunction?: string;
711
+ material?: string;
712
+ settings?: Record<string, unknown>;
713
+ }): Promise<any>;
714
+ createLandscapeGrassType(params: {
715
+ name: string;
716
+ meshPath: string;
717
+ density?: number;
718
+ minScale?: number;
719
+ maxScale?: number;
720
+ path?: string;
721
+ staticMesh?: string;
722
+ }): Promise<any>;
723
+ setLandscapeMaterial(params: {
724
+ landscapeName: string;
725
+ materialPath: string;
726
+ }): Promise<any>;
727
+ modifyHeightmap(params: {
728
+ landscapeName: string;
729
+ heightData: number[];
730
+ minX: number;
731
+ minY: number;
732
+ maxX: number;
733
+ maxY: number;
734
+ updateNormals?: boolean;
735
+ }): Promise<any>;
736
+ }
737
+ export interface IFoliageTools {
738
+ addFoliageType(params: {
739
+ name: string;
740
+ meshPath: string;
741
+ density?: number;
742
+ radius?: number;
743
+ minScale?: number;
744
+ maxScale?: number;
745
+ alignToNormal?: boolean;
746
+ randomYaw?: boolean;
747
+ groundSlope?: number;
748
+ }): Promise<any>;
749
+ addFoliage(params: {
750
+ foliageType: string;
751
+ locations: Array<{
752
+ x: number;
753
+ y: number;
754
+ z: number;
755
+ }>;
756
+ }): Promise<any>;
757
+ paintFoliage(params: {
758
+ foliageType: string;
759
+ position: [number, number, number];
760
+ brushSize?: number;
761
+ paintDensity?: number;
762
+ eraseMode?: boolean;
763
+ }): Promise<any>;
764
+ createProceduralFoliage(params: {
765
+ name: string;
766
+ bounds?: {
767
+ location: {
768
+ x: number;
769
+ y: number;
770
+ z: number;
771
+ };
772
+ size: {
773
+ x: number;
774
+ y: number;
775
+ z: number;
776
+ };
777
+ };
778
+ foliageTypes?: Array<{
779
+ meshPath: string;
780
+ density: number;
781
+ minScale?: number;
782
+ maxScale?: number;
783
+ alignToNormal?: boolean;
784
+ randomYaw?: boolean;
785
+ }>;
786
+ volumeName?: string;
787
+ position?: [number, number, number];
788
+ size?: [number, number, number];
789
+ seed?: number;
790
+ tileSize?: number;
791
+ }): Promise<any>;
792
+ addFoliageInstances(params: {
793
+ foliageType: string;
794
+ transforms: Array<{
795
+ location: [number, number, number];
796
+ rotation?: [number, number, number];
797
+ scale?: [number, number, number];
798
+ }>;
799
+ }): Promise<any>;
800
+ getFoliageInstances(params: {
801
+ foliageType?: string;
802
+ }): Promise<any>;
803
+ removeFoliage(params: {
804
+ foliageType?: string;
805
+ removeAll?: boolean;
806
+ }): Promise<any>;
807
+ createInstancedMesh(params: {
808
+ name: string;
809
+ meshPath: string;
810
+ instances: Array<{
811
+ position: [number, number, number];
812
+ rotation?: [number, number, number];
813
+ scale?: [number, number, number];
814
+ }>;
815
+ enableCulling?: boolean;
816
+ cullDistance?: number;
817
+ }): Promise<any>;
818
+ setFoliageLOD(params: {
819
+ foliageType: string;
820
+ lodDistances?: number[];
821
+ screenSize?: number[];
822
+ }): Promise<any>;
823
+ setFoliageCollision(params: {
824
+ foliageType: string;
825
+ collisionEnabled?: boolean;
826
+ collisionProfile?: string;
827
+ generateOverlapEvents?: boolean;
828
+ }): Promise<any>;
829
+ createGrassSystem(params: {
830
+ name: string;
831
+ grassTypes: Array<{
832
+ meshPath: string;
833
+ density: number;
834
+ minScale?: number;
835
+ maxScale?: number;
836
+ }>;
837
+ windStrength?: number;
838
+ windSpeed?: number;
839
+ }): Promise<any>;
840
+ removeFoliageInstances(params: {
841
+ foliageType: string;
842
+ position: [number, number, number];
843
+ radius: number;
844
+ }): Promise<any>;
845
+ selectFoliageInstances(params: {
846
+ foliageType: string;
847
+ position?: [number, number, number];
848
+ radius?: number;
849
+ selectAll?: boolean;
850
+ }): Promise<any>;
851
+ updateFoliageInstances(params: {
852
+ foliageType: string;
853
+ updateTransforms?: boolean;
854
+ updateMesh?: boolean;
855
+ newMeshPath?: string;
856
+ }): Promise<any>;
857
+ createFoliageSpawner(params: {
858
+ name: string;
859
+ spawnArea: 'Landscape' | 'StaticMesh' | 'BSP' | 'Foliage' | 'All';
860
+ excludeAreas?: Array<[number, number, number, number]>;
861
+ }): Promise<any>;
862
+ optimizeFoliage(params: {
863
+ mergeInstances?: boolean;
864
+ generateClusters?: boolean;
865
+ clusterSize?: number;
866
+ reduceDrawCalls?: boolean;
867
+ }): Promise<any>;
868
+ }
869
+ export interface ITools {
870
+ actorTools: IActorTools;
871
+ assetTools: IAssetTools;
872
+ blueprintTools: IBlueprintTools;
873
+ editorTools: IEditorTools;
874
+ levelTools: ILevelTools;
875
+ sequenceTools: ISequenceTools;
876
+ assetResources: IAssetResources;
877
+ landscapeTools: ILandscapeTools;
878
+ foliageTools: IFoliageTools;
879
+ environmentTools: IEnvironmentTools;
880
+ materialTools: any;
881
+ niagaraTools: any;
882
+ animationTools: any;
883
+ physicsTools: any;
884
+ lightingTools: any;
885
+ debugTools: any;
886
+ performanceTools: any;
887
+ audioTools: any;
888
+ uiTools: any;
889
+ introspectionTools: any;
890
+ visualTools?: any;
891
+ engineTools: any;
892
+ systemTools: any;
893
+ behaviorTreeTools: any;
894
+ logTools: any;
895
+ automationBridge?: AutomationBridge;
896
+ [key: string]: any;
897
+ }
898
+ //# sourceMappingURL=tool-interfaces.d.ts.map