Disparadores y condiciones
Alertas, Objetivos y subathon y Contadores de stream no usan una lista fija de eventos. Cada una de sus tablas tiene filas, y cada fila es un disparador de Streamer.Bot que has elegido — con, si quieres, una condición. En Alertas y en Objetivos y subathon, una fila también puede publicar un mensaje de chat y reproducir un sonido, y en Alertas mostrar su propia imagen y publicar un mensaje de Discord. Las categorías y los disparadores de vaciado de los Créditos finales, así como los disparadores de reinicio, de mostrar y de ocultar del Primero del chat, de los Contadores de stream y del Contador de espectadores, se eligen igual. Los disparadores que muestran, ocultan, reinician o vacían un widget están en la pestaña Controles de su página.
En Alertas y en el Tiempo añadido del subathon, las filas forman una lista aparte (Lista de alertas, Lista de disparadores): elige ahí una fila para editarla en la zona principal — Cambiar de disparador vuelve a abrir el selector, y después su título y su texto (o sus segundos), su imagen, su mensaje de chat, su mensaje de Discord y su sonido como campos. En los demás sitios, forman una tabla.
Añadir un disparador
Cada lista o tabla tiene un botón Añadir disparador. Abre Configurar disparador:
- Disparador muestra el propio menú de disparadores de Streamer.Bot, con las mismas secciones y nombres que en Streamer.Bot — por ejemplo Twitch › Subscriptions › Gift Subscription. Solo aparece la plataforma o integración de la tabla.
- Solo aparecen los disparadores que ofrece tu Streamer.Bot conectado, así que tienes que estar conectado para elegir uno.
- Guardar disparador añade la fila. El lápiz de una fila vuelve a abrir la ventana; la × la elimina.
Una fila cuyo disparador ya no ofrece tu Streamer.Bot indica Disparador no encontrado: edítalo para elegir otro.
Condiciones
Activa Activar cuando se cumpla una condición concreta para que una fila solo reaccione a algunos eventos de su disparador — un resub de 12 meses o más, un cheer de entre 100 y 499 bits, una recompensa con un nombre concreto.
| Campo | Detalle |
|---|---|
| Nombre de la variable | La variable del evento que mirar, escrita con su nombre completo dentro del data del evento, por ejemplo months, user.name o scene.sceneName. Encuentras los nombres en la documentación de eventos WebSocket de Streamer.Bot, o con el botón Inspector de eventos junto al campo (su botón de copiar te da el nombre listo para pegar). |
| Tipo de variable | Texto, Número o Booleano. |
| Coincidencia | Un solo valor, Un rango de valores, Una lista de valores o Cada múltiplo de un número. |
| Operación | Para un solo valor: = (Equals), ≠ (Distinto), Empieza por (solo Texto, sin distinguir mayúsculas y minúsculas: un archivo en una carpeta), > (Mayor que), < (Menor que), ≥ (Mayor o igual), ≤ (Menor o igual). |
| Valor | El valor que debe tener la variable; para un booleano, Verdadero o Falso. |
Las cuatro coincidencias:
| Coincidencia | Se cumple cuando la variable… | Disponible para |
|---|---|---|
| Un solo valor | se compara con el valor según la operación | Texto (=, ≠ y Empieza por), Número, Booleano (=) |
| Un rango de valores | está entre Desde y Hasta, ambos incluidos | Número |
| Una lista de valores | es igual a alguno de los Valores separados por comas | Texto, Número |
| Cada múltiplo de un número | es múltiplo de Cada (3 → 3, 6, 9…) | Número |
La fila muestra entonces su condición bajo el nombre del disparador, por ejemplo
months ≥ 12, months 6–11, streak ∈ 3, 6, 9 o streak ×3.
obs.sceneName, pero
scene.sceneName en el payload. Toma siempre el nombre de la documentación de eventos
WebSocket o del Inspector de eventos, sin el data. del principio.Varias filas para un disparador
Puedes añadir el mismo disparador varias veces con condiciones distintas. En Alertas, un
evento muestra la primera fila cuya condición cumple; si ninguna coincide, la fila de
ese disparador sin condición; si no la hay, nada. Un ajuste típico: una fila «Resub»
sin condición, y otra con months ≥ 12 y un agradecimiento más grande.
Disparar un widget desde tus propias acciones
Cualquier lista de disparadores puede reaccionar a una de tus propias acciones de Streamer.Bot — una recompensa, un comando, un minijuego — mediante un evento personalizado. Ejemplo: mostrar una cuenta atrás cuando se ejecuta tu acción.
Lanza un evento personalizado desde tu acción
En Streamer.Bot, añade una subacción Custom Event Trigger a tu acción. Ponle un nombre,
por ejemplo Show Muted Timer, y marca Use Args si el widget debe usar información de
la acción (quién la disparó, su plataforma…).
Añade el disparador en la página del widget
Haz clic en Añadir disparador en la lista que debe reaccionar: para una cuenta atrás, Mostrar en su pestaña Controles. Elige Custom › Other › Event.
Quédate solo con tu evento
Activa Activar cuando se cumpla una condición concreta y rellena:
| Campo | Valor |
|---|---|
| Nombre de la variable | eventName |
| Tipo de variable | Texto |
| Coincidencia | Un solo valor |
| Operación | = (Igual) |
| Valor | El nombre que le diste al evento personalizado, por ejemplo Show Muted Timer |
Haz clic en Guardar disparador.
Sin la condición, la fila reaccionaría a todos los eventos personalizados que lanzan tus acciones.
args: usa
cualquiera de ellos como args.<nombre>, en las condiciones y en los textos — por ejemplo
args.user, args.eventSource o args.rewardName, para que el Plantilla del texto de una
cuenta atrás muestre ¡{args.user} me ha silenciado!. Los nombres con puntos o corchetes se
escriben tal cual: args.reward.title, args.match[0]. El Inspector de eventos muestra
todos los argumentos que envía tu acción.Variables de texto
Títulos, textos y mensajes de chat aceptan variables entre llaves, con el nombre que
les da Streamer.Bot en el payload del evento: {user.name}, {bits},
{recipient.name}, {amount}… Cada uno es su nombre completo dentro del data del evento,
leído exactamente como lo escribes.
Los nombres de cada disparador están en la documentación de eventos WebSocket de Streamer.Bot, enlazada bajo cada tabla. Una variable que el evento no trae se queda tal cual, con sus llaves — una forma rápida de ver una errata en la vista previa.
Qué suma una fila de objetivo
En los objetivos y en los disparadores que suben los Contadores de stream, cada fila indica además lo que suma — Progreso del objetivo en los objetivos, Lo que suma en los Contadores de stream:
- Sumar 1 — cada evento cuenta uno.
- Sumar el valor de una variable — el evento suma el valor de una de sus variables,
escrita en Nombre de la variable con su nombre completo dentro de
data, por ejemplobitsen un cheer,gift.amounten Kicks.
Los Restar triggers de los Contadores de stream indican en cambio Lo que resta: Restar 1 o Restar el valor de una variable.
El disparador de un objetivo de subathon tiene además, debajo, Timer del subathon incrementation y sus Segundos añadidos: el tiempo que añade por cada 1 contado (por bit, por €…). → Tiempo añadido
El marcador y las Tarjetas de espectadores lo llaman Incremento de la puntuación, con una opción más: Fijar el valor de una variable, y debajo Only replace if the new value is higher than the current value para guardar el valor más alto visto (pico de espectadores).
Un mensaje de chat por fila
El botón con forma de bocadillo de una fila — en Alertas y en el Tiempo añadido del subathon, el interruptor Enviar un mensaje al chat de la fila elegida, con Ajustes del mensaje en el chat a su derecha, que abre la ventana Mensaje en el chat mientras está activado — añade un Mensaje en el chat, que se envía cuando la fila se dispara:
| Campo | Detalle |
|---|---|
| Mensaje en el chat | Por ejemplo Thank you {user.name}!. Las mismas variables de arriba. |
| Publicar en | Twitch, YouTube, Kick. Un disparador de plataforma publica por defecto en su propia plataforma; uno de integración, en todas las plataformas donde Streamer.Bot tiene sesión iniciada. |
| Enviar con el bot | Activado por defecto. Donde no hay cuenta de bot (YouTube no indica ninguna), lo envía la cuenta de broadcaster. |
El Saludo a los chatters y las Recompensas por actividad tienen el mismo mensaje fuera de cualquier fila: un interruptor Enviar un mensaje al chat, luego Enviar con el bot en la misma línea, el mensaje y, cuando sirve, Publicar en. Al activarlo sin plataforma elegida, marca las plataformas donde Streamer.Bot tiene una cuenta conectada.
Un sonido por fila
El botón del altavoz (Reproducir un sonido) abre la ventana del sonido — Sonido de la alerta en las filas de disparadores. Guardarla activa el sonido; volver a pulsar el altavoz lo desactiva, y el lápiz de al lado lo edita. En una alerta, un interruptor Reproducir un sonido activa y desactiva el sonido (nunca abre la ventana), y Ajustes del sonido, a su derecha, activo mientras está activado, abre la ventana. El Saludo a los chatters (Sonido del saludo) y las Encuestas y predicciones (Sonido de las encuestas de Twitch, Sonido de las predicciones de Twitch or Sonido de las encuestas de YouTube) usan la misma ventana.
Un sonido viene de uno de estos tres sitios:
| Origen | Detalle |
|---|---|
| Archivo en este PC | Archivo de sonido, por ejemplo C:\Sounds\alert.mp3. Examinar… abre el selector de archivos de Windows en el PC donde funciona Streamer.Bot. |
| Archivo de una carpeta | Carpeta de sonidos, por ejemplo C:\Sounds\Alerts: cada vez suena un archivo al azar de la carpeta. Incluir subcarpetas añade los de las subcarpetas. |
| Enlace | Enlace del archivo de sonido: un enlace directo a un archivo de audio. La fuente de navegador lo carga desde ahí, así que el enlace debe seguir en línea — los enlaces temporales, como los adjuntos de Discord, dejan de funcionar al cabo de un tiempo. |
Los archivos y las carpetas los reproduce el propio Streamer.Bot, mediante la acción Stream UI - Sounds, en su salida de audio por defecto. Examinar… necesita Streamer.Bot conectado y el código más reciente de Stream UI - Backend. Cada origen tiene Reproducir para probarlo y Volumen de 0 a 100 % (80 por defecto). Archivos y carpetas tienen además:
| Ajuste | Por defecto | Detalle |
|---|---|---|
| Terminar antes del siguiente sonido | desactivado | El sonido siguiente espera a que termine este (la acción Sounds debe estar en una cola bloqueante). |
| Detener los demás sonidos | desactivado | Para primero todos los sonidos que esté reproduciendo Streamer.Bot. |
| Usar el nombre del archivo como nombre as name | activado | Desactivado: el campo Nombre del sonido da nombre al sonido en Streamer.Bot. |
Cancelar cierra la ventana, Guardar sonido guarda el sonido.
En Alertas, el sonido suena cuando la alerta se muestra de verdad: una alerta en cola reproduce su sonido cuando le llega el turno. En el Tiempo añadido del subathon, suena cuando el evento cuenta. Un objetivo tiene un sonido propio, que suena cuando se alcanza, y una cuenta del subathon también, que suena en cada hito. Los sonidos solo los reproduce el overlay que ejecuta las acciones. La vista previa del sitio reproduce los enlaces, nunca los archivos: un archivo sonaría en directo.
Una imagen por fila
En Alertas, el interruptor Usar la foto de perfil del espectador de una alerta y Ajustes de la imagen, a su derecha, eligen su imagen: la foto de perfil del espectador o una imagen que subas, con el estilo de la Imagen de las alertas (pestaña Estilo) o con uno propio. → Alertas › La imagen
Un mensaje de Discord por fila
En Alertas, en cuanto Publicar las alertas en Discord está activado (Ajustes de las alertas), cada alerta tiene un interruptor Publicar en Discord, y Ajustes del mensaje de Discord a su derecha, activo mientras está activado, abre Mensaje de Discord: reutiliza el mensaje de chat de la alerta o escribe uno propio. Publicarlo en nombre del espectador o con el nombre por defecto se ajusta con el webhook. Como los mensajes de chat, solo lo envía el overlay que ejecuta las acciones. Configurar el webhook → Alertas › Webhooks de Discord.
Conexión
Conectarte al servidor WebSocket de Streamer.Bot, instalar el paquete de cuatro acciones, elegir plataformas e integraciones y guardar una copia de tus ajustes.
Chat
Chat multiplataforma con emotes, insignias, anuncios de Twitch, canjes de puntos de canal, Bits, Kicks, Super Chats y Jewels de YouTube, y un relé de chat opcional entre tus plataformas.