Sorteos, boletos y premios en puntos

¿Es tu primera vez con la herramienta de sorteos? Empieza con Tu primer sorteo: recorrido con capturas.

Usa un solo anfitrión para realizar el sorteo. El panel, Stream Deck y Event Flow controlan ese anfitrión; las pantallas de audiencia muestran su resultado confirmado.

Realiza tu primer sorteo gratuito

1. En el panel, abre Opciones de sorteo (Giveaway Options). Deja el ID como default, la palabra clave como !enter, y el precio del boleto y el premio en puntos a cero.
2. Elige una tarjeta de ganador, un carrete de nombres o una ruleta comunitaria. Previsualiza la pantalla y copia su enlace en una fuente de navegador de OBS.
3. Selecciona Abrir inscripciones (Open entries). Los espectadores participan enviando la palabra clave en un chat capturado.
4. Selecciona Cerrar inscripciones (Close entries), luego Sortear ganador (Draw winner). El sorteo también cierra las inscripciones si olvidaste hacerlo antes.
5. Selecciona Nueva ronda (New round) para comenzar otro sorteo. Los ganadores anteriores permanecen en el historial del anfitrión.

Mantén el anfitrión SSN en ejecución. No hace falta interactuar con la fuente de navegador de OBS. La ruleta comunitaria independiente sigue disponible sin &managed; los puntos y los controles remotos usan el modo administrado.

Boletos pagados con puntos de SSN

1. Activa el sistema existente de Sistema de puntos de fidelidad (Loyalty Points System) en el panel. Son puntos de SSN, independientes de los puntos de canal de Twitch y de las puntuaciones de cada juego.
2. En Boletos y premios en puntos (Tickets and point prizes), establece los puntos por boleto y un número máximo de boletos por espectador. Un precio de 1 significa un boleto por punto.
3. Abre las inscripciones. Para un sorteo llamado friday, un espectador compra cinco boletos con !ticket friday 5.
4. Consulta los participantes en Gestionar sorteos e historial (Manage giveaways and history). Una compra correcta cobra e inscribe al espectador en una sola operación. Si no tiene saldo suficiente, no se crean boletos.

Comprar boletos reserva puntos inmediatamente, por lo que esos puntos no pueden usarse también para comprar stickers o participar en otro sorteo de pago. El sorteo consume esos puntos. Cancelar y reembolsar (Cancel and refund) devuelve los puntos reservados. Eliminar un participante antes del sorteo devuelve su reserva. Las rondas de pago no pueden descartarse silenciosamente con Nueva ronda.

Las reglas se bloquean tras la primera inscripción. Cerrar y abrir permite pausar una ronda con sus reglas actuales. Para cambiar el precio o los requisitos, cancélala y crea otra ronda. Un espectador no puede cambiar de monedero ni de lado del bote después de participar.

Regalar puntos

Configura Premio en puntos por ganador (Point prize per winner) y Número de premios (Number of prizes) antes de abrir. Cada premio añade esa cantidad de puntos de SSN a la cuenta existente del espectador seleccionado. Esto crea puntos; no los toma de la venta de boletos ni de un monedero del operador. La emisión total está limitada por el importe del premio y el número de ganadores configurados.

Para varios premios, sortea uno por uno. Cada ganador confirmado se registra antes de que la pantalla se anime. Un sorteo completado no se puede cancelar para deshacer un resultado conocido. Corrige los errores mediante un ajuste de puntos deliberado del anfitrión; cambiar una pantalla o reconectar nunca vuelve a conceder el premio.

Juegos con recompensas en puntos

Number Hunt administrado

Elige Number Hunt controlado por el anfitrión, coste del boleto 0, un premio y un premio en puntos opcional. El anfitrión selecciona un número del 1 al 100. Los jugadores usan !guess friday 50, sustituyendo el ID del sorteo. La respuesta correcta premia una sola vez al primer participante elegible que acierta; las respuestas incorrectas reducen el intervalo para todos. Cada espectador puede adivinar una vez cada cinco segundos.

Usa la pantalla administrada de sorteos, o games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Number Hunt normal y otros juegos existentes conservan su comportamiento local original. Sus puntuaciones locales y etiquetas de ganador no conceden puntos de SSN automáticamente.

Bote de cara o cruz (Coin Flip Pot)

