La_Syl Studio
Guía de widgets

Primero del chat

Destaca a la primera persona que escribe en el chat de cada directo, en cada plataforma, con su foto y las veces que ha sido la primera.

Premia a quien escribe primero en tu chat. Cada plataforma tiene su propio primero: el primero en Twitch, el primero en YouTube y el primero en Kick tienen cada uno su sitio, con su foto de perfil, su nombre y las veces que han sido los primeros.

Plataformas: Twitch, YouTube, Kick

Paquete de acciones: necesario — Backend guarda los puestos, los contadores y si el widget se muestra, y envía el evento personalizado; Get Profile Pic busca las fotos de Twitch. Mira Quién necesita qué.

Cómo funciona

  • Un primero por plataforma. El evento First Words de Streamer.Bot salta cuando alguien escribe su primer mensaje. El primero de esos mensajes en una plataforma se queda con el puesto de esa plataforma; los siguientes se ignoran hasta que el puesto quede libre.
  • El puesto sigue ocupado hasta un reinicio. Por defecto, cada plataforma libera su puesto cuando empieza tu directo en ella (mira Controles automáticos). Los puestos se guardan en Streamer.Bot: recargar la fuente de navegador no los pierde.
  • Cada primero cuenta. Cada nuevo primero suma 1 a la variable de usuario firstInChat del espectador en Streamer.Bot. Se conserva para siempre y tus propias acciones pueden leerla — un comando !first, por ejemplo.
  • Los puestos siguen el orden de llegada. Quien escribió primero sale primero, luego el siguiente, luego el siguiente — en fila, en columna o en un podio.
  • Solo el overlay que ejecuta las acciones ocupa los puestos, cuenta y envía el evento personalizado. Los demás overlays muestran lo que ha guardado, y un nuevo primero aparece también en ellos. Una URL de un solo widget nunca ocupa un puesto. → Qué overlay ejecuta las acciones
Los usuarios ignorados — tus bots, Nightbot… — y tus propias cuentas de emisor y de bot nunca son los primeros. Los usuarios ignorados se configuran una sola vez para todos los widgets, en la pestaña Usuarios ignorados de la página Ajustes.

La página

La página del widget funciona como una pequeña aplicación:

  • Ajustes, Estilo y Controles, las pestañas encima del editor, cambian lo que muestra.
  • La pestaña Ajustes reúne todos los ajustes en la zona principal, bajo cuatro títulos. En la pestaña Controles, una columna a la izquierda lista los controles — Mostrar, Ocultar y Vaciar —, con la lista de disparadores del elegido al lado, y la zona principal tiene los controles manuales. El evento personalizado solo se explica en esta página.
  • Vista previa del widget, el panel contra el borde derecho de la ventana: la vista previa, los botones de prueba y la URL propia del widget. La flecha de arriba lo pliega en un riel estrecho. Arrastra su borde izquierdo para ensancharlo, hasta la mitad de la ventana; conserva su ancho. Widget muestra el widget en su posición, recortado del lienzo tal como lo dibuja tu fuente de navegador; En el lienzo, todo el lienzo.

Ajustes

Visualización

AjustePor defectoDetalle
Modo podiodesactivadoColoca a los primeros en un podio: el 1.º en el centro en el escalón más alto, el 2.º a la izquierda, el 3.º a la derecha. Solo visual — los puestos del podio no se cuentan. Sin el podio, los primeros van uno al lado del otro o uno debajo del otro: es la Dirección del Contenedor (su Contenido), en la pestaña Estilo.
Quedarse en pantallaactivado (fijo)Activado: los primeros siguen en pantalla hasta que los ocultes. Desactivado: cada nuevo primero se muestra durante el tiempo elegido y luego se va.
Tiempo en pantalla15 sCuánto tiempo se muestra un primero, de 3 a 120 s. Solo con Quedarse en pantalla desactivado.

Con Quedarse en pantalla desactivado y el podio activado, un nuevo primero hace volver todo el podio, con los primeros anteriores en su sitio.

Datos del espectador

