Dokumentation

Engine Mentor

Engine Mentor ist dein Tutor direkt im Unreal Editor. Du schreibst oder sprichst, was du erreichen willst. Der Mentor sieht dein aktives Editor-Fenster (Screenshot und Liste der Bedienelemente) und hilft auf vier Arten: Erklären, Zeigen, Vormachen oder Autonom. Die Oberfläche gibt es auf Deutsch und Englisch; der Mentor antwortet in der Sprache, in der du schreibst oder sprichst.

  • Version 0.5.0
  • Unreal Engine 5.8
  • Windows

Erste Schritte

  1. Plugin unter Bearbeiten → Plugins → Engine Mentor aktivieren und den Editor neu starten. Das Engine-Plugin Toolset Registry (experimentell) wird automatisch mit aktiviert.
  2. Mentor öffnen: Fenster → Engine Mentor oder Strg+Umschalt+M.
  3. Beim ersten Öffnen führt dich die Einrichtung durch Sprache, Weg zur KI, Stimme und Datenschutz. Du kannst sie überspringen und später über → Einrichtung neu starten oben im Mentor erneut starten.

Tastenkürzel

TasteWirkung
Strg+Umschalt+MMentor ein- und ausblenden
Strg+Umschalt+M beim SpielenOverlay des Live-Debuggers öffnen und schließen
Strg+Umschalt+Alt+Uzwischen Tab und schwebendem Fenster wechseln
Strg+Umschalt+Leertastesprechen (Spracheingabe starten und stoppen)
Enter / Umschalt+Entersenden / neue Zeile
EscAntwort oder Aufnahme abbrechen, Vormachen anhalten

KI-Anbieter

Der Mentor braucht eine KI für den Chat. Es gibt zwei Wege – und die geprüften Rezepte funktionieren auch ganz ohne KI.

Mit Abo

keine Kosten je Frage

Claude über Claude Code oder ChatGPT über die Codex CLI. Beide sind die offiziellen Kommandozeilen der Hersteller und brauchen kein Node.js.

Mit API-Key

Abrechnung beim Anbieter je Nutzung

OpenAI, Anthropic, xAI (Grok), Google Gemini, Mistral, OpenRouter oder ein eigener Endpunkt, z. B. LM Studio oder Ollama auf deinem PC.