Es un juego de azar. Elige Bote de cara o cruz (Coin Flip Pot), precio 1, un resultado y premio adicional 0. Los espectadores apuestan con !ticket friday 3 heads o !ticket friday 3 tails. Ambos lados necesitan un participante. Cierra las inscripciones y sortea: el anfitrión elige cara o cruz con la misma probabilidad, independientemente de los totales apostados.

Los espectadores ganadores recuperan su apuesta y se reparten las apuestas perdedoras de forma proporcional a la suya. Los puntos enteros sobrantes se asignan a las mayores fracciones y los empates se resuelven por orden de inscripción. No se cobra comisión ni se crean puntos adicionales. Para apuestas ganadoras de 2 y 1 frente a 5 puntos perdedores, el bote de 8 puntos paga 5 y 3. Cancela antes del sorteo para reembolsar a todos. Si un lado está vacío, el sorteo se rechaza y puedes cancelar y reembolsar.

Varios sorteos

Asigna a cada sorteo un ID corto con letras, números, guiones o guiones bajos. Las compras de un espectador en todos los ID comparten el mismo saldo disponible. Cada URL de OBS incluye &giveaway=ID. Los comandos de boletos y respuestas indican el sorteo expresamente. Da palabras clave distintas a los sorteos gratuitos simultáneos: una palabra clave ambigua no permite participar por accidente en varios sorteos.

Los campos del panel son valores de configuración. Actualiza o abre el gestor para consultar las reglas confirmadas en el anfitrión. Cambiar un enlace de audiencia solo cambia sus ajustes visuales; no reescribe las reglas de boletos de una ronda en curso.

OBS y presentación

El fondo administrado predeterminado es transparente. Selecciona un panel temático si quieres. La tarjeta, el carrete y la ruleta comunitaria comparten el mismo resultado y seis estilos de color. Las preferencias de movimiento reducido omiten las animaciones de revelación. La ruleta muestra como máximo 120 nombres; es una animación de revelación, no una representación completa de las probabilidades de todos los boletos. La selección usa todos los boletos elegibles.

Al reconectar, la pantalla muestra el resultado guardado. Una pantalla conectada no informa a SSN de si esa escena de OBS es visible en ese momento. Mantén privados los enlaces del controlador, los ID de sesión y los archivos de copia de seguridad.

Event Flow

Añade Sorteo / Boletos (Giveaway / Tickets) en las acciones de puntos. Selecciona Enter free giveaway, Buy tickets, Grant free tickets, Close entries, Draw winner, Cancel and refund o Query state. Selecciona el ID y el número de boletos; elige heads/tails para comprar en un bote. La acción usa la identidad del espectador capturada. Usa un disparador o filtro de confianza antes de concesiones o controles del operador.

Comprar boletos ya gasta los puntos. No pongas Gastar puntos (Spend Points) antes. Un fallo detiene las acciones dependientes sin ocultar el chat original. El resultado está disponible en meta.giveawayControlResult. El panel de prueba de Event Flow simula esta acción sin comprar boletos reales. Usa un anfitrión o perfil aislado para pruebas completas que impliquen cambios reales de ronda.

La posibilidad de comprar se determina con el saldo confirmado cuando se ejecuta la acción. No dependas de que el propio mensaje de inscripción gane el último punto necesario. Los ID nativos de mensajes de la fuente proporcionan protección persistente frente a repeticiones; las fuentes sin ellos tienen garantías de identidad más débiles entre reinicios. Los eventos programados genéricos sin un ID capturado de espectador o mensaje no pueden comprar en nombre de alguien.

Stream Deck y API

El plugin nativo incluye Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round y Giveaway State. Su ID predeterminado es default. Pon {"giveawayId":"friday"} en el campo de valor para seleccionar otra ronda. Abrir también puede aceptar un objeto config ; de lo contrario, una ronda existente conserva sus reglas confirmadas y un ID nuevo usa los valores predeterminados del panel.

Usa la conexión P2P existente o el transporte WebSocket configurado. La tecla informa de una respuesta de SSN; no afirma que OBS esté en directo. Si una respuesta agota el tiempo de espera, consulta el estado antes de intentar otro sorteo.

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

