soft-ue-cli-ue-bridge

What problem does it solve?

Provides a reliable, editor-authoritative way to read and manipulate Unreal Engine assets, blueprints, levels, PIE sessions, screenshots, and logs by using soft-ue-cli to communicate with the SoftUEBridge plugin instead of relying on brittle offline uasset heuristics.

Core Features & Use Cases

• Live editor queries: Run query-blueprint, query-blueprint-graph, query-asset, query-level and other soft-ue-cli commands to inspect the current state inside a running Unreal Editor.
• Indexing and offline workflows: Use bp-index-refresh, bp-index-l2-list, and exported BlueprintSnapshot/.soft-ue-index artifacts for fast global search and evidence while marking them as potentially stale versus live editor facts.
• Robust error handling and guardrails: Built-in guidance for check-setup, handling 502/system proxy issues, editor startup fallbacks, and explicit rules against treating raw .uasset string scans as authoritative.
• Team-safe write rules: Prescribes save-on-change, milestone saves, and conflict avoidance for any write operations that modify assets.

Quick Start

Run py -3 -m soft_ue_cli check-setup in your project's root with the interactive Unreal Editor (SoftUEBridge enabled) running and then use query-blueprint <asset-path> to inspect an asset.