v1.45.0

Added

• Added all runtime-supported Chaos legacy cloth weight-map targets to cloth apply-weightmap.
• Added repeatable/comma-separated --section-index selection for merged legacy cloth while preserving weights outside selected source sections.
• Added exec-console-command --pie-instance N targeting and additive multi-world details from pie-session get-state.

Fixed

• Improved AnimGraph property-path diagnostics and rejected malformed array indices.
• Rejected incomplete Find in Blueprints results and non-positive find-references --limit values.
• Made cloth query validate imported section binding metadata and report additive binding_warnings.

pip install soft-ue-cli==1.45.0

v1.44.0

Several LLM coding sessions can now drive one Unreal Editor without taking it down under each other. The new session family gives them a shared roster derived from bridge traffic, so a session shows up holding pie from pie-session start without ever announcing itself. Advisory only -- it informs, it never blocks a command.

Added

• cloth apply-weightmap now supports the legacy anim-drive-stiffness, anim-drive-damping, backstop-distance, and backstop-radius weight-map targets in addition to max-distance.
• cloth chaos-query can now report near-vertex seam gap candidates and dump per-simulation-vertex weight values with positions.
• Added cloth chaos-set-weightmap to set Chaos Cloth Asset weight-map values by sim vertex list or spatial selection.
• cloth chaos-stitch --dry-run now reports candidate stitch pairs without mutating the asset.
• Added cloth weld to weld coincident vertices in a legacy in-mesh clothing asset's physical mesh and rebuild render mappings.
• cloth apply-weightmap now supports a legacy --rule spatial for local Z/sphere selection with constant values or Z-ramped max-distance values, and preflights bound render mappings before mutating the asset.
• Added the session command family (announce, list, broadcast, ask, answer, inbox, leave) so multiple LLM sessions sharing one editor can see each other's work and ask before disruptive operations. Advisory only — nothing is blocked.
• The session roster is derived from bridge traffic, so a session appears with its PIE state even when it never calls session announce.
• Bridge responses now carry session_notices when other sessions have something to report to the caller: on stderr for the CLI, in the result body for MCP.
• build-and-relaunch, trigger-live-coding, and pie-session stop results now list other active sessions when any exist.
• A failed connection now reports which session shut the editor down, read from .soft-ue-bridge/sessions.json, when that shutdown went through build-and-relaunch and the record is recent. A shutdown intent outlives the editor that wrote it, so an older record is reported as last-known sessions instead of being blamed for the disconnect.

Fixed

• Nested command families (cloth, anim, umg, capture, session) now report the real error reason over MCP instead of exited with code 1.

pip install soft-ue-cli==1.44.0

v1.43.1

Fixed

• SoftUEBridgeEditor now includes Editor/Transactor.h so PieSessionTool.cpp clean-builds when checking PIE-owned transaction objects.
• Added DataflowEngine to SoftUEBridgeEditor dependencies so Chaos Cloth Dataflow terminal calls link in clean builds.

Install with:

pip install soft-ue-cli==1.43.1

v1.42.0

Added

• run-python-script now accepts --args ... after CLI options and forwards those values to the executed script as sys.argv[1:].
• MCP callers can now pass script_args as an array for run-python-script.

Fixed

• Fixed a UE 5.8 bridge build break by removing the direct FJsonObject::FStringType dependency from JSON object key conversion while preserving UE 5.7 compatibility.

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

v1.41.0

Changed

• Documented UE 5.8 as the main development target while maintaining UE 5.7 compatibility.

Fixed

• set-node-property now resolves nested AnimGraph inner Node struct paths, Node.-prefixed paths, struct-array element paths, and full array replacement through the shared property serializer.
• Fixed a CLI client KeyError when a text response item omits the optional text field.
• Fixed escaped testimonial attribution output so submitted testimonials render the attribution dash correctly.
• Fixed an AnimMontage unity-build compile collision by giving inspect and slot segment JSON helpers unique names.
• Migrated UE 5.8-deprecated editor APIs for post-engine-init delegates, nested object enumeration, package-save detection, and Rewind Debugger trace-file checks while preserving UE 5.7 compatibility.

