La_Syl Studio
Guía de widgets

Recompensas por actividad

Ejecuta tus propias acciones de Streamer.Bot y publica mensajes en el chat cuando el chat alcanza los números de mensajes que fijas, para todo el chat y para cada espectador.

Premia un chat animado. Cuando todo el chat llega a 100 mensajes, o un espectador llega a su mensaje 500, Stream UI ejecuta tu propia acción de Streamer.Bot — un sonido, un cambio de escena, una participación en un sorteo, lo que construyas — y puede publicar un mensaje en el chat.

No tiene nada visible: nada en pantalla, ni posición, ni estilo, ni vista previa.

Plataformas: Twitch, YouTube, Kick

Paquete de acciones: Stream UI - Backend mientras cuenta este widget, y para la pausa → Pausa y reanudación. No hace falta para contar cuando las cuentas vienen del marcador o de las tarjetas de espectadores. → Quién necesita qué

¿Ya cuentas los mensajes con una estadística del marcador o una puntuación de las tarjetas de espectadores? Activa Contado por el Marcador (todo el chat) o Contado por las Tarjetas de espectadores (cada espectador) y las recompensas siguen su cuenta.

Cómo funciona

  • Dos cuentas. Todo el chat cuenta todos los mensajes de todas las plataformas activadas. Cada espectador cuenta los mensajes de cada espectador. Cada una tiene su interruptor y sus propias recompensas.
  • Una vez por cruce. Una recompensa salta cuando su cuenta pasa de estar por debajo de su número a alcanzarlo o superarlo. Su acción recibe al chatter que lo ha alcanzado (mira Action arguments).
  • Una recarga no vuelve a disparar nada. Lo ya contado al cargar la fuente de navegador es el punto de partida.
  • Funciona en el overlay que ejecuta las acciones, mientras el widget está activado — no tiene URL propia. → Qué overlay ejecuta las acciones
  • Se quedan fuera: los usuarios ignorados y tus propias cuentas de emisor y de bot nunca se cuentan ni se premian.

Quién cuenta

Contado aquíContado por el marcador / las tarjetas de espectadores
Todo el chatLa variable global streamUi.chatRewards.countEn cada plataforma activada, la variable global temporal de la primera estadística del marcador cuyos disparadores cuentan los mensajes del chat de esa plataforma, ss.<platform>.<name>.currentScore, sumadas
Cada espectadorLa variable de usuario chatMessages de cada espectadorEn cada plataforma, la variable de espectador de la primera puntuación de las tarjetas de espectadores cuyos disparadores cuentan sus mensajes del chat (la primera columna, Today por defecto)

El widget encuentra esas estadísticas en los ajustes del marcador y de las tarjetas de espectadores: una plataforma sin ninguna no cuenta nada.

Contadas aquí, las cuentas son temporales — se borran al reiniciar Streamer.Bot — salvo si Contar desde siempre está activado. Se escriben en Streamer.Bot por lotes, más o menos una vez por segundo.

La página

La página del widget funciona como una pequeña aplicación, sin vista previa (no hay nada que mostrar):

  • Ajustes y Controles, las pestañas encima del editor, cambian lo que muestra. En la pestaña Controles, Pausar y Reanudar y sus disparadores → Pausa y reanudación.
  • La columna de la izquierda lista sus dos cuentas, Todo el chat y Cada espectador, cada una con su interruptor en su fila (todo el chat: activado, cada espectador: desactivado por defecto). Siguen el interruptor del widget, junto al título de la página: desactivar el widget desactiva las dos, activarlo activa las dos, y volver a activar una cuenta vuelve a activar el widget. Con las dos cuentas desactivadas, el widget está desactivado.
  • Todo el chat y Cada espectador abren cada uno una columna propia: Variable, los ajustes de esa cuenta, y Recompensas, que abre la Lista de recompensas. Ahí añades, reordenas, duplicas o borras recompensas; la elegida se edita en la zona principal.

Puesta en marcha

Crea tu acción en Streamer.Bot

Crea la acción que ejecuta la recompensa. No hace falta disparador: Stream UI la llama por su nombre.

Activa el widget

Está en el grupo Chat y activado por defecto, pero su recompensa por defecto no tiene acción: no pasa nada hasta que eliges una. El interruptor Añadir al overlay junto al título de su página lo activa o lo desactiva.

Añade recompensas

En Todo el chat o Cada espectador › Recompensas, elige una recompensa en la Lista de recompensas (o Añadir recompensa), fija sus Mensajes y elige su Acción de Streamer.bot. Probar ejecuta la acción en el momento, con un chatter de Twitch de demostración.

Actualiza tu fuente de navegador

Vuelve a copiar la URL del overlay que ejecuta las acciones en su fuente de navegador → Disposición y fuente de navegador.

Ajustes

Todo el chat y Cada espectador

Las dos tienen las mismas filas.

Variable:

