La_Syl Studio
Juegos

Janken - Juego de Chat de Twitch

Descargar
Documentación para el juego de Twitch Janken.

Introducción

Descripción

El juego de chat Janken es un juego de piedra, papel o tijera al que los espectadores de tu chat pueden jugar mediante comando o a través de recompensas de puntos de canal.

Una vez lanzado y aceptado el desafío, los jugadores deben elegir un modo de juego para definir el número de puntos necesarios para ganar la partida. El juego viene preconfigurado con 3 modos:

  • Muerte Súbita (el primero en ganar un punto gana)
  • 3 puntos (el primer jugador en llegar a 3 puntos gana)
  • 5 puntos (el primer jugador en llegar a 5 puntos gana)

Una vez iniciada la partida, los jugadores deben enviar un susurro de Twitch a la cuenta bot del streamer con su elección para esa ronda (piedra, papel o tijera).

Durante la partida, el bot enviará mensajes en el chat del directo para notificar a todos del progreso de la partida, ganadores y puntuaciones.

Al final de la partida, se otorgan puntos a cada jugador. Si se ha desbloqueado un logro, el jugador también será notificado directamente en el chat de Twitch.

Actualizaciones Previstas

  • Interfaz de juego para overlay
  • Tabla de clasificación de espectadores
  • Mejoras de diseño gráfico

Instalación y Configuración

Requisitos Previos

Para instalar este juego en tu directo necesitas las siguientes herramientas:

  • Streamer.bot v1.0 o superior
  • OBS Studio
  • Una cuenta bot de Twitch

Importa las acciones en Streamer.bot.

Streamer.bot desactiva los comandos importados por defecto. Reactiva los siguientes comandos:
  • !janken (si quieres iniciar partidas con el comando, si no usa solo la recompensa de puntos de canal)
  • !jankenAchievements para recibir la lista de logros desbloqueados en el chat
  • resetJanken para reiniciar el juego

Inicia el servidor WebSocket

  • Servers > WebSocket Server > Start
¡El widget utiliza la solicitud SendMessage() que requiere autenticación para funcionar! Si no quieres autenticarte, el widget utilizará la acción Send Achievements como alternativa.

Conecta tu cuenta bot a Streamer.bot

La cuenta bot se utiliza para recibir mensajes fuera del chat de Twitch, para evitar que los jugadores sepan lo que ha enviado el otro jugador. También se utiliza para enviar mensajes de notificación durante toda la partida.

Crea una nueva recompensa de puntos de canal de Twitch (opcional)

Si quieres que tus espectadores inicien una nueva partida con recompensas de puntos de canal.

  • Crea tu nueva recompensa con los parámetros que desees.
  • Haz clic en la acción 1.0 Setup - Initiate Game
  • Haz doble clic en el trigger Reward Redemption y elige tu nueva recompensa.

Abre la interfaz de configuración

  • Abre el archivo janken-achievements-editor.html en tu navegador.
  • Haz clic en "Cargar archivo".
  • Navega hasta el archivo JSON incluido en la carpeta del widget y selecciónalo.

Rellena tu información de conexión WebSocket

  • Haz clic en la pestaña Configuración.
  • En ajustes de WebSocket, introduce tu información de conexión WebSocket.
Si has cambiado el nombre del comando, las acciones o el nombre del archivo, debes actualizar esta información en esta página

Personaliza los logros

  • Haz clic en la pestaña Logros
  • Modifica los textos de los logros
  • Añade/Elimina filas como desees.
La columna "threshold" evalúa el valor de la variable global recibida a través de Streamer.bot y activa el logro cuando los valores son iguales. Se incluirán más opciones en una actualización futura.

Personaliza los mensajes

Mensajes de logros

  • Haz clic en la pestaña Mensajes
  • Edita el valor de los mensajes enviados por el widget. Las variables disponibles están listadas para cada campo.

Mensajes del juego Los mensajes del juego son personalizables en las acciones de Streamer.bot. Cada acción tiene carpetas Set Bot Messages que incluyen los argumentos utilizados en la acción para los mensajes. Abre las acciones una tras otra y edita los argumentos en estas carpetas.

Guarda tu nueva configuración

  • Haz clic en "Guardar" en la parte superior de la página.
  • Sobrescribe el archivo de configuración antiguo con el tuyo.

Añade una nueva fuente de navegador a OBS

  • Añade una nueva fuente de navegador a OBS.
  • Introduce la ruta del archivo janken-achievements-widget.html con el protocolo absolute así: http://absolute/C:/tu/ruta/a/janken-achievements-widget.html
  • Las dimensiones no importan: esta fuente no es visible, actúa como backend.
  • Asegúrate de que la fuente permanezca activa durante todo tu directo o no podrá comunicarse con Streamer.bot.
¡Si no introduces la ruta del archivo con el protocolo absolute habrá errores!

Eso es todo. Puedes probar una nueva partida para confirmar que todo funciona como se espera.


Comandos y Controles Disponibles

Todos los controles del juego se realizan mediante comandos enviados en el chat de Twitch excepto los comandos piedra, papel y tijera que se envían por mensaje privado a la cuenta bot conectada en Streamer.bot. Puedes ver aquí la lista completa de comandos configurados.

Estos comandos están accesibles en momentos específicos al lanzar una partida.

ComandoDescripciónDisponibilidad
!janken [username]Desafiar a un espectador a Janken (opcional)Entre partidas
!acceptJankenEl jugador desafiado acepta la partida de JankenDespués de que un espectador haya iniciado una partida
!refuseJankenEl jugador desafiado rechaza la partida de JankenDespués de que un espectador haya iniciado una partida
!modeElección del modo de partida por jugador 1 o 2Después de que un jugador haya aceptado una partida de Janken

Sistema Integrado de Puntuación y Logros

El juego incluye un sistema de puntuación y logros personalizable a través de la interfaz proporcionada en el widget. Encontrarás aquí la información de la configuración predeterminada.

Puntuaciones de los Jugadores

A lo largo de la partida, las puntuaciones se registran para los espectadores en variables globales de usuario. Se rastrean los siguientes puntos:

  • Número de partidas
  • Número de victorias
  • Número de partidas perdidas
  • Número de partidas abandonadas
  • Número de usos de piedra / papel / tijera

Logros Desbloqueables

El juego está preconfigurado con 20 logros desbloqueables para los espectadores según los puntos acumulados durante las partidas. Los logros son, por supuesto, personalizables, ¡puedes añadir y modificar lo que quieras!

LogroMensajeGrupoVariableCondición
Jugó 10 partidasNovato de Janken.Achievement - Janken 10 GamesjankenGamesCuando jankenGames es igual a 10
Jugó 25 partidasHabitual de Janken.Achievement - Janken 25 GamesjankenGamesCuando jankenGames es igual a 25
Jugó 50 partidasJugador Pro de Janken.Achievement - Janken 50 GamesjankenGamesCuando jankenGames es igual a 50
Jugó 100 partidasAdicto al Janken.Achievement - Janken 100 GamesjankenGamesCuando jankenGames es igual a 100

Solución de Problemas

El widget no se conecta

  • Verifica que el servidor WebSocket esté iniciado
  • Si estás usando autenticación, confirma que tu contraseña es correcta en el editor, y que has guardado tu configuración.
  • Confirma que el archivo .json está presente en la carpeta y que su nombre coincide con el del editor.
  • Verifica que la URL se introdujo correctamente en la fuente de navegador de OBS precedida de http://absolute/.

Los logros no se desbloquean

  • Verifica que la fuente de OBS esté activa durante tu directo.
  • Confirma que las variables configuradas son correctas en el editor y que has guardado tu configuración.