Variáveis Globais — LarvoLabs Docs

Argumentos

Tudo que o usuário digitar após o nome do comando vira um argumento. As variáveis abaixo permitem capturar partes específicas desse texto de formas diferentes.

Variável	Retorno	Comportamento
`$(args)`	Texto completo	Retorna tudo que foi digitado após o comando, sem modificar.
`$(args.first)`	Primeira palavra	Filtra apenas a primeira palavra isolada. Ideal para capturar nomes de usuário.
`$(args.number)`	Primeiro número	Procura o primeiro valor numérico inteiro no argumento (ignora letras ao redor).
`$(args.random)`	Palavra aleatória	Sorteia uma palavra aleatória dentre todas as digitadas no argumento.

Exemplos de Configuração

!so — Shoutout em outro canal

Vai dar uma olhada no canal do $(args.first)! twitch.tv/$(args.first)

Usuário digita: !so streamer

Vai dar uma olhada no canal do streamer! twitch.tv/streamer

!dado — Dado com número de lados personalizado

$(user) rolou um d$(args.number) e tirou: $(random.number 1-$(args.number))! 🎲

Usuário digita: !dado 20

Chatter rolou um d20 e tirou: 14! 🎲

!repita — Repete a mensagem enviada

📣 $(user) disse: $(args)

Usuário digita: !repita olá pessoal

📣 Chatter disse: olá pessoal

!sorteio — Sorteia uma palavra dos argumentos

$(user) entrou na roleta! Saiu: $(args.random) ✨

Usuário digita: !sorteio espada escudo arco

Chatter entrou na roleta! Saiu: escudo ✨

Próximo: Usuário →

Usuário

Identifique quem disparou o comando ou quem foi mencionado via arroba (@alguem) na mesma mensagem.

Variável	Retorno	Comportamento
`$(user)`	Autor do comando	Nome limpo de quem digitou, sem o símbolo de @.
`$(touser)`	Alvo da menção	Busca um `@mencionado` na mensagem. Se não houver, usa a primeira palavra do argumento. Se não houver nada, usa o próprio autor.

Exemplos de Configuração

!hug — Abraço entre usuários

$(user) acaba de dar um abraço virtual em $(touser)! 🤗

Usuário digita: !hug @Ninja

Chatter acaba de dar um abraço virtual em Ninja! 🤗

!bom-dia — Cumprimentar o chat

Bom dia, $(user)! Que sua live seja incrível hoje! ☀️

Usuário digita: !bom-dia

Bom dia, Chatter! Que sua live seja incrível hoje! ☀️

!slap — Bater em alguém

$(user) bateu uma truta na cara de $(touser)! 🐟

Usuário digita: !slap @Chatter

Chatter bateu uma truta na cara de Chatter! 🐟

!vip — Anunciar VIP

🌟 Bem-vindo ao time VIP, $(touser)! Obrigado pelo suporte!

Streamer digita: !vip @Chatter

🌟 Bem-vindo ao time VIP, Chatter! Obrigado pelo suporte!

← Anterior Próximo: Canal →

Canal Twitch

Dados consultados em tempo real via API Helix da Twitch. Todas as variáveis utilizam sistema de cache automático para evitar limites de requisição.

⚠️

Atenção: Estas variáveis são exclusivas para Twitch. Se acionadas via YouTube ou Kick, retornarão string vazia em vez de causar erros na mensagem.

Variável	Retorno	Comportamento
`$(game)`	Categoria Atual	Nome oficial do jogo ou categoria da live. (Cache de 60s)
`$(title)`	Título da Live	Texto exato do título configurado na transmissão. (Cache de 60s)
`$(streamtime)`	Tempo Ativo	Tempo de live no formato "2h 34m" ou "offline" se não estiver ao vivo. (Cache de 30s)
`$(channelurl)`	URL da Transmissão	Link direto para a live do streamer atual. Ex: twitch.tv/streamer
`$(channelurl.user)`	URL do Alvo	Gera o link para o canal do usuário salvo em `$(touser)`.

