v1.22.0

[1.22.0] - 2026-04-12

Added

• batch-call command for composing multiple bridge tool invocations into one in-process batch request
• pie-tick command for deterministic PIE stepping by frame count
• inspect-anim-instance command for one-shot snapshots of live anim state machines, montages, and blend weights
• run-python-script bridge helper import support via from soft_ue_bridge import call
• replay-changes skill for Git and Perforce binary-asset conflict recovery using manual base/local/remote extraction plus offline .uasset inspection

Changed

• call-function now supports class-targeted invocation flows including class default object and transient-instance execution, plus batch JSON input
• test-tools now exercises the new automation surface for batch-call, pie-tick, inspect-anim-instance, and transient call-function
• replay-changes is now documented as a CLI skill workflow instead of a dedicated command

Fixed

• call-function latent-function rejection now uses a portable LatentActionInfo struct-name check across engine versions
• inspect-anim-instance resolves state machine descriptors more reliably and avoids engine-version-specific transition query breakage during bridge builds
• public CLI export sync now hard-fails if embargoed private names appear in examples, docs, tests, prompts, or code

pip install soft-ue-cli==1.22.0

v1.21.0

Added

• query-enum command for UserDefinedEnum introspection: authored names, display names, tooltips, and numeric values
• query-struct command for UserDefinedStruct introspection: authored member names, defaults, metadata, and reflected type info
• blueprint-to-cpp skill now starts with dependency-first planning guidance, including enum/struct inspection and promotion-first conversion strategy

Fixed

• query-asset --asset-path now inspects UserDefinedEnum and UserDefinedStruct assets instead of failing with a generic load error
• query-asset --asset-path now inspects Blueprint-generated UDataAsset / UPrimaryDataAsset assets via their generated class default object
• capture-screenshot tab --window-name ... now falls back to visible tab labels and matching top-level window titles, so asset editor tabs opened by label can be captured more reliably

Changed

• Removed the standalone inspect-uasset skill prompt; offline .uasset inspection remains available as a command and as part of test-tools

Install: pip install soft-ue-cli==1.21.0

v1.20.6

Changed

• Clarified inspect-uasset and diff-uasset help text, skill metadata, and README wording: they operate on local .uasset files offline, with best support currently for Blueprint assets rather than Blueprint-only support.

Install

pip install soft-ue-cli==1.20.6

v1.20.5

Fixed

• open-asset no longer dereferences a stale UWorld pointer after LoadLevel(), fixing the access violation that could occur when loading World assets through the level editor path.

Install

pip install soft-ue-cli==1.20.5

v1.20.4

Fixed

• inspect-uasset and diff-uasset now parse UE 5.4+ package headers (LegacyFileVersion -8/-9), so offline Blueprint inspection works on modern UE 5.4-5.7 assets instead of failing on the package summary.

Install

pip install soft-ue-cli==1.20.4

v1.20.3

Fixed

• Public repo README.md and CHANGELOG.md are no longer stripped of newlines during sync, so the GitHub project page and PyPI description render correctly again (regression introduced in 1.20.0)

Install

pip install soft-ue-cli==1.20.3

v1.20.2

Fixed

• get-config-value and validate-config-key now share the same resolved section-entry lookup path, allowing bridge reads for keys such as r.Bloom that may not round-trip through GConfig->GetString()
• test-tools now validates set-config-value against the bridge tool's actual {status:ok} response payload instead of expecting a nonexistent success field

Changed

• test-tools now resolves offline .uasset paths from get-project-info.project_directory and the asset path created earlier in the run, so inspect-uasset and diff-uasset exercise the saved asset directly
• test-tools now seeds a project config key before running config get --search, so the offline config search path is exercised against known on-disk input

Install:
pip install soft-ue-cli==1.20.2

v1.20.1

Fixed

• Bridge config tools now use public FConfigCacheIni section accessors instead of the unavailable GetSectionPrivate() helper, fixing UE builds that failed when compiling get-config-value and validate-config-key

Changed

• test-tools skill now exercises the new config bridge tools and CLI config subcommands during live integration runs

Install:
pip install soft-ue-cli==1.20.1

v1.18.0

[1.18.0] - 2026-04-08

Fixed

• CLI argument validation: capture-screenshot --region and add-graph-node --position now fail with a clear comma-separated-integer error instead of surfacing a raw Python ValueError
• CLI argument validation: query-mpc --value now reports a friendly numeric/JSON parsing error for malformed scalar input instead of crashing with a raw ValueError

Install with: pip install soft-ue-cli==1.18.0

v1.17.0

Fixed

• report-bug and request-feature: gh auth token lookup now times out cleanly instead of hanging indefinitely when GitHub CLI credentials are unavailable or blocked
• MCP schema: set-property now accepts any JSON value for value, matching the CLI and bridge behavior for scalar, array, and object payloads
• MCP server: add-graph-node now maps --no-auto-position correctly, surfaces normalized node_guid values for special node creation cases, and returns cleaner client-side command errors
• MCP server: pie-session start now forwards tool-level timeout to the HTTP request and attempts a best-effort stop after startup timeouts to avoid leaving PIE half-initialized
• test-tools: teardown now treats delete-asset reporting Asset not found as an idempotent success during cleanup
• test-tools: insights-capture stop now treats already-idle or auto-stopped traces as a pass in both CLI and MCP paths
• test-tools: MCP all-mode now reads mcp-serve stdout as UTF-8 with replacement semantics, retries the first temporary level open, and saves the temporary level before restore to avoid modal prompts
• open-asset: World assets now load through the level editor path with extra GC passes, reducing map-switch crashes and stale-world failures during automation
• pie-session: start/stop now return request-based transitional states instead of blocking the request thread while UE finishes entering or leaving PIE
• insights-capture: trace start now uses the documented filename-first console command form and stop/status treat already-idle traces consistently

Install with:
pip install soft-ue-cli==1.17.0