Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 3b77cd8

Browse files
softdaddy-osoftdaddy-o
committed
sync: cli-v1.25.5
1 parent 961ae08 commit 3b77cd8

13 files changed

Lines changed: 136 additions & 142 deletions

‎CHANGELOG.md‎

Lines changed: 59 additions & 54 deletions
Large diffs are not rendered by default.

‎README.md‎

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,10 @@
1010
[![AI built for coding agents](https://img.shields.io/badge/AI_built_for-coding_agents-6b7280)](#why-soft-ue-cli)
1111
[![GitHub Sponsors](https://img.shields.io/badge/GitHub_Sponsors-Support_this_project-ea4aaa?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/softdaddy-o)
1212
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Buy_me_a_coffee-ff5e5b?logo=ko-fi&logoColor=white)](https://ko-fi.com/softdaddy)
13-
[![Support this project](https://img.shields.io/badge/Support_this_project-f6c343)](#support-this-project)
1413

1514
Built and maintained by a solo developer. [Support this project](#support-this-project) if it saves you time.
1615

17-
**Control Unreal Engine 5 from your AI agent or terminal.** soft-ue-cli gives any LLM — via **MCP server** or **CLI** — 60+ tools to spawn actors, edit Blueprints, inspect materials, read and patch UE config files, run Play-In-Editor sessions, capture screenshots, profile performance, and more inside a running UE5 editor or packaged build.
16+
**Control Unreal Engine 5 from your AI agent or terminal.** soft-ue-cli gives any LLM ? via **MCP server** or **CLI** ? 60+ tools to spawn actors, edit Blueprints, inspect materials, read and patch UE config files, run Play-In-Editor sessions, capture screenshots, profile performance, and more inside a running UE5 editor or packaged build.
1817

1918
Two connection paths. Same package. Bridge tools when Unreal is running, offline tools when it is not.
2019

@@ -43,7 +42,7 @@ soft-ue-cli (CLI or MCP server)
4342
- **AI-native UE automation** -- purpose-built so LLM agents can read, modify, and test Unreal Engine projects without a human touching the editor.
4443
- **60+ tools** covering actors, Blueprints, materials, StateTrees, widgets, assets, config files, PIE sessions, profiling, and more.
4544
- **Online + offline workflows** -- bridge-backed UE mutation and runtime inspection when Unreal is open, plus direct local inspection, diff, and config tooling when it is not.
46-
- **Config-aware workflows** — inspect hierarchy, trace overrides, diff layers, and patch `.ini`, `BuildConfiguration.xml`, and `.uproject` data from one `config` command group.
45+
- **Config-aware workflows** ? inspect hierarchy, trace overrides, diff layers, and patch `.ini`, `BuildConfiguration.xml`, and `.uproject` data from one `config` command group.
4746
- **LLM skill prompts** -- ships with markdown workflows (e.g. Blueprint-to-C++ conversion) exposed as MCP prompts or CLI commands.
4847
- **Works everywhere UE runs** -- editor, cooked builds, Windows, macOS, Linux.
4948
- **Single dependency** -- only requires `httpx`. Add `[mcp]` extra for MCP server mode.
@@ -62,7 +61,7 @@ pip install soft-ue-cli[mcp] # CLI + MCP server
6261

6362
### 2. Install the plugin into your UE project
6463

65-
Run the setup command **inside your LLM client** (Claude Code, Cursor, etc.) — it outputs step-by-step instructions that the AI agent will follow to copy the plugin, edit your `.uproject`, and configure itself:
64+
Run the setup command **inside your LLM client** (Claude Code, Cursor, etc.) ? it outputs step-by-step instructions that the AI agent will follow to copy the plugin, edit your `.uproject`, and configure itself:
6665

6766
```bash
6867
soft-ue-cli setup /path/to/YourProject
@@ -107,7 +106,7 @@ Add to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):
107106
}
108107
```
109108

110-
The AI editor now has direct access to all 60+ UE tools and skill prompts — no terminal needed.
109+
The AI editor now has direct access to all 60+ UE tools and skill prompts ? no terminal needed.
111110

112111
---
113112

@@ -174,7 +173,7 @@ MCP Client (Claude Desktop, Cursor, Windsurf, etc.)
174173
v
175174
soft-ue-cli mcp-serve (FastMCP server)
176175
|
177-
| Reuses call_tool() — HTTP/JSON-RPC
176+
| Reuses call_tool() ? HTTP/JSON-RPC
178177
v
179178
SoftUEBridge plugin (inside UE)
180179
```
@@ -333,7 +332,7 @@ Requires the **Animation Insights (GameplayInsights)** plugin enabled in Edit >
333332
| `rewind-status` | Query current recording state (detects recordings from CLI or editor UI) |
334333
| `rewind-list-tracks` | List all recorded actors and their available track types |
335334
| `rewind-overview` | Track-level summary for an actor (state machine transitions, montage play ranges, notify fire times) |
336-
| `rewind-snapshot` | Detailed animation state at a specific time or frame — the time-travel equivalent of `inspect-anim-instance` |
335+
| `rewind-snapshot` | Detailed animation state at a specific time or frame ? the time-travel equivalent of `inspect-anim-instance` |
337336
| `rewind-save` | Save the in-memory recording to a `.utrace` file |
338337

339338
### Build and Live Coding
@@ -667,7 +666,7 @@ soft-ue-cli is a Python tool that gives AI agents and developers 60+ operations
667666

668667
### How do AI agents use soft-ue-cli?
669668

670-
**MCP clients** (Claude Desktop, Cursor, Windsurf): Connect via `soft-ue-cli mcp-serve`. The agent sees all 60+ tools with typed schemas and skill prompts — it can directly call UE operations without going through a terminal.
669+
**MCP clients** (Claude Desktop, Cursor, Windsurf): Connect via `soft-ue-cli mcp-serve`. The agent sees all 60+ tools with typed schemas and skill prompts ? it can directly call UE operations without going through a terminal.
671670

672671
**Claude Code**: Runs soft-ue-cli commands in the terminal. Add a `CLAUDE.md` file to your UE project describing available commands, and Claude Code autonomously queries your level, spawns actors, edits Blueprints, runs PIE sessions, and iterates on your game.
673672

@@ -726,10 +725,10 @@ The MCP server exposes all 60+ commands as MCP tools and skills as MCP prompts.
726725

727726
| | soft-ue-cli | unreal-mcp, ue5-mcp, etc. |
728727
|---|---|---|
729-
| **Tools** | 60+ | 10–49 |
728+
| **Tools** | 60+ | 10?49 |
730729
| **Coverage** | Blueprints, materials, StateTrees, widgets, PIE, profiling, DataTables, CVars, Live Coding | Varies; most cover actors + basic assets |
731730
| **LLM skill prompts** | Yes (MCP prompts + CLI) | No |
732-
| **CLI mode** | Yes — shell scripts, CI/CD, Claude Code | MCP-only |
731+
| **CLI mode** | Yes ? shell scripts, CI/CD, Claude Code | MCP-only |
733732
| **Setup** | `pip install soft-ue-cli[mcp]` + copy one plugin | Varies; often requires custom C++/Python scripting |
734733

735734
---
@@ -738,10 +737,10 @@ The MCP server exposes all 60+ commands as MCP tools and skills as MCP prompts.
738737

739738
soft-ue-cli is free, open-source, and maintained by one person. If it saves you hours of manual editor work or helps your AI workflow, consider supporting continued development:
740739

741-
- [Sponsor on GitHub](https://github.com/sponsors/softdaddy-o) — recurring or one-time
742-
- [Buy me a coffee on Ko-fi](https://ko-fi.com/softdaddy) — quick one-time donation
740+
- [Sponsor on GitHub](https://github.com/sponsors/softdaddy-o) ? recurring or one-time
741+
- [Buy me a coffee on Ko-fi](https://ko-fi.com/softdaddy) ? quick one-time donation
743742

744-
Using soft-ue-cli in your project? [Share your experience](https://github.com/softdaddy-o/soft-ue-cli/issues/new?labels=testimonial&title=Testimonial) — I'd love to hear about it.
743+
Using soft-ue-cli in your project? [Share your experience](https://github.com/softdaddy-o/soft-ue-cli/issues/new?labels=testimonial&title=Testimonial) ? I'd love to hear about it.
745744

746745
---
747746

‎pyproject.toml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
44

55
[project]
66
name = "soft-ue-cli"
7-
version = "1.25.4"
7+
version = "1.25.5"
88
description = "CLI tool for controlling Unreal Engine via soft-ue-bridge plugin"
99
requires-python = ">=3.10"
1010
classifiers = [
@@ -28,6 +28,9 @@ Repository = "https://github.com/softdaddy-o/soft-ue-cli"
2828
[project.optional-dependencies]
2929
mcp = ["mcp>=1.2"]
3030

31+
[tool.hatch.build]
32+
include = ["soft_ue_cli/**"]
33+
3134
[tool.hatch.build.targets.wheel]
3235
packages = ["soft_ue_cli"]
3336

@@ -48,6 +51,3 @@ packages = ["soft_ue_cli"]
4851

4952
[tool.pytest.ini_options]
5053
testpaths = ["tests"]
51-
52-
[tool.hatch.build]
53-
include = ["soft_ue_cli/**"]

‎soft_ue_cli/__init__.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
1-
"""soft-ue-cli ??CLI interface to the SoftUEBridge UE plugin."""
1+
"""soft-ue-cli — CLI interface to the SoftUEBridge UE plugin."""
22

3-
__version__ = "1.25.4"
3+
__version__ = "1.25.5"

0 commit comments

Comments
 (0)