Skip to main content

Scripting

Über den Logik-Editor (auch Scripting genannt) lässt sich dem Bot mit Blockly eine eigene Logik hinterlegen. Mit visuellen Bausteinen können Abläufe, Reaktionen auf Nutzereingaben und die Steuerung von Chat-, Audio- und Avatar-Ansichten sowie Fusion-Views definiert werden, ohne dass Programmierkenntnisse notwendig sind.

Aufbau der Oberfläche

Den Logik-Editor findest du im Bot-Editor über den Tab Scripting (Puzzleteil-Icon). Die Oberfläche gliedert sich in folgende Bereiche:

  • Datei-Auswahl (Dropdown oben links) – zeigt an, an welcher Stelle du gerade Logik bearbeitest: Global, eine einzelne Stage (Betreten/Verlassen), ein Fusion-View oder ein Wenn-Dann. Ein rotes „*" markiert ungespeicherte Änderungen an der jeweiligen Stelle.
  • Suche (Lupe-Icon) – blendet ein Suchfeld ein, um einen Block gezielt über seinen Namen zu finden, statt die Toolbox-Kategorien manuell zu durchsuchen.
  • Toolbox (linke Kategorie-Leiste) – enthält alle verfügbaren Blöcke, gruppiert nach Kategorie (z. B. Start & Ablauf, Chatinhalte, KI-Funktionen, Daten & Inhalte, Darstellung, Integrationen). Ein Block wird per Drag & Drop von dort auf die Arbeitsfläche gezogen.
  • Arbeitsfläche (Workspace) – hier werden die Blöcke wie Puzzleteile aneinandergesteckt, um den gewünschten Ablauf zu erstellen. Rechtsklick auf einen Block bietet weitere Optionen (z. B. Duplizieren, Löschen, Block ein-/ausblenden).
  • Bot-Vorschau (🤖-Button) – blendet eine Live-Vorschau des Bots direkt neben dem Editor ein oder aus, sodass Änderungen sofort ausprobiert werden können, ohne den Logik-Editor zu verlassen.
  • Speichern (Disketten-Icon) – speichert den aktuellen Stand. Das Icon ist eingefärbt, solange ungespeicherte Änderungen vorliegen.
  • Code-Ansicht (</>-Icon) – zeigt den aus den Blöcken generierten JavaScript-Code in einer schreibgeschützten Vorschau daneben an. Das hilft dabei nachzuvollziehen, was die Blöcke tatsächlich bewirken.
    • Über den Button „zum Code-Editor wechseln" lässt sich von dort dauerhaft auf einen reinen Code-Editor umsteigen. Achtung: Dabei gehen alle Blockly-Bausteine unwiderruflich verloren – anschließend lässt sich nur noch der Code direkt bearbeiten.
  • Variablen verwalten – über einen Rechtsklick auf eine Variable in einem Block lässt sie sich umbenennen oder löschen; die Änderung wirkt sich auf alle Blöcke aus, die diese Variable verwenden.
  • Die üblichen Tastenkombinationen Rückgängig (Strg+Z) und Wiederholen (Strg+Umschalt+Z) funktionieren auf der Arbeitsfläche.

💡 Enthält dein Wenn-Dann-Code einen JavaScript-Fehler, wird das direkt über der Arbeitsfläche als Hinweis angezeigt.

Ausführungskontexte

Je nachdem, wo das Scripting hinterlegt wird, wird es zu unterschiedlichen Zeitpunkten ausgeführt:

JS Global

Das globale JavaScript wird immer in den Bot eingebunden und ausgeführt.

Stages

Betreten

Das JavaScript wird automatisch beim Betreten der Stage ausgeführt.

Verlassen

Das JavaScript wird automatisch beim Verlassen der Stage ausgeführt.

Fusion-Views

Das JavaScript wird automatisch beim Öffnen des Fusion-Views ausgeführt.

Wenn-Danns

Das JavaScript wird immer ausgeführt, wenn das Wenn-Dann triggert.

Referenz aller Blockly-Blöcke

Eine vollständige Übersicht aller verfügbaren Blockly-Blöcke findet sich im Entwickler-Bereich des Handbuchs: