Documentação

Guia completo de variáveis e comandos para personalizar suas interações.

Como usar Variáveis

As variáveis permitem que você crie comandos dinâmicos. Basta inserir o nome da variável entre chaves{ }e ela será substituída automaticamente pelo valor correspondente quando o comando for executado.

Expressões e Lógica

Além das variáveis, você pode combinar valores, condições, sorteios e cálculos para criar comandos interativos. Use {Set ...}para guardar um valor temporariamente e reutilizá-lo.

Exemplo

{Set numero = {Random.Number(1-100)}}🎲 Número: {numero} — {If({numero} >= 50|Ganhou!|Perdeu!)}

Dica: salve o resultado de sorteios em uma variável quando precisar usar o mesmo valor mais de uma vez.

Variáveis TemporáriasCrie valores durante a execução do comando e reutilize-os em outras expressões.

{Set nome = valor}

Cria uma variável temporária disponível durante a execução do comando.

Exemplo

{Set numero = {Random.Number(1-100)}} Número: {numero}

{Set numero = {Random.Number(1-100)}}

Guarda o resultado de uma expressão para reutilizá-lo sem gerar um novo valor.

Exemplo

{Set numero = {Random.Number(1-100)}}🎲 {numero}

CondicionaisExecute textos diferentes de acordo com condições.

{If(condição|verdadeiro|falso)}

Retorna o segundo texto quando a condição é verdadeira e o terceiro quando é falsa.

Exemplo

{If({numero} >= 50|Ganhou!|Perdeu!)}

Operadores: == != < <= > >=

Compare valores usando os principais operadores de comparação.

Exemplo

{If({numero} >= 50|🔥 Alto|💀 Baixo)}

AND / OR

Combine condições usando AND ou OR.

Exemplo

{If({numero} >= 50 AND {numero} <= 80|Entre 50 e 80|Fora da faixa)}

Valores booleanos

Condições podem trabalhar com true/false, verdadeiro/falso e 1/0.

Exemplo

{If(true|Ativado|Desativado)}

Operações MatemáticasFaça cálculos usando valores fixos ou variáveis.

{Math(expressão)}

Calcula uma expressão matemática.

Exemplo

{Set numero = 25} Dobro: {Math({numero} * 2)}

{Min(valor1|valor2|...)}

Retorna o menor valor informado.

Exemplo

{Min(10|20|5)} → 5

{Max(valor1|valor2|...)}

Retorna o maior valor informado.

Exemplo

{Max(10|20|5)} → 20

{Clamp(valor|min|max)}

Mantém um valor dentro de um intervalo.

Exemplo

{Clamp(150|0|100)} → 100

Aleatoriedade e ChanceCrie sorteios, dados, probabilidades e minigames.

{Random.Number(min-max)}

Gera um número aleatório entre os limites informados.

Exemplo

{Set dado = {Random.Number(1-100)}}🎲 {dado}

{Random.Option(Opção1|Opção2|...)}

Escolhe aleatoriamente uma das opções.

Exemplo

{Random.Option(Pizza|Hambúrguer|Sushi)}

{Random.Percent(porcentagem)}

Gera um resultado de chance baseado na porcentagem informada.

Exemplo

{If({Random.Percent(30)}|🎉 Ganhou!|💀 Perdeu!)}

Texto e ValidaçõesTransforme textos e faça verificações dentro das condições.

{Equals(valor1|valor2)}

Verifica se dois valores são iguais.

Exemplo

{If({Equals({User.Name}|medronic)}|👑 Dono|Usuário)}

{Contains(texto|trecho)}

Verifica se um texto contém determinado trecho.

Exemplo

{If({Contains({Channel.Category}|Minecraft)}|🎮 Minecraft|Outro jogo)}

{Empty(valor)}

Verifica se um valor está vazio.

Exemplo

{If({Empty({User.Target})}|❌ Mencione alguém!|🎯 Alvo encontrado)}

{Exists(valor)}

Verifica se um valor existe ou está disponível.

Exemplo

{If({Exists({User.Target})}|🎯 Alvo encontrado|Nenhum alvo)}

{Text.Upper(texto)}

Converte o texto para letras maiúsculas.

Exemplo

{Text.Upper({User.Name})}

{Text.Lower(texto)}

Converte o texto para letras minúsculas.

Exemplo

{Text.Lower({User.Name})}

{Text.Capitalize(texto)}

Coloca a primeira letra do texto em maiúscula.

Exemplo

{Text.Capitalize(olá mundo)}

{Text.Length(texto)}

Retorna a quantidade de caracteres do texto.

Exemplo

{Text.Length({Channel.Title})}

Exemplos CompletosCombinações para criar comandos interativos mais avançados.

🎲 Sistema de sorte

Use o mesmo número sorteado para exibição e comparação.

Exemplo

{Set numero = {Random.Number(1-100)}}🎲 {numero} — {If({numero} >= 50|Ganhou!|Perdeu!)}

🏆 Resultado por faixa

Use condições aninhadas para criar diferentes níveis de resultado.

Exemplo