Claude Code einrichten

  1. Einstellungen → KI-Anbieter (oder in der Einrichtung): Claude Code installieren. Es öffnet sich ein Konsolenfenster mit dem offiziellen Installer von Anthropic (irm https://claude.ai/install.ps1 | iex). Er prüft die Prüfsumme und richtet Claude Code für deinen Windows-Benutzer ein.
  2. „Im PATH“ sollte ja zeigen. Sonst „Zum PATH hinzufügen“ – dann geht claude auch in jeder Konsole.
  3. Anmelden öffnet Claude Code in einer Konsole. Dort /login eingeben und den Schritten im Browser folgen, danach /exit.

Die Kopie von Claude Code, die Claude Desktop mitbringt, wird ebenfalls gefunden. Sie wechselt aber mit jedem Update von Claude Desktop und steht nicht im PATH – besser ist der offizielle Installer. Den Pfad kannst du auch selbst wählen (Pfad wählen …).

Bei Claude gibt es zusätzlich die Wahl Claude-Konto (Abo) oder Eigener API-Key (Anthropic, wird je Nutzung abgerechnet). Ist in deiner Umgebung ANTHROPIC_API_KEY gesetzt, rechnet Claude Code darüber ab – der Mentor weist darauf hin.

ChatGPT über die Codex CLI

Codex CLI installieren startet den offiziellen Installer von OpenAI (irm https://chatgpt.com/codex/install.ps1 | iex). Danach Anmelden (öffnet codex login) und mit deinem ChatGPT-Konto bestätigen. Die Codex CLI läuft im Mentor nur lesend.

API-Key

Anbieter wählen, Schlüssel eintragen, speichern. „Prüfen“ ruft nur die Modellliste ab und kostet nichts. Schlüssel werden mit Windows-DPAPI verschlüsselt gespeichert; Umgebungsvariablen (z. B. OPENAI_API_KEY, XAI_API_KEY, GEMINI_API_KEY, MISTRAL_API_KEY, OPENROUTER_API_KEY) funktionieren ebenso. Für den Screenshot braucht es ein Modell mit Bildverständnis.

Unterschied zu Claude: Anbieter per API-Key bekommen keine Werkzeuge und lesen keine Projektdateien – nur Screenshot, Bedienelemente-Liste und deinen Text. Den Anbieter kannst du mitten im Gespräch wechseln.

Die vier Modi

ModusWas passiert
ErklärenDer Mentor beschreibt den Weg im Chat.
ZeigenJeder Schritt wird im Editor markiert, auch in offenen Menüs. Du klickst selbst, dann geht es weiter. Die Schrittkarte hat Zurück, Weiter, Neu suchen, Mentor fragen und Beenden.
VormachenDer Mentor sagt jeden Schritt an, führt den Mauszeiger langsam zum Ziel und klickt bzw. tippt.
AutonomDu sagst, was du haben willst; der Mentor erledigt es zügig in menschlichem Tempo, ohne Ansage je Schritt.

Achtung

In den klickenden Modi hältst du jederzeit an: Esc, „Pause“ oder ein eigener Klick. Vor Speichern, Löschen, Umbenennen, Bauen und Einstellungsänderungen fragt der Mentor nach. Was sich nicht klicken lässt (Ziehen, Viewport-Kamera), bleibt bei dir.

Vorgelesen wird nur eine kurze Fassung: ein, zwei Sätze zum Einstieg – die ausführliche Antwort steht im Chat. Die Schritte erscheinen einzeln im Chat und werden einzeln angesagt, sobald du dort ankommst; Schritt 2 hörst du erst, wenn Schritt 1 erledigt ist. Erledigte bekommen ein ✓. Tasten stehen als Tastenkappen da, z. B. Strg+S. Sollst du Tasten selbst ausprobieren (etwa W A S D im Viewport), leuchtet jede gedrückte Taste in der Schrittkarte grün auf; sind alle einmal gedrückt, geht es von selbst weiter. Tippen im Chat zählt dabei nicht.

Findet die Führung ein Ziel nicht oder klickst du daneben, steuert der Mentor automatisch nach (Einstellung Bei Abweichung automatisch nachsteuern).

Rezepte und Lektionen

→ Rezepte oben im Mentor öffnet 250 häufige Aufgaben in 9 Bereichen. Zeigen oder Vormachen startet ein Rezept. Gibt es einen geprüften Ablauf für deine Unreal-Version und Editor-Sprache, spielt der Mentor ihn direkt ab – ohne KI. Sonst prüft der Mentor den Weg mit der KI und führt dich.

  • Läuft eine Führung komplett durch, gilt das Rezept für deine Version als geprüft und wird lokal gespeichert.
  • Scheitert ein abgespielter Ablauf, wird er als „geändert“ markiert und beim nächsten Mal neu geprüft.
  • Status: geprüft · in anderer Version geprüft · geändert · offen · Erklärung.

Rezept-Erkennung

Passt deine Frage zu einem Rezept, schlägt der Mentor es vor. Die Erkennung läuft lokal auf deinem PC (ein kleines Sprachmodell, nichts verlässt den Rechner).

Lektionen

Auf der Startkarte stehen Lektionen zum Ausprobieren. Eigene Lektionen legst du als JSON unter %LOCALAPPDATA%\EngineMentor\Lessons\<Sprache>\ ab. Jede abgeschlossene Führung landet im Lernprotokoll; der Mentor baut darauf auf.

Stimme und Spracheingabe

Vorlesen (Piper) und Spracheingabe (Whisper) laufen lokal auf deinem PC. Dafür lädt der Mentor auf deinen Klick Pakete nach – in der Einrichtung oder unter Einstellungen → Sidecars → Automatisch einrichten:

PaketGröße (ca.)Hinweis
Vorlesen (Pocket TTS, empfohlen)720 MBnatürlich klingende deutsche Stimme, nur CPU; Englisch spricht weiter Piper
Vorlesen (Piper)200 MBStimmen Deutsch und Englisch
Spracheingabe mit NVIDIA-GPU (Whisper)1,6 GBnur mit NVIDIA-Grafikkarte angeboten
Spracheingabe nur CPU (Whisper)520 MBfür alle anderen PCs

Der Mentor prüft jede Datei gegen die im Plugin hinterlegte SHA-256-Prüfsumme und entpackt erst dann – nach %LOCALAPPDATA%\EngineMentor\Sidecars\, einmal je Windows-Benutzer für alle Projekte (der Ordner lässt sich ändern, siehe Datenschutz und Ablage). Ohne Download liest die Windows-Stimme vor, und die Spracheingabe bleibt aus.

Diktieren

Mikrofon-Knopf oder Strg+Umschalt+Leertaste. Das Mikrofon bleibt an; bei jeder Sprechpause wird der Abschnitt erkannt und angehängt. Ein zweiter Klick beendet; nach 20 s ohne Sprache geht das Mikrofon von selbst aus.

Fachbegriffe

Englische Unreal-Begriffe kommen richtig an, auch wenn du sie deutsch aussprichst („Ritschit Bodi“ → „Rigid Body“). Eigene Begriffe pflegst du unter Einstellungen → Sprache → Deine Begriffe; dort kannst du sie auch einsprechen und testen. Das Fenster Fachbegriffe trainieren geht die mitgelieferten Begriffe nach Bereichen durch.

Spielen und Fehler finden

Während du im Editor spielst (Play), hört der Mentor im Log mit. Neue Fehler und Blueprint-Laufzeitfehler wie Accessed None trying to read property … sagt er sofort an – lokal über die Stimme, ohne KI und ohne Kosten. Gleichzeitig fragt er die KI nach der Ursache und liest dir die Erklärung vor, während du noch spielst.

Overlay im Spielfenster

Unten rechts im Spielfenster steht das Mentor-Icon. Gibt es einen Fehler, zeigt es die Anzahl und das Tastenkürzel. Strg+Umschalt+M öffnet während des Spielens das Overlay: Dort stehen der Fehler und die Erklärung, und der Mentor liest sie vor. Noch einmal drücken schließt es. Das Overlay fängt keine Maus- oder Spieleingaben ab; Umschalt+F1 gibt die Maus frei wie gewohnt.

EinstellungWirkung
Fehler beim Spielen ansagenLive-Debugger an oder aus (Standard: an, nur Fehler)
Auch Warnungen ansagensonst nur Fehler – Warnungen sind oft harmlos und zahlreich
KI-Erklärungen je Play-SitzungStandard 3 · 0 = nur lokale Ansage
Overlay im SpielfensterMentor-Icon und Strg+Umschalt+M während des Spielens
Play-Log beim Fragen mitschickenneue Fehler und Warnungen gehen bis 15 Minuten nach dem Spielen mit deiner nächsten Frage mit

Zu finden unter Einstellungen → Allgemein → Play-Modus · Live-Debugger. Mit Abo kostet eine Erklärung nichts extra; mit API-Key rechnet dein Anbieter jede Anfrage ab.

Play-Log

Alle Warnungen und Fehler der letzten Play-Sitzung stehen in Saved\EngineMentor\PlayLog.md – gleiche Meldungen zusammengefasst und gezählt, Blueprint-Fehler mit Blueprint, Funktion und Knoten. Nach dem Spielen kannst du einfach fragen („Was war das gerade?“); der Mentor bekommt die neuen Einträge automatisch mit.

Projektübersicht

Der Mentor liest einmal die Namen deiner Level, Blueprints (mit Elternklasse), C++-Klassen und Assets ein und hält sie aktuell (Saved\EngineMentor\ProjectIndex.md). So weiß er sofort, wie dein Spieler-Blueprint oder dein GameMode heißt, und muss nicht erst suchen – schnellere Antworten, weniger Tokens. Abschaltbar unter Einstellungen → Allgemein → Projektübersicht.

Einstellungen

Zahnrad oben im Mentor. Seltene Optionen findest du unter Alle Optionen in den Editor-Einstellungen … (Editor-Einstellungen → Plugins → Engine Mentor).

ReiterInhalt
KI-AnbieterAbo oder API-Key, Modell, Installieren, Anmelden, Schlüssel prüfen
AllgemeinSprache (Oberfläche, Antworten, gesprochene Sprache), Verhalten (Einsteiger, Vorlesen, Screenshot, Tempo, Websuche, Lernprotokoll), Animationen und Töne
SpracheAusgabe: Stimme je Sprache, testen, weitere Stimmen laden · Eingabe: Whisper-Modell, Sprechpausen, Fachbegriffe
SidecarsAutomatisch einrichten oder Paket-Ordner selbst wählen
ÜberVersion, Komponenten mit Lizenzen, Marken, Datenschutz, Herausgeber

Oben im Mentor öffnet Hilfe diese Seite online oder lokal. Unter findest du Rezepte, Einrichtung neu starten und das Lösen bzw. Andocken des Fensters. Einstellungen → Allgemein → Einrichtung setzt die geführte Einrichtung zurück; deine Einstellungen bleiben dabei erhalten.

Datenschutz und Ablage

Datenschutz

Deine Fragen, ein Screenshot des aktiven Editor-Fensters und die Liste der sichtbaren Bedienelemente gehen nur an den KI-Anbieter, den du gewählt hast – über dessen Kommandozeile oder deinen API-Key. Obelisk Systems bekommt davon nichts: keine Telemetrie, keine Nutzungsstatistik. Den Screenshot kannst du in den Einstellungen abschalten.

  • Websuche: Ist sie erlaubt (Standard), darf Claude bzw. Codex bei Unsicherheit zur Unreal-Version im Internet nachsehen.
  • Lokal: Vorlesen, Spracheingabe und Rezept-Erkennung laufen auf deinem PC. Pakete werden nur auf deinen Klick geladen.
  • Projekt und Spielen: Die Projektübersicht (Namen von Level, Blueprints, Klassen und Assets) und Fehlermeldungen aus dem Play-Modus gehen als Kurzfassung bzw. bei Bedarf an deinen KI-Anbieter. Beides lässt sich in den Einstellungen abschalten.
  • Im Projekt (Saved\EngineMentor\): Chat-Verläufe, Systemtext, letzter Screenshot.
  • Für deinen Windows-Benutzer (%LOCALAPPDATA%\EngineMentor\): verschlüsselte API-Keys (DPAPI), Sidecars, Lernprotokoll, eigene Lektionen und Begriffe, eigene Prüfläufe.

Diesen Datenordner kannst du unter Einstellungen → Sidecars → Datenordner ändern, etwa auf ein anderes Laufwerk. Der Mentor kopiert dabei alles in den neuen Ordner; der alte bleibt bestehen, bis du ihn selbst löschst.

Mehr im Datenschutzhinweis.

Fehlersuche

„Claude Code nicht gefunden“

Claude Code installieren oder Pfad wählen …, danach Erneut suchen. Ohne Claude Code geht Claude weder per Abo noch per Anthropic-Key – dann einen Anbieter mit API-Key wählen.

Programm startet nicht mehr / Node.js entfernt

Neu installieren startet den offiziellen Installer noch einmal; Anmeldung und Einstellungen bleiben erhalten. Eine ältere Codex CLI aus npm braucht Node.js – der Mentor kennzeichnet sie und bietet Eigenständig installieren (ohne Node.js) an. Danach Erneut suchen.

Nicht angemeldet / Abo wird nicht erkannt

Anmelden und in der Konsole /login (Claude) bzw. im Browser bestätigen (Codex). Die Statusanzeige zeigt das Abo, sobald die CLI die Anmeldung bestätigt.

Schlüssel ungültig

„Prüfen“ zeigt die Meldung des Anbieters. Häufig wurde die Schlüssel-ID statt des Schlüssels kopiert; der Mentor weist auf ein ungewöhnliches Format hin.

Stimme oder Spracheingabe lädt nicht

Ist der Server nicht erreichbar, die Pakete später erneut laden oder unter Sidecars einen entpackten Paket-Ordner selbst wählen. Abgebrochene Downloads werden fortgesetzt. Eine Datei mit falscher Prüfsumme wird verworfen und nicht entpackt.

„Datenordner nicht lesbar“ / Einstellungen scheinen zurückgesetzt

Manchmal verweigert Windows einem Editor-Prozess den Zugriff auf den Datenordner, etwa nach einem Neustart des PCs. Dann sehen Sidecars, Fachbegriffe oder der Trainingsstand aus, als wären sie weg. Die Daten sind aber nicht verloren, und der Mentor überschreibt in diesem Zustand nichts. Meist hilft es, den Editor zu schließen und neu zu starten. Passiert es öfter, wähle einen anderen Datenordner.

Der Mentor findet ein Element nicht

Neu suchen auf der Schrittkarte oder Mentor fragen. Ist automatisch nachsteuern an, passt der Mentor die restlichen Schritte selbst an. Menüs und Beschriftungen hängen von Unreal-Version und Editor-Sprache ab.

Protokoll

Im Output-Log des Editors unter der Kategorie LogEngineMentor. Die Datei liegt unter Saved\Logs\<Projekt>.log.

Drittsoftware und Lizenzen

Die vollständige Liste mit Lizenzen und Links steht unter Einstellungen → Über. Kurz:

  • Icons: Lucide (ISC); Anbieter-Logos: LobeHub Icons (MIT). Logos sind Marken ihrer Inhaber und dienen nur der Kennzeichnung.
  • Schriften dieser Hilfe: Inter, Space Grotesk und JetBrains Mono (SIL OFL 1.1, Lizenzen im Ordner Docs\Help\_shared\fonts).
  • Rezept-Erkennung: Modell multilingual-e5-small (MIT), ausgeführt mit dem Engine-Plugin NNERuntimeORT (Beta).
  • Vorlesen: Piper (GPL-3.0, eigener Download, Quellcode liegt dem Paket bei); Stimmen de_DE-mls-medium (CC BY 4.0) und en_US-ljspeech-medium (gemeinfrei).
  • Spracheingabe: faster-whisper und CTranslate2 (MIT), Whisper-Modelle (MIT), NVIDIA-Laufzeitbibliotheken (NVIDIA-Lizenz).
  • Claude, ChatGPT, Codex, Grok, Gemini, Mistral und OpenRouter sind Marken ihrer Inhaber. Unreal Engine ist eine Marke von Epic Games.

Hilfe und Kontakt

Diese Hilfe gehört zu deiner Version 0.5.0. Neuere Hinweise, Antworten und Kontakt findest du hier: