sync: cli-v1.11.0

Author: softdaddy-o

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to soft-ue-cli will be documented in this file.
 
+## [1.11.0] - 2026-04-05
+
+### 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
+- Batch actor tool reference section in level-from-image skill documentation
+
+### Fixed
+- Skills frontmatter parser now skips nested YAML lines, correctly displaying skill descriptions
+
 ## [1.10.0] - 2026-04-05
 
 ### Added

README.md

@@ -229,6 +229,7 @@ Every command is available via `soft-ue-cli <command>`. Run `soft-ue-cli <comman
 | Command | Description |
 |---------|-------------|
 | `capture-screenshot` | Capture the editor viewport, PIE window, or a specific editor panel |
+| `set-viewport-camera` | Set editor viewport camera position, rotation, or preset view (top/front/right/perspective) |
 
 ### Logging and Console Variables
 
@@ -412,6 +413,18 @@ soft-ue-cli skills get blueprint-to-cpp
 # ...and generates the .h/.cpp files from the JSON responses
 ```
 
+### Populate a level from a reference image
+
+```bash
+# Get the level-from-image skill instructions
+soft-ue-cli skills get level-from-image
+# The LLM analyzes the image, searches for matching assets, places them,
+# then enters a visual feedback loop:
+#   soft-ue-cli set-viewport-camera --preset top --ortho-width 8000
+#   soft-ue-cli capture-screenshot window --output file
+# Compares screenshot to reference, auto-corrects, then asks for human feedback
+```
+
 ### Profile with UE Insights
 
 ```bash

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "soft-ue-cli"
-version = "1.10.0"
+version = "1.11.0"
 description = "CLI tool for controlling Unreal Engine via soft-ue-bridge plugin"
 requires-python = ">=3.10"
 dependencies = [

soft_ue_cli/__init__.py

@@ -1,3 +1,3 @@
 """soft-ue-cli — CLI interface to the SoftUEBridge UE plugin."""
 
-__version__ = "1.10.0"
+__version__ = "1.11.0"

soft_ue_cli/__main__.py

@@ -107,6 +107,19 @@ def cmd_spawn_actor(args: argparse.Namespace) -> None:
     _print_json(_run_tool("spawn-actor", arguments))
 
 
+def cmd_set_viewport_camera(args: argparse.Namespace) -> None:
+    arguments: dict = {}
+    if args.preset:
+        arguments["preset"] = args.preset
+    if args.location:
+        arguments["location"] = _parse_vector(args.location)
+    if args.rotation:
+        arguments["rotation"] = _parse_vector(args.rotation)
+    if args.ortho_width is not None:
+        arguments["ortho_width"] = args.ortho_width
+    _print_json(_run_tool("set-viewport-camera", arguments))
+
+
 def cmd_batch_spawn_actors(args: argparse.Namespace) -> None:
     arguments: dict = {"actors": _parse_json_arg(args.actors, "--actors")}
     _print_json(_run_tool("batch-spawn-actors", arguments))
@@ -1273,6 +1286,30 @@ def build_parser() -> argparse.ArgumentParser:
     p_spawn.add_argument("--world", choices=["editor", "pie"], help="Target world: editor (default) or pie")
     p_spawn.set_defaults(func=cmd_spawn_actor)
 
+    # set-viewport-camera
+    p_vpcam = sub.add_parser(
+        "set-viewport-camera",
+        help="Set the editor viewport camera position, rotation, or view preset.",
+        description=(
+            "Set the editor viewport camera. Use presets for quick views or\n"
+            "specify location/rotation manually.\n\n"
+            "Presets: top, bottom, front, back, left, right, perspective\n\n"
+            "Examples:\n"
+            "  soft-ue-cli set-viewport-camera --preset top\n"
+            "  soft-ue-cli set-viewport-camera --preset top --ortho-width 10000\n"
+            "  soft-ue-cli set-viewport-camera --location 0,0,2000 --rotation -90,0,0\n"
+            "  soft-ue-cli set-viewport-camera --preset perspective --location 500,500,500"
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    p_vpcam.add_argument("--preset", choices=["top", "bottom", "front", "back", "left", "right", "perspective"],
+                         help="Camera preset view")
+    p_vpcam.add_argument("--location", metavar="X,Y,Z", help="Camera position in cm")
+    p_vpcam.add_argument("--rotation", metavar="P,Y,R", help="Camera rotation in degrees")
+    p_vpcam.add_argument("--ortho-width", type=float, dest="ortho_width",
+                         help="Orthographic view width (zoom). Larger = more zoomed out")
+    p_vpcam.set_defaults(func=cmd_set_viewport_camera)
+
     # batch-spawn-actors
     p_batch_spawn = sub.add_parser(
         "batch-spawn-actors",

soft_ue_cli/plugin_data/SoftUEBridge/Source/SoftUEBridgeEditor/Private/SoftUEBridgeEditorModule.cpp

@@ -78,6 +78,7 @@
 #include "Tools/Write/BatchSpawnActorTool.h"
 #include "Tools/Write/BatchModifyActorTool.h"
 #include "Tools/Write/BatchDeleteActorTool.h"
+#include "Tools/Write/SetViewportCameraTool.h"
 
 DEFINE_LOG_CATEGORY(LogSoftUEBridgeEditor);
 
@@ -161,6 +162,7 @@ void FSoftUEBridgeEditorModule::StartupModule()
 	Registry.RegisterToolClass<UBatchSpawnActorTool>();
 	Registry.RegisterToolClass<UBatchModifyActorTool>();
 	Registry.RegisterToolClass<UBatchDeleteActorTool>();
+	Registry.RegisterToolClass<USetViewportCameraTool>();
 
 	UE_LOG(LogSoftUEBridgeEditor, Log, TEXT("Registered %d editor bridge tools"), Registry.GetToolCount());
 

soft_ue_cli/plugin_data/SoftUEBridge/Source/SoftUEBridgeEditor/Private/Tools/Write/SetViewportCameraTool.cpp

@@ -0,0 +1,182 @@
+// Copyright soft-ue-expert. All Rights Reserved.
+
+#include "Tools/Write/SetViewportCameraTool.h"
+#include "SoftUEBridgeEditorModule.h"
+#include "Editor.h"
+#include "LevelEditorViewport.h"
+#include "SLevelViewport.h"
+#include "LevelEditor.h"
+#include "Modules/ModuleManager.h"
+
+FString USetViewportCameraTool::GetToolDescription() const
+{
+	return TEXT("Set the editor viewport camera position, rotation, and view mode. "
+		"Supports perspective and orthographic views (Top, Front, Right, etc.). "
+		"Use 'preset' for quick top-down/front/side views, or set location/rotation manually.");
+}
+
+TMap<FString, FBridgeSchemaProperty> USetViewportCameraTool::GetInputSchema() const
+{
+	TMap<FString, FBridgeSchemaProperty> Schema;
+
+	FBridgeSchemaProperty Location;
+	Location.Type = TEXT("array");
+	Location.Description = TEXT("Camera position [x, y, z]. Ignored for orthographic presets.");
+	Location.bRequired = false;
+	Schema.Add(TEXT("location"), Location);
+
+	FBridgeSchemaProperty Rotation;
+	Rotation.Type = TEXT("array");
+	Rotation.Description = TEXT("Camera rotation [pitch, yaw, roll] in degrees. Ignored for orthographic presets.");
+	Rotation.bRequired = false;
+	Schema.Add(TEXT("rotation"), Rotation);
+
+	FBridgeSchemaProperty Preset;
+	Preset.Type = TEXT("string");
+	Preset.Description = TEXT("Camera preset: 'top', 'bottom', 'front', 'back', 'left', 'right', or 'perspective'. "
+		"Orthographic presets switch to ortho view. 'perspective' switches back.");
+	Preset.bRequired = false;
+	Schema.Add(TEXT("preset"), Preset);
+
+	FBridgeSchemaProperty OrthoWidth;
+	OrthoWidth.Type = TEXT("number");
+	OrthoWidth.Description = TEXT("Orthographic view width (zoom level). Larger = more zoomed out. Default: 5000.");
+	OrthoWidth.bRequired = false;
+	Schema.Add(TEXT("ortho_width"), OrthoWidth);
+
+	return Schema;
+}
+
+TArray<FString> USetViewportCameraTool::GetRequiredParams() const
+{
+	return {};
+}
+
+FBridgeToolResult USetViewportCameraTool::Execute(
+	const TSharedPtr<FJsonObject>& Arguments,
+	const FBridgeToolContext& Context)
+{
+	// Get the first level viewport
+	FLevelEditorModule& LevelEditor = FModuleManager::GetModuleChecked<FLevelEditorModule>(TEXT("LevelEditor"));
+	TSharedPtr<ILevelEditor> LevelEditorInstance = LevelEditor.GetFirstLevelEditor();
+	if (!LevelEditorInstance.IsValid())
+	{
+		return FBridgeToolResult::Error(TEXT("No level editor found"));
+	}
+
+	TSharedPtr<SLevelViewport> ActiveViewport = LevelEditorInstance->GetActiveViewportInterface();
+	if (!ActiveViewport.IsValid())
+	{
+		return FBridgeToolResult::Error(TEXT("No active viewport found"));
+	}
+
+	FLevelEditorViewportClient& ViewportClient = ActiveViewport->GetLevelViewportClient();
+
+	const FString Preset = GetStringArgOrDefault(Arguments, TEXT("preset"));
+	const float OrthoWidth = GetFloatArgOrDefault(Arguments, TEXT("ortho_width"), 5000.0f);
+
+	// Handle presets
+	if (!Preset.IsEmpty())
+	{
+		if (Preset.Equals(TEXT("top"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoXY);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(-90, 0, 0));
+		}
+		else if (Preset.Equals(TEXT("bottom"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoNegativeXY);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(90, 0, 0));
+		}
+		else if (Preset.Equals(TEXT("front"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoXZ);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(0, -90, 0));
+		}
+		else if (Preset.Equals(TEXT("back"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoNegativeXZ);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(0, 90, 0));
+		}
+		else if (Preset.Equals(TEXT("left"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoYZ);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(0, 0, 0));
+		}
+		else if (Preset.Equals(TEXT("right"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_OrthoNegativeYZ);
+			ViewportClient.SetOrthoZoom(OrthoWidth);
+			ViewportClient.SetViewRotation(FRotator(0, 180, 0));
+		}
+		else if (Preset.Equals(TEXT("perspective"), ESearchCase::IgnoreCase))
+		{
+			ViewportClient.SetViewportType(LVT_Perspective);
+		}
+		else
+		{
+			return FBridgeToolResult::Error(FString::Printf(
+				TEXT("Unknown preset '%s'. Use: top, bottom, front, back, left, right, perspective"), *Preset));
+		}
+	}
+
+	// Apply custom location if provided
+	const TArray<TSharedPtr<FJsonValue>>* LocArr;
+	if (Arguments->TryGetArrayField(TEXT("location"), LocArr) && LocArr->Num() >= 3)
+	{
+		FVector Location;
+		Location.X = (*LocArr)[0]->AsNumber();
+		Location.Y = (*LocArr)[1]->AsNumber();
+		Location.Z = (*LocArr)[2]->AsNumber();
+		ViewportClient.SetViewLocation(Location);
+	}
+
+	// Apply custom rotation if provided
+	const TArray<TSharedPtr<FJsonValue>>* RotArr;
+	if (Arguments->TryGetArrayField(TEXT("rotation"), RotArr) && RotArr->Num() >= 3)
+	{
+		FRotator Rotation;
+		Rotation.Pitch = (*RotArr)[0]->AsNumber();
+		Rotation.Yaw   = (*RotArr)[1]->AsNumber();
+		Rotation.Roll  = (*RotArr)[2]->AsNumber();
+		ViewportClient.SetViewRotation(Rotation);
+	}
+
+	// Force viewport redraw
+	ViewportClient.Invalidate();
+
+	// Build result
+	FVector FinalLoc = ViewportClient.GetViewLocation();
+	FRotator FinalRot = ViewportClient.GetViewRotation();
+
+	TSharedPtr<FJsonObject> Result = MakeShareable(new FJsonObject);
+	Result->SetBoolField(TEXT("success"), true);
+
+	TArray<TSharedPtr<FJsonValue>> LocJson;
+	LocJson.Add(MakeShared<FJsonValueNumber>(FinalLoc.X));
+	LocJson.Add(MakeShared<FJsonValueNumber>(FinalLoc.Y));
+	LocJson.Add(MakeShared<FJsonValueNumber>(FinalLoc.Z));
+	Result->SetArrayField(TEXT("location"), LocJson);
+
+	TArray<TSharedPtr<FJsonValue>> RotJson;
+	RotJson.Add(MakeShared<FJsonValueNumber>(FinalRot.Pitch));
+	RotJson.Add(MakeShared<FJsonValueNumber>(FinalRot.Yaw));
+	RotJson.Add(MakeShared<FJsonValueNumber>(FinalRot.Roll));
+	Result->SetArrayField(TEXT("rotation"), RotJson);
+
+	const bool bOrtho = ViewportClient.IsOrtho();
+	Result->SetStringField(TEXT("view_type"), bOrtho ? TEXT("orthographic") : TEXT("perspective"));
+	if (!Preset.IsEmpty())
+	{
+		Result->SetStringField(TEXT("preset"), Preset);
+	}
+
+	UE_LOG(LogSoftUEBridgeEditor, Log, TEXT("set-viewport-camera: %s at [%.0f, %.0f, %.0f]"),
+		bOrtho ? TEXT("ortho") : TEXT("perspective"), FinalLoc.X, FinalLoc.Y, FinalLoc.Z);
+	return FBridgeToolResult::Json(Result);
+}

soft_ue_cli/plugin_data/SoftUEBridge/Source/SoftUEBridgeEditor/Public/Tools/Write/SetViewportCameraTool.h

@@ -0,0 +1,22 @@
+// Copyright soft-ue-expert. All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Tools/BridgeToolBase.h"
+#include "SetViewportCameraTool.generated.h"
+
+UCLASS()
+class SOFTUEBRIDGEEDITOR_API USetViewportCameraTool : public UBridgeToolBase
+{
+	GENERATED_BODY()
+
+public:
+	virtual FString GetToolName() const override { return TEXT("set-viewport-camera"); }
+	virtual FString GetToolDescription() const override;
+	virtual TMap<FString, FBridgeSchemaProperty> GetInputSchema() const override;
+	virtual TArray<FString> GetRequiredParams() const override;
+	virtual FBridgeToolResult Execute(
+		const TSharedPtr<FJsonObject>& Arguments,
+		const FBridgeToolContext& Context) override;
+};

soft_ue_cli/skills/__init__.py

@@ -16,6 +16,8 @@ def _parse_frontmatter(text: str) -> dict[str, str]:
         return {}
     fields: dict[str, str] = {}
     for line in text[3:end].strip().splitlines():
+        if line.startswith((" ", "\t", "-")):
+            continue
         if ":" in line:
             key, _, value = line.partition(":")
             fields[key.strip()] = value.strip()