Conexión con Streamer.Bot
Stream UI habla con Streamer.Bot a través de su servidor WebSocket. La mayoría de los widgets no necesitan nada más. Algunas funciones necesitan además cuatro pequeñas acciones C#, el paquete de acciones, que se importan de una vez.
La página Ajustes tiene cuatro pestañas: Streamer.bot (las acciones, la conexión, las plataformas y las integraciones, abierta por defecto), Usuarios ignorados, Copia de seguridad y Licencia.
La pestaña Streamer.bot
1. Importar las acciones
Cadena de importación de las acciones de Streamer.bot, arriba de la tarjeta del servidor WebSocket:
Copiar la cadena
Haz clic en Copiar la cadena de importación.
Importarla
En Streamer.Bot, haz clic en Import arriba, pega la cadena en Import String y haz clic en Import.
Reiniciar Streamer.Bot
Reinícialo antes de conectarlo al sitio.
Una vez conectado, la fila Acciones de Estado del sistema indica si están todas. Tras una actualización de Stream UI, vuelve a importar la cadena: una función añadida desde entonces puede necesitarla.
2. Arrancar el servidor WebSocket
En Streamer.Bot, ve a Servers/Clients → WebSocket Server:
| Ajuste | Valor |
|---|---|
| Dirección | 127.0.0.1 |
| Puerto | 8080 |
| Endpoint | / |
Marca Auto Start y haz clic en Start Server.
3. Conectarte
Copia los mismos valores en la tarjeta Servidor WebSocket de Streamer.bot:
| Campo | Por defecto | Detalle |
|---|---|---|
| Dirección | 127.0.0.1 | |
| Puerto | 8080 | De 1 a 65535. |
| Endpoint | / | |
| Contraseña | vacío | Opcional — necesario para enviar mensajes al chat del stream. |
Haz clic en Conectar. Activa Conectarme automáticamente al abrir este sitio si no quieres pulsarlo cada vez.
Estado del sistema
Junto al formulario, Estado del sistema muestra lo que el sitio ha encontrado en tu Streamer.Bot:
| Fila | Qué comprueba |
|---|---|
| Servidor WebSocket | Si el sitio está conectado, y el motivo que da el navegador si no. |
| Autenticación | Si tu contraseña se aceptó, falta o se rechazó. |
| Disparadores | Cuántos disparadores ofrece tu Streamer.Bot, y los que le faltan a esta versión. |
| Acciones | Si existen las cuatro acciones importadas — ver más abajo. |
| Cuentas del streamer | En qué plataformas tiene sesión iniciada Streamer.Bot. |
Si no conecta, el mensaje dice por qué: Streamer.Bot no está abierto o su servidor no está arrancado, se pide una contraseña o es incorrecta, no hay respuesta a tiempo, o responde en ese puerto algo que no es Streamer.Bot.
Plataformas e integraciones
Las Plataformas — Twitch, YouTube y Kick — están todas activadas por defecto. Cada fila muestra la cuenta con la que Streamer.Bot tiene sesión iniciada. Desactiva una plataforma para ignorar sus eventos en todos los widgets y ocultar sus secciones y sus disparadores en el sitio.
Las Integraciones de Streamer.bot son los servicios conectados a Streamer.Bot. Todas están desactivadas por defecto; activa las que uses:
Crowd Control · DonorDrive · Fourthwall · HypeRate · Ko-fi · Pally.gg · Patreon · Pulsoid · Shopify · Speaker.bot · StreamElements · Streamer.bot Remote · Streamlabs · Streamloots · Throne · T.I.T.S. · TipeeeStream · TreatStream · Voicemod · VTube Studio
Activar una la añade allí donde sirve: su propia sección en Alertas y en Objetivos y subathon, sus botones de prueba, y su propio botón en Estilo para en la pestaña Estilo de las alertas. Streamer.Bot no indica si una integración está configurada, así que estas filas no llevan insignia de estado.
Una integración cuyos eventos provoca una persona (una donación, un pedido…) se despliega
con la flecha a la izquierda de su icono: un campo por disparador, el campo del evento que
lleva el nombre de la persona — from en Ko-fi, por ejemplo. Las tarjetas de
espectadores acreditan al espectador con ese nombre.
Cada campo muestra el que documenta Streamer.Bot hasta que escribas otro; si lo dejas
vacío, vuelve a él.
Las cuatro acciones
Lo que hace cada acción importada. Ninguna necesita disparador: el sitio las llama por su nombre.
Stream UI - Broadcast
Permite que el sitio envíe comandos (iniciar un subathon, probar una alerta, lanzar los
créditos…) a tu overlay. Llegan como un evento General.Custom.
Stream UI - Backend
Guarda lo que tiene que sobrevivir a un reinicio en las variables globales de Streamer.Bot
— el progreso de los objetivos y del subathon (streamUi.goals.<id del objetivo>,
streamUi.subathon), los puestos del Primero del chat, los contadores
(streamUi.counter.<nombre>), los espectadores, la cuenta de las Recompensas por actividad
del chat, la pausa del relé de chat y la de Encuestas y predicciones, los webhooks de
Discord — y permite al sitio cambiarlos
mientras estás en directo. También escribe las variables de usuario de los espectadores
(firstInChat, lastSeen, chatMessages), consigue los clips y la información de canal
de Twitch para Shoutout y el Reproductor de clips, comprueba en qué grupos de usuarios está
un espectador, llena, lee y vacía los grupos de los Créditos finales, envía los shoutouts
de Twitch, publica las alertas, los mensajes y las imágenes en
Discord, lee las fotos de Twitch de tus cuentas de emisor y de bot (para la pestaña Usuarios ignorados y las vistas previas) y abre los selectores de archivo y de carpeta de Windows para
los sonidos y las carpetas de capturas. Para el marcador
y las tarjetas de espectadores, guarda las
puntuaciones (ss.<plataforma>.<estadística>.*) y las estadísticas de los espectadores,
añade a los espectadores a los grupos de los logros y guarda las capturas de las tarjetas.
Añade los disparadores New First in Chat, New Stream High Score y New Achievement
Unlocked (Custom › Stream UI) para tus propias acciones.
Stream UI - Sounds
Reproduce los archivos de sonido de tus alertas, objetivos, saludos y encuestas desde este PC — un archivo, o un archivo al azar de una carpeta — con el reproductor de Streamer.Bot, en la salida de audio por defecto de Streamer.Bot (el C# no puede elegir otra). Los sonidos configurados como Enlace no la necesitan: los reproduce la fuente de navegador.
Stream UI - Get Profile Pic
Busca las fotos de perfil de Twitch para las Alertas, el Primero del chat y el Saludo a los chatters. YouTube y Kick envían la suya con el evento; Twitch no.
Quién necesita qué
| Funciona sin el paquete | Necesita el paquete | |
|---|---|---|
| Chat | ✅ el chat | Backend para la pausa del relé de chat y Mostrar / Ocultar, Broadcast para sus otros controles manuales |
| Encuestas y predicciones | ✅ encuestas y predicciones, sonidos por enlace | Sonidos para los archivos de sonido, Backend para la pausa |
| Lluvia de emotes y gifs | ✅ la lluvia | Backend para Mostrar / Ocultar, Broadcast para su botón Vaciar la lluvia |
| Saludo a los chatters | los saludos se muestran | Get Profile Pic para las fotos de Twitch, Sonidos para los archivos de sonido, Backend para los saludos de grupos y «De vuelta tras» y para la pausa |
| Recompensas por actividad | con Contado por el Marcador o Contado por las Tarjetas de espectadores | Backend cuando el widget cuenta los mensajes por sí mismo, y para la pausa |
| Marcador | — | Backend para guardar las puntuaciones, y para los controles manuales |
| Tarjetas de espectadores | — | Backend para las estadísticas de los espectadores, los logros y las capturas, Get Profile Pic para las fotos de Twitch, Broadcast para los botones Mostrar y Ocultar |
| Alertas | las alertas se muestran, sonidos por enlace | Get Profile Pic para las fotos de Twitch, Sonidos para los archivos de sonido, Broadcast para los controles manuales, Backend para los webhooks de Discord y la pausa |
| Primero del chat | los primeros se muestran, pero los contadores se quedan en 1 y nada sobrevive a una recarga | Backend para guardar los puestos y los contadores, enviar el evento personalizado y para Mostrar / Ocultar, Get Profile Pic para las fotos de Twitch |
| Objetivos y subathon | objetivos y subathon funcionan, sonidos por enlace | Backend para conservar el progreso entre reinicios, editar los contadores en directo y para Mostrar / Ocultar, Sonidos para los archivos de sonido, Broadcast para los botones del subathon |
| Shoutout | — | Backend para los clips, la foto, la comprobación del grupo y el shoutout de Twitch, Broadcast para los controles manuales |
| Reproductor de clips | — | Backend para los clips, Broadcast para los controles manuales |
| Contadores de stream | — | Backend para crear, subir, reiniciar, mostrar y ocultar los contadores, y para los controles manuales |
| Contador de espectadores | — | Backend para guardar y reiniciar los contadores, y para Mostrar / Ocultar |
| Cuenta atrás | las cuentas atrás se muestran y se ocultan | Get Profile Pic para las fotos de Twitch, Broadcast para los controles manuales |
| Créditos finales | — | Backend para llenar, leer y vaciar los grupos, Broadcast para los controles manuales |
| Webhooks de Discord | — | Backend para guardar los webhooks y publicar los mensajes y las imágenes, Get Profile Pic para las fotos de Twitch con Publicar en nombre del espectador |
Los controles manuales son los botones de la pestaña Controles de cada página de widget, también reunidos en la ventana de controles.
La pestaña Usuarios ignorados
Las personas cuyos mensajes nunca aparecen en el Chat ni en la Lluvia de emotes y gifs, que el relé de chat nunca reenvía, que el Saludo a los chatters nunca saluda, que el Contador de espectadores nunca cuenta como chatters únicos, que nunca son los primeros del chat, que las Recompensas por actividad nunca cuentan ni premian y que nunca entran en los Créditos finales — tus bots, una cuenta secundaria. Vale para todos los widgets a la vez.
- Ignorar cuentas conectadas — List of accounts connected in Streamer.bot. Toggle to add to the ignored user list. Una línea por plataforma activada, el Streamer a la izquierda y el Bot a la derecha, cada uno con su foto. Activa una cuenta para ignorarla; si cambia de nombre, la lista lo sigue.
- Usuarios ignorados — Estos usuarios quedan excluidos en este sitio. Escribe cualquier nombre en Usuario a ignorar y pulsa Añadir. Los nombres se comparan sin distinguir mayúsculas. La lista empieza vacía: añade tú mismo tus bots (Nightbot, StreamElements…).
La pestaña Copia de seguridad
Tus ajustes solo viven en este navegador. Usa la pestaña Copia de seguridad:
| Botón | Qué hace |
|---|---|
| Exportar los ajustes | Descarga stream-ui-settings-<fecha>.json: conexión, plataformas, usuarios ignorados, estilos, todos los overlays (y cuál ejecuta las acciones), todos los widgets, activados o no, y las imágenes que subiste. La contraseña no se incluye. |
| Importar ajustes | Lee un archivo exportado desde Stream UI. Se conserva la contraseña que hayas introducido. También lee una copia de la antigua web de Stream Scores: sus estadísticas, tarjetas, logros, disparadores y los estilos de la primera vista de marcador y de la primera de tarjetas pasan al marcador y a las tarjetas de espectadores, activados; el resto de tus ajustes no cambia. |
| Restablecerlo todo | Tras una confirmación, devuelve conexión, widgets y estilos a sus valores por defecto, con un solo overlay, Main overlay. |
Las licencias se guardan aparte: exportar, importar y restablecer nunca las tocan, y una copia nunca lleva una clave.
La pestaña Licencia
Dos licencias, una al lado de la otra, cada una con su clave:
- Licencia sin anuncios — 1 mes, 6 meses o 1 año. Una vez aceptada la clave, los anuncios desaparecen del sitio en este navegador. De todos modos, nunca aparecen en tu overlay. Es el mismo panel que el recuadro Apoya este proyecto de la página de inicio de Stream UI.
- Stream Scores Licence — 4,99 € al mes o 99,99 € una vez, sin IVA. Más de un overlay para el marcador y las tarjetas de espectadores, todas las estadísticas del marcador activadas (5 por plataforma sin ella), todas las estadísticas y todos los logros en las tarjetas (5 estadísticas por plataforma y 5 logros por lista sin ella), y tampoco anuncios. Las claves compradas para la antigua web de Stream Scores funcionan aquí. Mientras está activa, la URL del overlay lleva la clave, y la fuente de navegador la comprueba por sí misma: vuelve a copiar la URL después de introducirla.
Introduce una clave en su tarjeta, o elige un plan para comprar una. Comprobar ahora vuelve a preguntar a Lemon Squeezy; Desactivar libera la activación de este navegador, para usar la clave en otro sitio.
Controlar los widgets desde tus propias acciones
Cualquier acción de Streamer.Bot puede mandar un comando a un widget: añade una subacción Execute C# Code que difunda JSON.
CPH.WebsocketBroadcastJson("{\"event\":\"rollCredits\",\"scrollTime\":60}");
Para esto no hace falta ninguna acción del paquete. Los widgets que aceptan comandos los listan en la pestaña Controles de su página, con una línea lista para copiar, o en su página de documentación (Tarjetas de espectadores).
| Widget | event | Campos |
|---|---|---|
| Alertas | customAlert | title, text, alertImageUrl, platform — o usa la acción Stream UI - Send Custom Alert |
| Tarjetas de espectadores | viewerCardsShow | display, user, userId, platform — todos opcionales; el código está en su página |
| Tarjetas de espectadores | viewerCardsHide | — |
| Créditos | rollCredits | scrollTime (s), demo |
| Créditos | stopCredits | — |
| Créditos | clearCredits | platform (sin él = todas) |
| Subathon | subathonStart | startTime (h), maxTime (h) — ambos opcionales |
| Subathon | subathonPause / subathonResume / subathonStop | — |
| Subathon | subathonAddTime | seconds, username, trigger |
Los objetivos no tienen comando: su contador y su meta se cambian en la página de
Objetivos y subathon, mediante Stream UI - Backend.
Los Contadores de stream y el
Contador de espectadores tampoco tienen: tus acciones
cambian directamente sus variables globales persistentes — el valor de un contador, o si
está oculto — y el overlay las sigue. Lo mismo para mostrar y ocultar el
Chat, el Primero del chat, los Objetivos y
subathon, el Contador de espectadores y el
Marcador: streamUi.off.<widget>.display (chat, chatfirst,
goals, viewers, scoreboard) a 1 oculta el widget en cada overlay, a 0 lo muestra.
Primeros pasos
Colección de widgets de overlay para Streamer.Bot — chat, saludos, recompensas por actividad del chat, marcador y tarjetas de espectadores, shoutouts y clips, alertas, objetivos, subathon, contadores, encuestas, cuentas atrás, créditos, lluvia de emotes y gifs, y capturas de pantalla y mensajes publicados en Discord.
Disparadores y condiciones
Cómo reaccionan Alertas, Objetivos y subathon, Contadores de stream, Créditos finales y los disparadores de reinicio a los disparadores de Streamer.Bot que eliges, con condiciones, variables de texto, un mensaje de chat, un sonido y un mensaje de Discord.

