v1.13.0

What's Fixed

• mcp-serve: report-bug crash — NameError: name 'io' is not defined when calling report-bug (or any client-side tool) via mcp-serve. Now fixed.
• mcp-serve: query-asset returns 0 results — MCP was forwarding the filter as asset_class but the bridge expects class. Now remapped correctly.
• capture-screenshot --mode window fails via MCP — GetActiveTopLevelWindow() returns null when the editor isn't the foreground window (which it never is when an agent calls via mcp-serve). Now uses the main editor window directly.

What's New

• create-asset supports World (Level) assets

  soft-ue-cli create-asset /Game/Maps/LV_NewLevel World
  

• create-asset --template PATH — duplicate an existing level instead of creating a blank one

  soft-ue-cli create-asset /Game/Maps/LV_Copy World --template /Game/Maps/LV_Template
  

Install

pip install soft-ue-cli==1.13.0

v1.12.0

Fixed

• mcp-serve: tool arguments were silently dropped — MCP client now receives the correct JSON schema for every tool and arguments are forwarded to the bridge as expected. This was a critical bug affecting ~50 of 57 bridge tools with required arguments.
• mcp-serve: class-hierarchy and project-info routed to wrong bridge tool name, always returning "Unknown tool"
• mcp-serve: status, check-setup, setup, report-bug, request-feature, submit-testimonial returned "Unknown tool" — these are client-side operations that never reach the bridge; they now run their existing handlers directly and return output to the MCP client

Changed

• submit-testimonial now posts via REST API instead of GitHub Discussions GraphQL

---

pip install soft-ue-cli==1.12.0

v1.11.1

Fixed

• Architecture diagram missing on GitHub — use relative path instead of absolute URL to private repo
• Python version badge showing "missing" on PyPI — added Python 3.10–3.13 classifiers to pyproject.toml

---

pip install soft-ue-cli==1.11.1

v1.11.0

Added

• set-viewport-camera command — programmatically control the editor viewport camera with presets (top, bottom, front, back, left, right, perspective), custom location/rotation, and orthographic zoom
• level-from-image skill — populate a UE level from a reference image using existing project assets, with autonomous visual feedback loop and human-in-the-loop refinement
• capture-viewport now auto-detects editor or game viewport (new --source flag: auto, game, editor)
• Batch actor tool reference section in level-from-image skill documentation

Fixed

• Skills frontmatter parser now skips nested YAML lines, correctly displaying skill descriptions
• capture-viewport works in editor without PIE session (defaults to auto-detect)

pip install soft-ue-cli==1.11.0

v1.10.0

Added

• submit-testimonial command — share feedback via GitHub Discussions with auto-collected metadata (CLI version, usage streak, top tools), consent prompt before posting
• Bug report nudge — unexpected errors now suggest filing a bug with a pre-filled report-bug command
• Daily usage streak tracking — after 3+ consecutive days of use, a one-time testimonial nudge appears
• MCP server returns structured bug_report_hint and testimonial_nudge payloads for LLM agents
• GitHub Discussions integration via GraphQL API for testimonial posting

Changed

• call_tool() now raises BridgeError with error classification (expected vs unexpected) instead of calling sys.exit(1) directly — enables richer error handling downstream

---

pip install soft-ue-cli==1.10.0

v1.9.0

Added

• mcp-serve command — run soft-ue-cli as an MCP server over stdio, exposing 60+ commands as MCP tools and skills as MCP prompts
• Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients
• Install with: pip install soft-ue-cli[mcp]

pip install soft-ue-cli==1.9.0

v1.8.0

[1.8.0] - 2026-04-03

Added

• skills list command — discover LLM workflow prompts shipped with the CLI
• skills get <name> command — retrieve a skill's full content for LLM consumption
• blueprint-to-cpp skill — instructs an LLM to generate C++ .h/.cpp from Blueprint assets using Layer 1 (class scaffolding) and Layer 2 (graph logic translation with 100+ node type mappings)

Fixed

• compile-material now uses GMaxRHIShaderPlatform instead of deprecated GMaxRHIFeatureLevel (UE 5.7 compatibility)

---

pip install soft-ue-cli==1.8.0

v1.7.1

Fixed

• query-level --class-filter now matches inherited classes (e.g. --class-filter Character finds all Character subclasses)

pip install soft-ue-cli==1.7.1

v1.7.0

Added

• compile-material command — trigger recompilation of Material, MaterialInstance, or MaterialFunction assets from the CLI
• MSYS/Git Bash path mangling detection — automatically reverses /Game/ → C:/Program Files/Git/Game/ conversion for asset paths

Fixed

• get-logs and all output commands no longer crash with UnicodeEncodeError on Korean Windows (cp949 locale)

pip install soft-ue-cli==1.7.0

v1.6.2

Added

• query-material now supports MaterialFunction assets — inspect expression graphs inside material functions

pip install soft-ue-cli==1.6.2