Trigger & Lua

Trigger sind ereignisgesteuerte Skripte an Charakteren. Sie feuern bei Chat-Beginn oder rund um Nachrichten und können den Verlauf lesen, Variablen setzen, Systemtext einfügen oder ein Senden stoppen.

Das Skriptformat nutzt einrückungsbasierte Befehle, kompatibel mit RisuAI-Trigger-Skripten v2, die Automatisierung bestehender Karten importiert und läuft also.

Skripte mit Low-Level-Zugriff schalten Effekte frei, die über den Chat hinausreichen:

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

LLM- und Bild-Effekte rufen echte Modelle auf und kosten Token. Sie setzen eine Anmeldung voraus und laufen über das eigene Konto.

Für Logik jenseits der Trigger-VM können Charaktere Lua mitbringen. Die Laufzeit stellt etwa 50 Funktionen bereit: Chat-Zugriff, Variablen, Hinweise, LLM-Aufrufe und mehr. Kompatibel mit der Lua-Schnittstelle von RisuAI.

onOutput = async(function(triggerId)
  local msg = getChat(triggerId, -1)
  if string.find(msg.data, "secret") then
    alertNormal(triggerId, "Secret mentioned!")
  end
end)
listenEdit("editoutput", function(triggerId, data)
  return data:gsub("%s+$", "")
end)

Lua-Hooks schreiben Text im Durchlauf um: die eigene Eingabe vor dem Zusammensetzen, die Ausgabe vor dem Speichern und die rohe Anfrage vor dem Senden.

Hooks laufen der Reihe nach zusammen mit Regex-Skripten derselben Stufe. Das Anfrageprotokoll zeigt das Ergebnis der gesamten Verarbeitungskette.

Die Skriptmodi für Anzeige und Anfrage laufen gesandboxt mit eingeschränktem Befehlssatz. Skripte kommen nicht an das Konto, an Schlüssel oder an andere Unterhaltungen. Schlimmstenfalls verstümmeln sie den eigenen Chat.