AjustePor defectoDetalle
Mostrar la foto de perfilactivadoLa foto del primero. Desactivado, el nombre se queda en su sitio.
Mostrar el nombre de usuarioactivadoSu nombre visible, sobre la parte baja de la foto.

Datos de la plataforma

AjustePor defectoDetalle
Mostrar el icono de plataformaactivadoEl logo de Twitch, YouTube o Kick, junto a la línea de texto.
Mostrar la etiquetaactivadoMuestra la línea bajo el nombre, junto al icono de la plataforma.
Texto de la etiqueta{platform} firstEsa línea. Solo con Mostrar la etiqueta activado.

Puntuación

AjustePor defectoDetalle
Mostrar la puntuaciónactivadoMuestra cuántas veces ha sido el primero.
Texto de la puntuaciónTimes first: {count}Esa línea. Solo con Mostrar la puntuación activado.

Los dos textos pueden usar {platform} (la plataforma en la que fue el primero), {user} (su nombre visible) y {count} (cuántas veces ha sido el primero en esa plataforma, esta incluida).

Un recuadro bajo estos campos da la variable de Streamer.Bot de la puntuación, firstInChat, con un botón Copiar, para mostrarla también en las tarjetas de espectadores — consulta Con las tarjetas de espectadores.

Controles

Lo que muestra, oculta y libera el widget está en la pestaña Controles de su página, cada cosa en una fila de su columna.

Controles automáticos

Tres listas de disparadores de Streamer.Bot, cada una con el nombre de su botón y elegidas como en el resto de Stream UI — mira Disparadores.

ListaPor defectoDetalle
MostrarningunoMuestra el widget en cada overlay — un comando !first, una recompensa de puntos de canal… Con Quedarse en pantalla desactivado, todos los primeros actuales se muestran durante el tiempo elegido.
OcultarningunoOculta el widget en cada overlay hasta que se vuelva a mostrar — un cambio de escena, por ejemplo. La ocultación sobrevive a una recarga de la fuente de navegador.
Vaciarel inicio del directo de cada plataformaLibera los puestos, para que los siguientes primeros mensajes los ocupen.

Los disparadores por defecto de Vaciar:

Disparador por defectoLibera
Twitch › Stream Onlineel puesto de Twitch
YouTube › Broadcast Startedel puesto de YouTube
Kick › Stream Onlineel puesto de Kick

El disparador de una plataforma libera el puesto de esa plataforma. Cualquier otro disparador — un comando, un evento de OBS… — los libera todos. Añade, cambia o quita disparadores con Añadir disparador.

Manual controls

Botones para actuar a mano sobre tu fuente de navegador, al momento — también en la ventana de controles:

BotónQué hace
Mostrar / OcultarUn solo botón, Ocultar mientras se muestra y Mostrar mientras está oculto: muestra u oculta el widget en cada overlay y en la vista previa, con su Transición de entrada y salida, leído en directo: Primero del chat: Visible o Oculto.
Vaciar (uno por plataforma)Libera el puesto de esa plataforma.
Vaciar todoLibera todos los puestos. Solo con más de una plataforma activada.

Necesitan Streamer.Bot conectado y la acción Backend. Un botón Vaciar aparece en gris cuando su puesto ya está libre.

Oculto, el widget sigue ocupando los puestos y contándolos; con Quedarse en pantalla desactivado, ningún primero aparece hasta que se vuelva a mostrar. Una vez que ha salido, su sitio pasa a los demás widgets de su posición.

Si se muestra o no se guarda en Streamer.Bot como streamUi.off.chatfirst.display (1 oculto): tus propias acciones pueden mostrar u ocultar el widget cambiando esa variable global persistente.

Estilo

Cada elemento sigue el estilo del overlay campo por campo: un campo que cambies en la pestaña Estilo pasa a ser del widget, con una flecha de restablecer al lado. Cada plataforma puede tener además su propio aspecto: elígela en Estilo para, junto al interruptor Estilos globales / Personalizado. Mira Apariencia.