Exemplos de Configuração

!uptime — Tempo ao vivo

Estamos ao vivo há $(streamtime) jogando $(game)! 🎮

Saída no Chat

Estamos ao vivo há 2h 14m jogando Minecraft! 🎮

!live — Info completa da live

📺 $(title) — jogando $(game) há $(streamtime). Assista em $(channelurl)

Saída no Chat

📺 Ranked ao cubo — jogando Valorant há 1h 08m. Assista em twitch.tv/streamer

!so — Shoutout com link automático

👀 Vai ver o $(touser) que é muito bom em $(game)! Confere em $(channelurl.user)

Streamer digita: !so @Streamer

👀 Vai ver o Streamer que é muito bom em Minecraft! Confere em twitch.tv/Streamer

!titulo — Mostrar título atual

O título da live é: $(title)

Saída no Chat

O título da live é: Ranked ao cubo — dia 4

← Anterior Próximo: Contadores →

Contadores Persistentes

Contadores armazenados em banco de dados isolado por canal. Os valores ficam salvos entre streams — perfeitos para rastrear mortes, vitórias, pontos e muito mais.

💡

Dica: O nome do contador pode ser qualquer palavra sem espaços, ex: mortes, wins, frango. Cada canal tem seu próprio banco separado.

Variável	Ação	Comportamento
`$(count nome)`	Consultar	Retorna o valor atual. Se o contador não existir, retorna `0`.
`$(count.add nome)`	Incrementar +1	Soma +1 ao registro e retorna o novo valor imediatamente.
`$(count.sub nome)`	Decrementar -1	Subtrai -1. Suporta valores negativos.
`$(count.reset nome)`	Zerar	Redefine o valor para `0` imediatamente.
`$(count.del nome)`	Deletar	Remove o contador completamente do banco de dados.

Exemplos de Configuração

!morte — Registrar uma morte

💀 O streamer morreu de novo! Mortes totais: $(count.add mortes)

Saída no Chat

💀 O streamer morreu de novo! Mortes totais: 7

!mortes — Consultar placar de mortes

Contador de mortes desta run: $(count mortes) 💀

Saída no Chat

Contador de mortes desta run: 7 💀

!win / !loss — Rastrear vitórias e derrotas

🏆 Vitória registrada! Placar: $(count.add wins)W / $(count losses)L

Saída no Chat

🏆 Vitória registrada! Placar: 5W / 3L

!resetmortes — Zerar contador ao iniciar nova run

🔄 Nova run iniciada! Contador zerado. Vamos lá! $(count.reset mortes)

Saída no Chat

🔄 Nova run iniciada! Contador zerado. Vamos lá! 0

!pontos — Sistema de pontos manual

$(user) ganhou um ponto! Total: $(count.add pts_$(user)) pontos 🌟

Saída no Chat

Chatter ganhou um ponto! Total: 4 pontos 🌟

← Anterior Próximo: Aleatórios →

Processos Aleatórios

Variáveis destinadas a criar engajamento imprevisível. Desde sorteios numéricos até escolhas entre listas de opções personalizadas.

Variável	Retorno	Comportamento
`$(random.number MIN-MAX)`	Inteiro no Limite	Sorteia um número inteiro entre MIN e MAX (ambos inclusos).
`$(random.chatter)`	Usuário Aleatório	Pesca um usuário ativo no chat. Apenas Twitch.
`$(random.pick "Op1","Op2")`	Opção da Lista	Escolhe uma string aleatória entre as opções separadas por vírgula e aspas.

Exemplos de Configuração

!sorte — Previsão aleatória do dia

$(user), sua previsão de hoje é: $(random.pick "Ótima 🍀","Boa 😊","Neutra 😐","Ruim 😬","Péssima 💀")

