Enviar un juego externo

Un administrador de juegos sube tu paquete directamente en el maestro de juegos. No hay catálogo de proveedores ni suscripción por cuenta.

Antes de empezar

• Permiso: Juegos (Pages.Gamification.Games), el permiso que protege la subida de paquetes.
• Edición: consulta Juegos externos para ver la disponibilidad.

1. Crea el juego

Ve a Gamificación › Juegos y pulsa Crear Nuevo. Escribe un Nombre, elige External como tipo de juego y guarda. Después abre el juego con Editar.

2. Sube el paquete

En el panel External HTML5 game, usa Upload bundle (.zip) bajo Game bundle. También puedes elegir un runner listo en Ready-made runners o pegar una URL https:// del paquete. Los textos de este panel se muestran en inglés.

Reglas del paquete:

• El zip debe contener un index.html: es el punto de entrada del iframe.
• Extensiones permitidas: .html .htm .js .mjs .css .png .jpg .jpeg .webp .svg .gif .wasm .ogg .mp3 .json .ttf .woff .woff2 .txt.
• Tamaño máximo comprimido: 25 MB por defecto.
• El tamaño descomprimido también tiene un límite y un zip admite como máximo 5.000 entradas.
• Profundidad máxima de ruta: 8 niveles. Las rutas no pueden contener ...
• Cada cuenta tiene una cuota total de almacenamiento para sus paquetes.

Si la validación falla, se rechaza la subida y el juego queda como estaba. Corrige el zip y vuelve a intentarlo. Si todo va bien, el panel muestra la dirección del paquete (/cdn/games/tenant-<id>/…).

3. Define el esquema de señal

En Signal schema (advanced), escribe un esquema JSON con el que debe cumplir la signal de tu paquete. Si lo dejas en blanco, se usa {"score":"number"}.

4. Elige cómo se decide el resultado

Minimum score for prize (skill gate) vale 0 por defecto: la puntuación es informativa y el premio sale de la tabla de probabilidades del juego. Usa un valor mayor que 0 solo con paquetes de confianza y premios de poco valor. Tu paquete tendrá que firmar la puntuación. Consulta el contrato v1, apartado 8.

5. Añade premios y publica

Añade los Premios y sus probabilidades, deja el juego activo y elígelo en una campaña. Los pasos están en Juegos externos.

Actualizar un paquete

Sube un zip nuevo al mismo juego. La dirección del paquete se sustituye y la carpeta antigua se limpia sola pasado aproximadamente un día. Los jugadores que ya tengan abierta la versión anterior pueden terminar su partida.

Errores habituales

Síntoma	Causa probable	Qué hacer
Disallowed file extension	El zip contiene un tipo de archivo fuera de la lista permitida.	Quita o renombra el archivo.
Subida rechazada por tamaño	El zip, su contenido descomprimido o el número de entradas supera el límite.	Comprime los recursos o quita archivos que no uses.
Error de ruta	Una entrada del zip contiene ../, una ruta absoluta o es demasiado profunda.	Genera el zip de nuevo desde la raíz del proyecto.
El juego muestra un error en lugar del iframe	El juego no tiene paquete, o la URL del paquete no es https:// o no está en un dominio autorizado.	Sube el zip otra vez o corrige la URL.
429 al iniciar una partida	El socio ya jugó 10 veces esta hora o tiene una partida en curso.	Espera y vuelve a intentarlo.
400 al completar	La signal no cumple el esquema de señal o supera 16 KB.	Compara tu signal con el esquema.