ElementoDetalle
ContenedorLa lista: los primeros uno al lado del otro por defecto (su Dirección; el podio la ajusta), alineada con la posición del widget, Full width, 12 px entre tarjetas.
FondoEl recuadro detrás de cada primero: su imagen y sus textos centrados uno debajo del otro. Sigue el estilo Fondo de los widgets del overlay.
ImagenLa foto de perfil del primero. Las fotos de Twitch necesitan la acción Get Profile Pic. Aparece en la lista mientras Mostrar la foto de perfil está activado.
Icono de plataformaEl logo de Twitch, YouTube o Kick, junto a la línea de texto. Sigue el estilo Iconos de plataforma del overlay. Aparece en la lista mientras Mostrar el icono de plataforma está activado.
Nombre de usuarioSobre la parte de abajo de la foto. Sigue el estilo Títulos del overlay. Los nombres largos se cortan con «…». Aparece mientras Mostrar el nombre de usuario está activado.
EtiquetaLa línea bajo el nombre. Aparece mientras Mostrar la etiqueta está activado.
PuntuaciónCuántas veces ha sido el primero. Aparece mientras Mostrar la puntuación está activado.
Escalón del podioSolo en el podio. El escalón bajo cada primero; los del 2.º y el 3.º son más bajos. Su ajuste Altura extra del 1.er puesto se suma al contenido del escalón, así que el 1.er puesto siempre es el más alto (40 px por defecto; en px, en % del lienzo, en em, vw o vh).
PuestoSolo en el podio. «1st», «2nd», «3rd» en los escalones.
Transición de entrada y salidaCómo aparecen y se van los primeros.

Posición por defecto

Posición Abajo a la derecha, tan ancho como la posición, tamaño 100 %. Todo eso se cambia en la pestaña Disposición del Editor de overlays.

Eventos de Streamer.Bot que escucha

EventoQué provoca
Twitch.FirstWordUn primer mensaje en Twitch — ocupa el puesto de Twitch si está libre
YouTube.FirstWordsUn primer mensaje en YouTube — ocupa el puesto de YouTube si está libre
Kick.FirstWordsUn primer mensaje en Kick — ocupa el puesto de Kick si está libre
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreatedEl widget mostrado u ocultado en otro sitio

Además de los disparadores que elijas en Mostrar, Ocultar y Vaciar.

El panel Vista previa del widget tiene un botón de prueba por plataforma — Twitch first words, YouTube first words, Kick first words. Solo se reproducen en la vista previa: no se guarda nada y ningún contador cambia.

Evento personalizado

El widget envía un evento personalizado a Streamer.Bot cada vez que detecta un nuevo primero del chat. Úsalo como disparador de una acción para crear tus propias interacciones: darle las gracias en el chat, reproducir un sonido, regalarle puntos de canal…

En Streamer.Bot, el disparador es Custom › Stream UI › New First in Chat. Lo añade la acción Stream UI - Backend: después de volver a importar las acciones, reinicia Streamer.Bot para que aparezca el disparador.

VariableValorDetalle
user%user%Su nombre visible.
userLogin%userLogin%Su nombre de usuario.
userId%userId%Su identificador en la plataforma.
platform%platform%twitch, youtube o kick.
firstInChatCount%firstInChatCount%Cuántas veces ha sido el primero, esta incluida.

Las fotos de perfil de los espectadores se guardan como profilePic en sus variables de usuario. Cógelas de ahí si las necesitas.

Con las tarjetas de espectadores

El contador firstInChat vive en Streamer.Bot, así que las tarjetas de espectadores pueden mostrarlo y desbloquear logros con él.

  • En las tarjetas: añade una puntuación a la Lista de puntuaciones de una plataforma, activa Gestionar en Streamer.bot y pega firstInChat en Nombre de la variable. La tarjeta muestra el contador tal cual.
  • Para logros e insignias: elige el disparador User Global Variable Updated, escribe firstInChat en su campo Variable de usuario y añade una condición sobre global.newValue — por ejemplo ≥ 10 para una insignia tras diez veces el primero.

Las tarjetas de espectadores leen el espectador y la plataforma de la propia variable: los logros de cada plataforma siguen el contador de esa plataforma.