Déclencheurs & Lua

Les déclencheurs sont des scripts événementiels attachés aux personnages. Ils se lancent au démarrage du chat ou autour des messages, et peuvent lire l'historique, définir des variables, injecter du texte système ou stopper un envoi.

Le format utilise des commandes à indentation compatibles avec les scripts déclencheurs v2 de RisuAI : l'automatisation des cartes existantes s'importe et fonctionne.

Les scripts avec accès bas niveau débloquent des effets qui sortent du chat :

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

Les effets LLM et image appellent de vrais modèles et coûtent des tokens ; ils exigent d'être connecté et passent par votre compte.

Pour la logique au-delà de la VM de déclencheurs, les personnages peuvent embarquer du Lua. Le runtime intégré expose une API d'environ 50 fonctions : accès au chat, variables, alertes, appels LLM et plus, compatible avec la surface Lua de 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 peut enregistrer des hooks qui réécrivent le texte à la volée : votre saisie avant l'assemblage, la sortie du modèle avant l'enregistrement, et la requête brute juste avant l'envoi.

Les hooks s'exécutent dans l'ordre avec les scripts regex de la même étape ; le journal des requêtes montre le résultat final de tout le pipeline.

Les modes d'affichage et de requête tournent dans un bac à sable au jeu de commandes restreint. Les scripts n'atteignent ni votre compte, ni vos clés, ni les autres conversations ; au pire, un mauvais script brouille son propre chat.