🎮Juegos
Los contratos de juegos te permiten implementar un mecanismo de jugar y ganar alrededor de un juego que tú o alguien más haya desplegado.
Aquí tienes una guía paso a paso para crear tu propio juego:
Creando Tu Juego
Ve a la página de Juegos y haz clic en el botón Crear Juego
Completa el formulario que aparece y valida la transacción. Esto creará tu juego. Si planeas utilizar una API para procesar las puntuaciones de tus usuarios, debes establecer la variable de dirección del contrato del juego en la dirección primaria de PaySwap (la dirección que posee el CanCan canal 1).
Selecciona el botón Solo Míos para listar solo tus juegos y así encontrar el juego que acabas de crear más rápido. Si no encuentras tu juego, recarga la página e inténtalo de nuevo.
Configurando Tu Juego
El siguiente paso es actualizar el contrato de tu juego. Haz clic en el botón Panel de Control en el panel de tu contrato de juego y luego en el botón Actualizar Juego. Completa el formulario con el valor apropiado para cada parámetro y valida la transacción.
En el paso siguiente, necesitas actualizar el enlace para jugar el juego para que los usuarios puedan jugar. En el menú del panel de control, haz clic en el botón Actualizar Información y completa el formulario con el valor apropiado para cada campo. Al pasar el cursor sobre el icono de ayuda junto a cada parámetro, puedes leer una descripción del parámetro. Valida el formulario y confirma la transacción.
PaySwap utiliza el enlace de la API del juego para obtener las puntuaciones por ID de token para que los usuarios puedan actualizar sus puntuaciones en la blockchain.
Cómo Jugar
Aquí tienes una guía paso a paso para jugar juegos:
Primero, necesitas comprar suficientes minutos para jugar. Si compras, por ejemplo, 30 minutos, tendrás 30 minutos para obtener y enviar una puntuación desde el sitio del juego. Cualquier puntuación enviada después de eso no será elegible para recompensas del juego.
Para comprar minutos, ve al panel de tu juego y haz clic en el botón Ver Juego para ir a la página del juego. Haz clic en el botón Acuñar nuevo ticket y valida la transacción para acuñar un NFT de juego, que es necesario para jugar tu juego y reclamar recompensas.
Después de acuñar tu NFT de juego, la última línea en la imagen debajo de tu página de juego debería cambiar de "Tienes 0 tickets" a "Tienes 1 ticket(s)" seguido de una lista de tus ID de tickets. Recuerda tu ID de ticket, ya que lo necesitarás para la mayoría de las interacciones con tu juego. Nuestro ID de ticket en la imagen debajo es 2.
Ahora podemos comprar minutos en nuestro juego, compremos 30 minutos. Para hacerlo, haz clic en el botón Jugar para Ganar para ir al formulario en la imagen debajo. Completa el formulario con suficientes tokens para comprar la cantidad de minutos que deseas y valida la transacción.
Hemos introducido nuestro ID de NFT de juego, que es 2, y suficientes tokens para comprar 30 minutos en el juego. El texto Comprar XX Minutos cambia a medida que cambias la cantidad de tokens a enviar.
Ahora debemos jugar el juego, obtener una puntuación y enviar esa puntuación antes de que expiren los 30 minutos, o habremos perdido nuestra inversión. En la parte superior de la página del juego, puedes ver un botón Jugar Juego. Haz clic en él para abrir el juego en una ventana.
Puedes jugar el juego desde el pop-up o hacer clic en el enlace en la parte superior del pop-up para abrir el juego en una nueva ventana.
Una vez que obtengas una puntuación con la que estés satisfecho, como en la imagen debajo, introduce tu ID de NFT de juego y haz clic en el botón de enviar desde la página del juego.
![Enviar Puntuación](../../.gitbook/assets/game12 (1).png)
Como se puede ver en la imagen arriba, una vez que obtuvimos la mejor puntuación que pudimos antes del final de los 30 minutos que compramos, introdujimos nuestro ID de NFT de juego de 2 en el campo correspondiente en la página del juego y lo enviamos. Podemos seguir jugando hasta que los 30 minutos expiren, y si podemos obtener una mejor puntuación, también la enviamos para reemplazar la anterior.
Puedes averiguar cuándo expiran tus minutos introduciendo tu ID de NFT de juego en el formulario debajo en tu página de juego. En nuestro ejemplo debajo, compramos nuestros minutos a las 19:12 (7:12 PM), por lo que nuestros minutos terminarán a las 19:42 (7:42 PM); lo que significa que podemos intentar hasta ese momento obtener una mejor puntuación enviando cada puntuación cada vez para estar seguros.
Después de que nuestros minutos expiren, podemos esperar el momento adecuado para procesar nuestra puntuación o podemos procesarla de inmediato. Los contratos de juego acumulan su bote de premios con tokens recolectados de compras de minutos y calculan las ganancias de los usuarios basándose en su puntuación.
Para nuestro escenario actual, el bote de premios de nuestro juego es de 3 USD, que puedes ver desde la página del juego.
Supongamos que tuviéramos un bote de premios de 1000 USD y que la suma total de puntuaciones obtenidas en el juego por los usuarios es de 8000. Hemos obtenido una puntuación de 800 al jugar nuestro juego, por lo que nuestras ganancias se calcularán de la siguiente manera: 1000 * 800 / 8000 = 100 USD
Si hubiéramos reclamado nuestras ganancias cuando la suma total de puntuaciones obtenidas en el juego era de 5000 y el bote de premios era de 800, por ejemplo, habríamos reclamado: 800 * 800 / 5000 = 128
Así que decidir cuándo reclamar tus ganancias es una decisión estratégica que debes tomar; quieres identificar el momento en que la puntuación total obtenida en el juego no sea demasiado alta pero el bote de premios sea alto. La puntuación total está disponible en la parte superior de la página del juego como en la imagen anterior (en la quinta línea).
Cómo Reclamar Tus Ganancias
Ve a la página de Juegos y encuentra tu juego.
Ve al menú del panel de control de tu juego y haz clic en el botón Procesar Puntuación. No puedes completar el formulario; solo necesitas validar la transacción para escribir la puntuación obtenida previamente en el contrato de juego. PaySwap consultará tu puntuación desde la API del juego y completará el formulario para que puedas validarla.
Deberías poder ver la puntuación total del juego actualizada con tu puntuación. El siguiente paso es hacer clic en el botón Reclamar Recompensas en el menú del panel de control. Valida la transacción para reclamar tus recompensas y transferir tus ganancias a tu billetera. Puedes reclamar tus recompensas de inmediato o esperar un poco para que el bote de premios aumente con más jugadores uniéndose al juego y comprando minutos. Cuanto más grande sea el bote de premios, más podrás ganar, pero esto es un poco complicado ya que si los nuevos jugadores pueden aumentar la puntuación promedio del juego, eso podría reducir tu parte de las ganancias totales. Básicamente, tienes que elegir el momento adecuado para reclamar tus recompensas: ¿reclamarás una parte más grande de un bote más pequeño o una parte más pequeña de un bote más grande?
Cómo Convertir Cada Juego En Un Juego para Ganar
Agrega un formulario en el sitio del juego para permitir a los usuarios actualizar sus puntuaciones. En la imagen de ejemplo debajo, los usuarios pueden ingresar su ID de token de juego y hacer clic en el botón Guardar Puntuación cada vez que tengan una puntuación con la que estén satisfechos y el juego registrará su puntuación (guardada bajo el nombre score), así como el momento del registro de la puntuación (guardado bajo el nombre deadline) y el momento en que el usuario comenzó a jugar el juego (guardado bajo el nombre startime) en la base de datos de Firebase (puedes usar cualquier base de datos que desees). Asegúrate de que tus juegos hagan un seguimiento del momento en que tus usuarios comienzan a jugar sus juegos (startime), ya que este parámetro es extremadamente importante para asegurarse de que los usuarios solo puedan registrar puntuaciones para los minutos de juego que han comprado. Sin él, un usuario puede pasar horas maximizando su puntuación para un cierto juego, luego simplemente comprar 1 minuto desde la página de juegos en PaySwap y usarlo para registrar la puntuación. Con un parámetro startime, podríamos detectar la discrepancia entre los minutos comprados y los minutos reales jugados.
gitbook/assets/Screenshot from 2024-01-24 23-10-20.png" alt="">
Despliega el contrato del juego siguiendo los pasos anteriores y asegúrate de actualizar la información del juego con un enlace de API que devolverá las puntuaciones y plazos de tus usuarios.
Para nuestro juego de Mario, nuestro enlace de API es: https://firestore.googleapis.com/v1/projects/tiktok-a2bdb/databases/(default)/documents/c4/ Esto es lo que actualizaremos en nuestro juego. Para obtener la puntuación y un plazo del ID de token #1, por ejemplo, PaySwap simplemente añadirá el ID de token #1 al enlace de API que hemos registrado, lo que dará esto: https://firestore.googleapis.com/v1/projects/tiktok-a2bdb/databases/(default)/documents/c4/1 PaySwap simplemente está añadiendo el ID de token del usuario a tu enlace de API, así que asegúrate de que tu enlace de API guardado tenga una barra diagonal al final (/). Consultar este punto final devuelve la puntuación y el plazo que ha sido registrado para el ID de token 1 por su propietario en el siguiente formato. Asegúrate de que los parámetros startime y deadline se guarden en segundos y no en milisegundos.
Si tu API sigue el formato anterior y devuelve un objeto con el formato anterior, el sistema no debería tener ningún problema para actualizar la información de puntuación de tus usuarios en la cadena de bloques, lo cual es un paso necesario para que ganen recompensas.
¡Felicidades, tu juego ahora tiene un componente de Juego para Ganar! ¡Tus usuarios ahora pueden:
ver tu juego desde la página de juegos
comprar suficientes minutos en él para hacer sus mejores puntuaciones
actualizar sus puntuaciones en tu base de datos centralizada
utilizar la plataforma PaySwap para informar esa puntuación a la cadena de bloques a través de una API que has proporcionado
reclamar sus ganancias si sus puntuaciones son lo suficientemente altas
Last updated