{Set n = {Random.Number(1-100)}}{If({n} >= 90|🔥 Crítico!|{If({n} >= 50|👍 Bom!|💀 Baixo!)}}

🧮 Variável + cálculo

Uma variável pode ser usada dentro de outra expressão.

Exemplo

{Set numero = {Random.Number(1-100)}}{Set dobro = {Math({numero} * 2)}}Dobro: {dobro}

Usuários e AlvosVariáveis relacionadas aos usuários envolvidos no comando.

{User.Name}

Nome de exibição do usuário que executou a ação.

Exemplo de Saída

Olá {User.Name}!

{User.Target}

Primeiro argumento do comando (alvo).

Exemplo de Saída

Abraço em {User.Target}!

{User.Target.Optional}

Alvo ou o próprio usuário se não houver alvo.

Exemplo de Saída

Verificar {User.Target.Optional}

{User.Mentioned}

Usuário mencionado na mensagem.

Exemplo de Saída

Falando com {User.Mentioned}

{User.Followage}

Tempo que o usuário segue o canal.

Exemplo de Saída

Segue há {User.Followage}.

{Random.Viewer}

Seleciona um espectador aleatório do chat.

Exemplo de Saída

O vencedor é {Random.Viewer}!

Gerenciamento do CanalComandos para alterar informações ou gerenciar a live.

{Channel.SetTitle}

Altera o título da live (texto após o comando).

Exemplo de Saída

{Channel.SetTitle} Novo Título

{Channel.SetCategory}

Altera a categoria/jogo da live.

Exemplo de Saída

{Channel.SetCategory} Just Chatting

{CreateClip}

Cria um clipe dos últimos 30 segundos.

Exemplo de Saída

Clip criado: {CreateClip}

{StartComercial}

Inicia um intervalo comercial.

Exemplo de Saída

Comercial iniciando... {StartComercial}

{Shoutout}

Envia uma divulgação (Shoutout) para o alvo.

Exemplo de Saída

{Shoutout} @streamer

Informações do Canal e StreamDados sobre o canal e a transmissão atual.

{Channel.Name}

Nome do streamer/dono do canal.

Exemplo de Saída

Canal de {Channel.Name}

{Channel.Title}

Exibe o título atual da live.

Exemplo de Saída

Título: {Channel.Title}

{Channel.Category}

Exibe o jogo/categoria atual.

Exemplo de Saída

Jogando: {Channel.Category}

{Channel.Avatar}

URL do avatar do canal.

Exemplo de Saída

Avatar: {Channel.Avatar}

{Channel.Status}

Status atual do canal (Online/Offline).

Exemplo de Saída

Status: {Channel.Status}

{Channel.Uptime}

Tempo de duração da live atual.

Exemplo de Saída

Live on há: {Channel.Uptime}

{Channel.Followers}

Número total de seguidores.

Exemplo de Saída

Somos {Channel.Followers} seguidores!

{Channel.UsersInChat}

Número de usuários conectados no chat.

Exemplo de Saída

{Channel.UsersInChat} pessoas no chat.

{Broadcaster.Following}

Número de canais que o streamer segue.

Exemplo de Saída

Seguindo {Broadcaster.Following} canais.

Diversão, Jogos e IAVariáveis para minigames, interações e IA.

{Random.Number(min-max)}

Gera um número aleatório entre min e max.

Exemplo de Saída

Dado: {Random.Number(1-6)}

{Random.Option(Op1|Op2)}

Escolhe aleatoriamente entre as opções.

Exemplo de Saída

Eu escolho {Random.Option(Pizza|Hambúrguer)}

{Wps.AI.Chat}

Gera uma resposta inteligente usando IA.

Exemplo de Saída

IA diz: {Wps.AI.Chat}

{Wps.Game.NeverHaveI}

Frase aleatória de "Eu Nunca".

Exemplo de Saída

Eu nunca {Wps.Game.NeverHaveI}

{Wps.Game.Adjective}

Adjetivo aleatório (ex: "Eu sou...").

Exemplo de Saída

Eu sou {Wps.Game.Adjective}

{Wps.Game.Question}

Pergunta aleatória para o chat.

Exemplo de Saída

Pergunta: {Wps.Game.Question}

{Wps.Game.DBD.Shrine}

Mostra o santuário (Shrine) do Dead by Daylight.

Exemplo de Saída

Santuário: {Wps.Game.DBD.Shrine}

Utilitários e SistemaFerramentas avançadas e integrações.

{ReadAPI(url)}

Faz uma requisição GET na URL e retorna o texto.

Exemplo de Saída

{ReadAPI(https://api.exemplo.com/dado)}

Variáveis de Eventos (EventSub)Disponíveis apenas em notificações de eventos (Raid, Sub, Bits, etc).

{User.Name}

Nome do usuário (em eventos específicos).

Exemplo de Saída

Obrigado {User.Name}!

{UserOrAnonymous}

Nome do usuário ou "Anônimo".

Exemplo de Saída

Obrigado {UserOrAnonymous}!

{Broadcaster.Name}

Nome do dono do canal.

Exemplo de Saída

Canal de {Broadcaster.Name}

{Stream.Title}

Título da stream (em eventos).

Exemplo de Saída

Live: {Stream.Title}

{Stream.Category}

Categoria da stream (em eventos).

Exemplo de Saída

Jogo: {Stream.Category}

{Raid.From.Name}

Nome do canal que enviou a Raid.

Exemplo de Saída

Raid de {Raid.From.Name}!

{Raid.ViewersCount}

Número de espectadores na Raid.

Exemplo de Saída

Raid com {Raid.ViewerCount} pessoas.

{Sub.GiftTotal}

Total de inscrições presenteadas.

Exemplo de Saída

{Sub.GiftTotal} subs de presente!

{Bits}

Quantidade de Bits enviados.

Exemplo de Saída

{Bits} bits recebidos!

{Requester.Name}

Nome de quem resgatou a recompensa.

Exemplo de Saída

Pedido por {Requester.Name}

{Duration}

Duração (ex: Predição ou Enquete).

Exemplo de Saída

Duração: {Duration} segundos

{StartedAt}

Data/Hora de início do evento.

Exemplo de Saída

Iniciou em: {StartedAt}