Install with:

pip install soft-ue-cli==1.41.0

v1.40.0

[1.40.0] - 2026-07-06

Added

• Added diagnose command families for asset, character, build-log, Perforce, issue, runtime probe, data validation, and handoff/report workflows.
• Added command catalog and offline smoke coverage for the new diagnostic surfaces.

Fixed

• Fixed the MCP capture-pie-screenshot compatibility alias so it routes to the canonical screenshot bridge command.
• Fixed Unicode JSON output fallback on consoles that cannot encode non-ASCII characters.
• status now reports structured unhealthy bridge diagnostics instead of failing with a generic connection result.
• mutable graph set-layout-blocks now supports parent material linkage metadata for RemoveMeshBlocks workflows and reports source layout attachment details.
• mutable graph set-node-property now preserves CustomizableObject pin links across node reconstruction.
• run-python-script and open-asset now defer risky editor work to the Slate ticker and avoid immediate garbage collection paths that could crash editor workflows.
• SoftUEBridge now builds against UE 5.8's FJsonObject shared-string key API while preserving older engine compatibility.

Install:

pip install soft-ue-cli==1.40.0

v1.39.0

Added

• Added mutable graph set-layout-blocks for headless CustomizableObject LayoutBlocks / RemoveMeshBlocks grid and block authoring.
• mutable graph set-layout-blocks can now target source mesh UV layouts with --lod-index, --section-index, and --uv-channel.

Fixed

• mutable graph add-mesh-option and mutable graph set-base-mesh now refresh soft mesh object references and pins after assigning SkeletalMesh or StaticMesh properties.
• mutable graph set-node-property now accepts 32-hex or hyphenated strings for reflected FGuid properties.
• Fixed an MSVC build break in Mutable mesh pin layout lookup caused by casting raw FScriptMapHelper key storage with static_cast.
• UE 5.7 C4996 warnings in enum, struct, and material query bridge code were migrated to current APIs.

Install:

pip install soft-ue-cli==1.39.0

v1.38.0

Added

• Added anim montage inspect to read native AnimMontage notifies, notify states, composite sections, next-section links, and slot tracks.
• Added anim retarget sequence to retarget one AnimSequence through native IK Retargeter code into an explicit target asset path.
• Added anim montage set-slot-animation to replace or create an AnimMontage slot segment from native bridge code, avoiding raw Python mutation of SlotAnimTracks.
• Added a run-python-script guard for known crash-prone native UE Python batch calls, plus --allow-unsafe-python-calls for explicit opt-in when the caller accepts editor-crash risk.

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

v1.37.0

Added

• Added optional --anim-map OLD=NEW support to anim retarget blueprint so duplicated AnimBlueprints can repoint AnimSequence, BlendSpace, montage, and PoseSearchDatabase references along with bone-name remaps.
• Added anim pose-search database-repoint to repoint PoseSearchDatabase schema references and nested animation asset references, with optional best-effort reindexing.
• Added asset repoint-references to walk nested reflected UObject properties and replace matching hard or soft asset references in arbitrary assets such as DataAssets.
• Added asset skeletal-socket create and asset skeletal-socket remove for creating, updating, and removing mesh-owned SkeletalMesh sockets, including socket and bone names that are read-only through Unreal Python.

Fixed

• anim retarget blueprint now repoints duplicated AnimBlueprint generated-class references stored in chooser contexts, K2 nodes, and class-typed bindings.
• anim pose-search database-repoint now traverses nested animation asset entries inside PoseSearchDatabase instanced structs and invokes database reindexing after mutation.

Install:

pip install soft-ue-cli==1.37.0

v1.36.0

Added

• Added anim retarget blueprint to duplicate an AnimBlueprint onto a target skeleton and remap authored FBoneReference bone names using explicit bone maps.
• Added anim pose-search inspect and anim pose-search remap to read PoseSearchSchema skeleton/channel bone references and remap sampled bone names for renamed skeleton migrations.

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