softdaddy-o/soft-ue-cli

Was macht soft-ue-cli?

Python CLI + UE-Plugin, das Claude Code (KI-Coding-Agent) die Echtzeitsteuerung von Unreal Engine ermöglicht. Spawne Akteure, bearbeite Blueprints, rufe Funktionen auf, erstelle Screenshots, verwalte PIE-Sitzungen und mehr – alles über das Terminal. Funktioniert mit dem UE5-Editor und verpackten Builds über eine prozessinterne HTTP-Brücke.

Funktionen

• Akteure spawnen: Erstelle und platziere Akteure dynamisch in der Szene.
• Blueprints bearbeiten: Modifiziere Blueprint-Komponenten, Variablen und Logiken.
• Funktionen aufrufen: Rufe beliebige C++- oder Blueprint-Funktionen über die CLI auf.
• Screenshots erstellen: Nimm Screenshots der aktuellen Editor-Ansicht auf.
• PIE-Sitzungen verwalten: Starte, stoppe und steuere Play-in-Editor-Sitzungen.
• HTTP-Brücke: Kommuniziere über eine interne HTTP-Schnittstelle mit der Engine.

Voraussetzungen

• Unreal Engine 5.x (Editor oder verpackter Build)
• Python 3.8+
• Claude Code (optional, für KI-Integration)

Installation

1. Plugin installieren: Kopiere das SoftUE-Plugin in das Plugins/-Verzeichnis deines UE-Projekts.
2. Plugin aktivieren: Stelle sicher, dass das Plugin in den Editor-Einstellungen aktiviert ist.
3. Python-CLI installieren: Führe pip install soft-ue-cli aus (oder installiere aus dem Quellcode).
4. Verbindung testen: Starte den UE-Editor und führe soft-ue-cli status aus, um die Verbindung zu prüfen.

Verwendung

Beispiele für CLI-Befehle

# Akteur spawnen
soft-ue-cli spawn actor /Game/MyActor.MyActor_C

# Blueprint-Variable setzen
soft-ue-cli set var MyBlueprint.MyVariable 42

# Funktion aufrufen
soft-ue-cli call MyActor.MyFunction

# Screenshot erstellen
soft-ue-cli screenshot output.png

# PIE starten
soft-ue-cli pie start

Integration mit Claude Code

Claude Code kann diese CLI direkt nutzen, um Unreal Engine automatisch zu steuern. Beispielsweise kann ein Prompt wie „Spawne einen Charakter und erstelle einen Screenshot“ dazu führen, dass Claude Code die entsprechenden Befehle ausführt.

Konfiguration

Umgebungsvariablen:

• UE_CLI_HOST – Host der HTTP-Brücke (Standard: localhost)
• UE_CLI_PORT – Port der HTTP-Brücke (Standard: 8080)
• UE_CLI_TOKEN – Authentifizierungs-Token (optional)

Fehlerbehebung

• Verbindung fehlgeschlagen: Stelle sicher, dass der UE-Editor mit dem aktiven Plugin läuft.
• Befehl nicht gefunden: Aktualisiere die Plugin-Version oder überprüfe die Logs in der Output Log-Konsole von UE.
• Python-CLI hängt: Überprüfe die Firewall-Einstellungen oder ändere den Port.

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.