AjustePor defectoDetalle
Contado por el Marcador (todo el chat), Contado por las Tarjetas de espectadores (cada espectador)desactivadoSigue la cuenta de mensajes del chat de ese widget en lugar de contar aquí → Quién cuenta.
Contar desde siempredesactivadoMantiene la cuenta de este widget entre reinicios de Streamer.Bot. Oculto cuando la cuenta viene de otro widget.

Recompensas — su Lista de recompensas, una recompensa a 100 mensajes por defecto. Añadir umbral añade una; cada fila se lee como 100 messages → My action + chat message.

Cada recompensa, en dos partes: Ajustes de la recompensa (Mensajes y Acción de Streamer.bot, uno al lado del otro) y Mensaje en el chat.

CampoDetalle
MensajesLa cuenta que la dispara, desde 1.
Acción de Streamer.botLa acción que se ejecuta, elegida en tu Streamer.Bot. Probar la ejecuta en el momento.
Mensaje en el chatEnviar un mensaje al chat, luego Enviar con el bot y el mensaje. Todo el chat: Publicar en elige las plataformas. Cada espectador: se publica en el chat donde escribió el espectador. Ejemplo que se muestra: GG {user}, {messageCount} messages!

Action arguments

El widget no envía ningún evento propio: cuando una recompensa se dispara, Stream UI ejecuta su acción por su nombre, como hace Run Action, con estos argumentos. Úsalos como %variables% en las subacciones de la acción, por ejemplo un mensaje ¡Gracias %user% por tus %messageCount% mensajes!. En el mensaje de chat de una recompensa, escríbelos entre llaves: {user}, {messageCount}…

ArgumentoEjemploDetalle
userPixelPandaEl nombre visible del chatter.
userLoginpixelpandaSu login.
userId123456789Su ID en la plataforma.
platformtwitchtwitch, youtube o kick.
messageHello chat!Su último mensaje.
messageCount100La cuenta que ha alcanzado la recompensa.
threshold100El número de mensajes de la recompensa.
scopechatchat (todo el chat) o viewer (cada espectador).

El chatter es quien ha alcanzado la recompensa:

  • Todo el chat, contado aquí — el espectador cuyo mensaje la ha alcanzado.
  • Todo el chat, contado por el marcador — el último espectador que ha escrito en la plataforma cuya cuenta ha subido; si no, el último que ha escrito en cualquiera.
  • Cada espectador — ese espectador. Contado por las tarjetas de espectadores, message es su último mensaje desde que se cargó la fuente de navegador, vacío si no ha escrito desde entonces.

Los argumentos del chatter están vacíos cuando nadie ha escrito desde que se cargó la fuente de navegador. messageCount puede superar threshold cuando una cuenta salta por encima (el otro widget sumando varios de golpe). Probar envía un chatter de Twitch de demostración: un nombre al azar, userId demo, message Hello chat!, y messageCount igual a threshold.

Pausa y reanudación

En pausa, no se ejecuta ninguna recompensa ni se envía ningún mensaje. Los mensajes no se cuentan aquí; las cuentas que llevan el marcador o las tarjetas de espectadores siguen, y al reanudar nunca se ejecutan las recompensas que pasaron mientras tanto.

En la pestaña Controles de la página del widget:

  • Controles, la columna de la izquierda, lista Pausar y Reanudar, cada uno con los nombres de sus disparadores. Elige uno para ver sus disparadores en Lista de disparadores, al lado.
  • Lista de disparadores: los disparadores de Streamer.Bot que lo lanzan. Añadir disparador añade uno, con condiciones incluidas → Disparadores y condiciones.
    • Pausar — por defecto: Stream Offline en Twitch.
    • Reanudar — por defecto: Stream Online en Twitch.
  • La zona principal indica Recompensas por actividad: En marcha o En pausa, con los botones Reanudar y Pausar, también en la ventana de controles.

El estado se guarda en Streamer.Bot, en la variable global persistente streamUi.off.chatrewards (1: en pausa; 0 o ausente: activo), así que la pausa dura hasta que lo reanudes, aunque la fuente de navegador se recargue. Tus propias acciones también pueden pausar o reanudar el widget, con una subacción Global (Set) sobre esa variable. Los botones y los disparadores necesitan la acción Stream UI - Backend.

Eventos de Streamer.Bot que escucha

EventoQué provoca
Tus disparadores Pausar / ReanudarPausa o reanuda el widget
Twitch.ChatMessage, YouTube.Message, Kick.ChatMessageUn mensaje — se cuenta y se recuerda como último chatter
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreatedEl widget pausado o reanudado en otro sitio (la página, la ventana de controles, tus acciones); la cuenta de todo el chat del marcador ha cambiado, con Contado por el Marcador
Misc.UserGlobalVariableUpdatedLa cuenta de un espectador en las tarjetas de espectadores ha cambiado. Solo con Contado por las Tarjetas de espectadores

Solo se escuchan las plataformas activadas en la página Ajustes.