Gatilhos e Lua

Gatilhos são scripts por evento anexados a personagens. Disparam no início do chat ou em volta das mensagens, e podem ler histórico, definir variáveis, injetar texto de sistema ou parar um envio.

O formato usa comandos com indentação compatíveis com os scripts de gatilho v2 do RisuAI, então a automação de cartões existentes importa e funciona.

Scripts com acesso de baixo nível destravam efeitos que saem do chat:

runLLM checkSimilarity extractRegex runImgGen showAlert sendAIprompt triggerlua

Efeitos de LLM e imagem chamam modelos reais e custam tokens; exigem login e correm pela sua conta.

Para lógica além da VM de gatilhos, personagens podem carregar Lua. O runtime embutido expõe uma API de cerca de 50 funções: acesso ao chat, variáveis, alertas, chamadas de LLM e mais, compatível com a superfície Lua do 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 pode registrar ganchos que reescrevem texto em pleno voo: sua entrada antes da montagem, a saída do modelo antes de salvar e a requisição bruta logo antes do envio.

Ganchos rodam em ordem com os scripts regex da mesma etapa; use o registro de requisições para ver o resultado final do fluxo inteiro.

Os modos de exibição e requisição rodam em uma sandbox com comandos restritos. Scripts não alcançam sua conta, chaves nem outras conversas; o pior que um script ruim faz é embaralhar o próprio chat.