soft-ue-cli-ue-bridge

Query and control Unreal Editor assets and levels via soft-ue-cli over a local HTTP bridge.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill soft-ue-cli-ue-bridge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: soft-ue-cli-ue-bridge
Source: https://github.com/moraluco/Illusion-Cursor-dev-kit/tree/main/.cursor/skills/soft-ue-cli-ue-bridge
Command: npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill soft-ue-cli-ue-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about soft-ue-cli-ue-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Unreal Editor assets live during a development session?▼

You can query Unreal Editor assets live by using soft-ue-cli commands like query-blueprint and query-level, which communicate with a local SoftUEBridge HTTP bridge to read the current editor state directly.

Do I need the SoftUEBridge plugin enabled to inspect Unreal Engine blueprints?▼

Yes, you need the SoftUEBridge plugin enabled in your target .uproject and a reachable local bridge to inspect blueprints, levels, and PIE sessions with soft-ue-cli.

What is the best way to read Unreal Engine behavior trees without relying on offline uasset heuristics?▼

The best way to read behavior trees accurately is using live editor queries through soft-ue-cli, which provides editor-authoritative data instead of relying on brittle offline uasset string scans.

Why does my soft-ue-cli check-setup fail with a 502 proxy error?▼

A 502 proxy error during check-setup usually indicates a system proxy intercepting the local HTTP connection to SoftUEBridge, requiring documented fallback configurations to resolve.

Can I use exported BlueprintSnapshot artifacts for offline global search?▼

Yes, you can use bp-index-refresh and exported BlueprintSnapshot artifacts for offline global search, though they should be marked as potentially stale compared to live editor facts.

How do I safely modify Unreal Engine assets through editor automation?▼

To safely modify assets, follow team-safe write rules including save-on-change, milestone saves, and conflict avoidance to prevent data loss during editor automation workflows.