Un ID de operación identifica una operación comercial; el ID de callback identifica una respuesta. Conserva el ID de operación al reintentar. Reutilizarlo con parámetros distintos da error. Usa un ID nuevo para una compra nueva intencionada. El acceso del operador a la API puede gastar en nombre del actor proporcionado: no lo expongas como formulario público de compra sin autenticación.

Historial, copias de seguridad y recuperación

El gestor enumera rondas, participantes e historial de ganadores. Exporta el historial como JSON o guarda una copia completa de puntos y sorteos de versión 2. Las copias completas contienen saldos, reservas, rondas y recibos de operaciones juntos. No se sube nada a un servidor.

Al reiniciar el anfitrión, las rondas abiertas guardadas se cierran para revisión. Sus boletos siguen reservados. Reabre con las mismas reglas, sortea o cancela y reembolsa. Las transacciones de base de datos interrumpidas se confirman por completo o no dejan compras ni pagos parciales. Las reservas de stickers sin confirmación de entrega guardada se recuperan tras vencer su plazo.

La recuperación completa está disponible en un anfitrión nuevo sin saldos ni registros de sorteos existentes. Restablece la instantánea completa y mantiene cerradas las rondas recuperadas. Se niega a sobrescribir un anfitrión que ya tenga datos. Restablece el ID original del directo o de la sesión en el panel antes de reanudar sus rondas; el resultado de recuperación enumera las sesiones de la copia. Esta copia no sustituye tus ajustes generales del panel. Nunca ejecutes el anfitrión antiguo y el recuperado como autoridades independientes de la misma economía. Una copia es una instantánea: no puede incluir transacciones realizadas después de guardarla.

Las importaciones de solo saldos no pueden recuperar reservas pendientes. El reinicio de puntos y la sobrescritura manual se rechazan cuando hay fondos afectados reservados. Reiniciar los puntos no borra recibos ni historial de sorteos. Los saldos pertenecen a este perfil del navegador o de la aplicación, mientras que las rondas se separan por sesión. Los perfiles o dispositivos distintos no se sincronizan automáticamente. Borrar los datos del navegador puede eliminar registros locales, así que guarda copias fuera de ese perfil.

La copia de seguridad o sincronización opcional con un servidor es una función futura, no forma parte de esta versión. Esta implementación no añade subidas, credenciales de servidor, moneda comprada ni retirada de dinero.

Cuando algo no funciona

• No hay inscripción: comprueba el ID y la palabra clave, la restricción de membresía, el estado abierto y la plataforma capturada. Se excluyen inscripciones de bots, privadas, históricas, reproducidas y marcadas como prueba.
• La cuenta ha cambiado: un cambio de nombre o identidad puede volver ambiguo un monedero. Revísalo en el anfitrión; las cuentas nunca se fusionan silenciosamente entre plataformas.
• No hay respuesta: asegúrate de que el anfitrión SSN previsto esté en ejecución y que los controles del anfitrión estén activados. Actualiza el estado confirmado antes de reintentar.
• No se puede reiniciar o importar: liquida o cancela primero las compras reservadas. Usa la recuperación completa para una copia que contenga obligaciones pendientes.
• Recompensa desconocida: !spend requiere una recompensa y un precio configurados coincidentes; ya no consume puntos por un nombre de recompensa arbitrario.

Referencia de la API · Contratos de eventos · Encuestas y listas de espera

Recuperar una copia de seguridad paso a paso

1. Mantén detenido el anfitrión antiguo. Abre SSN en un perfil nuevo del navegador y abre el gestor de sorteos.
2. En Recuperar en un anfitrión nuevo, elige tu copia de seguridad completa. Espera el mensaje de recuperación y anota el ID de sesión original que indica.
3. En la sección del panel Opciones de sesión (Session Options), introduce ese ID de sesión original.
4. Vuelve al gestor, elige el ID del sorteo y selecciona Actualizar (Refresh). Revisa sus reglas, participantes e historial de ganadores. Las rondas recuperadas que estaban abiertas se cierran para revisión.
5. Reabre con las mismas reglas, sortea o selecciona Cancelar y reembolsar (Cancel and refund) para devolver los boletos reservados. Guarda una copia nueva después de revisar el resultado.

Para OBS, empieza con una fuente de navegador de 1280 × 720. La ruleta administrada se adapta al alto restante de la fuente. El fondo predeterminado es transparente sin CSS personalizado; todos los controles habituales permanecen en el panel, el gestor o Stream Deck.