Saída no Chat

Chatter, sua previsão de hoje é: Boa 😊

!dado — Rolar um d6 clássico

🎲 $(user) rolou um dado e tirou: $(random.number 1-6)

Saída no Chat

🎲 Chatter rolou um dado e tirou: 4

!sorteio — Sortear um viewer do chat

🎉 O sortudo de hoje é: $(random.chatter)! Parabéns!

Saída no Chat

🎉 O sortudo de hoje é: Viewer123! Parabéns!

!rota — Escolher rota ou estratégia aleatória

A rota desta run será: $(random.pick "Rush B","Eco round","Full buy","Force buy","Save")! 🎯

Saída no Chat

A rota desta run será: Rush B! 🎯

!porcentagem — Gerar uma porcentagem fake

$(user) tem $(random.number 1-100)% de chance de ganhar hoje 📊

Saída no Chat

Chatter tem 73% de chance de ganhar hoje 📊

← Anterior Próximo: Matemática →

Matemática Segura

O parser matemático da LarvoLabs resolve expressões dinâmicas de forma estrita e segura, bloqueando qualquer tentativa de injeção de código via chat.

💡

Combinável: $(math) aceita outras variáveis dentro da expressão, como contadores e argumentos numéricos.

Variável	Operadores	Resultado
`$(math EXPRESSÃO)`	`+ - * / ** ()`	Resolve a equação e retorna o valor numérico final.

Exemplos de Configuração

!wr — Winrate calculado automaticamente

Winrate atual: $(math $(count wins)*100/($(count wins)+$(count losses)))% 📈

Saída no Chat

Winrate atual: 70% 📈

!dano — Calcular dano com bônus

$(user) causou $(math $(args.number)*1.5) de dano com o bônus! ⚔️

Usuário digita: !dano 200

Chatter causou 300 de dano com o bônus! ⚔️

!kda — Ratio de K/D

KDA atual: $(count kills)/$(count deaths)/$(count assists) — Ratio: $(math $(count kills)/$(count deaths))

Saída no Chat

KDA atual: 12/4/8 — Ratio: 3

!tempo — Converter minutos em horas

$(user) ficou $(args.number) minutos na live, ou seja $(math $(args.number)/60) horas! ⏱️

Usuário digita: !tempo 120

Chatter ficou 120 minutos na live, ou seja 2 horas! ⏱️

← Anterior Próximo: Quotes →

Quotes do Canal

Sistema de registro de momentos épicos, piadas internas e frases marcantes. Suporta até 5.000 entradas de 500 caracteres cada por canal.

Variável	Ação	Comportamento
`$(quote.add TEXTO)`	Salvar Quote	Armazena a citação e retorna o ID numérico gerado.
`$(quote.rem ID)`	Deletar Quote	Remove o registro associado ao ID especificado.
`$(quote.get ID)`	Buscar por ID	Exibe a quote exata relacionada ao número informado.
`$(quote.random)`	Quote Aleatória	Sorteia e exibe uma quote aleatória do banco de dados do canal.

Exemplos de Configuração

!quote — Exibir quote aleatória

💬 Relembrando: $(quote.random)

Saída no Chat

💬 Relembrando: #17 — "Essa run foi insana!" — streamer

!addquote — Salvar uma frase épica

✅ Quote adicionada com sucesso! ID: $(quote.add $(args))

Usuário digita: !addquote Nunca vou errar isso de novo

✅ Quote adicionada com sucesso! ID: #42

!getquote — Buscar por ID específico

📖 Quote #$(args.number): $(quote.get $(args.number))

Usuário digita: !getquote 17

📖 Quote #17: "Essa run foi insana!" — streamer

!delquote — Remover quote (mod only)

🗑️ Quote #$(args.number) removida. $(quote.rem $(args.number))

Mod digita: !delquote 5

🗑️ Quote #5 removida.

← Anterior