🔑 Token de acceso único

El Token de acceso único es un código alfanumérico de un solo uso que permite al Game Master monetizar sus Aventuras. El GM genera códigos individuales desde el Gamifier, los vende por el canal que prefiera (su web, email, en persona) y cada Player usa su código para desbloquear la Aventura. Una vez canjeado, el código queda vinculado a ese Player y no puede ser reutilizado por nadie más.

👑 Quién necesita leer esto

Game Master — esta página te explica cómo generar y gestionar Tokens de acceso único para tus Aventuras. Si eres Player, lo único que necesitas saber es que tu Game Master te proporcionará un código que deberás introducir para entrar a jugar.

Cómo funciona — las dos llaves

Para acceder a una Aventura protegida con Tokens de acceso único, el Player necesita dos llaves:

Llave	Qué hace	Cuándo se usa	¿Se consume?
GamePIN o enlace directo	Vincula la Aventura a la cuenta del Player	Al descubrir la Aventura	No — la vinculación es gratuita
Token de acceso único	Desbloquea la Aventura para poder jugarla	Al intentar entrar por primera vez	Sí — un solo uso, se invalida tras canjearlo

Sin la primera llave, el Player no ve la Aventura en su listado. Sin la segunda, la ve pero no puede entrar — le aparece una pantalla de bloqueo pidiéndole el código.

Vincular ≠ Acceder

Vincular una Aventura (con el GamePIN o enlace directo) simplemente la añade al listado del Player. Es gratis y está documentada en Acceder a una Aventura. Acceder (con el Token de acceso único) es lo que desbloquea el juego. Son dos pasos distintos.

Generar códigos de acceso único 👑

Activar los Tokens en la Aventura

1. En el Gamifier, abre el editor de la Aventura.
2. Localiza la sección "Tokens de acceso por player" (debajo de la sección "Bloqueo por código de acceso").
3. Activa el toggle. Aparece el texto: "Cada jugador necesita un token único para acceder a la Aventura."
4. Guarda la Aventura.

Al activar los Tokens de acceso, se despliega un panel con los botones "Generar Tokens" y "Actualizar", y la tabla de Tokens generados (inicialmente vacía).

Tokens y código de acceso son mutuamente excluyentes

No se pueden tener activados a la vez el "Bloqueo por código de acceso" (código compartido) y los "Tokens de acceso por player" (códigos individuales). Al activar uno, el otro se desactiva automáticamente.

Generar los códigos

1. Pulsa "Generar Tokens".
2. En el diálogo que aparece, indica cuántos Tokens quieres generar. El sistema muestra el máximo disponible según tu saldo de Tokens (ej. "máx. 450").
3. Pulsa "Generar Tokens" para confirmar.
4. Los códigos aparecen en la tabla inferior, listos para distribuir.

Cada Token generado es una cadena alfanumérica de 9 caracteres en mayúsculas, única por Aventura. El sistema genera los códigos automáticamente — no se pueden elegir manualmente.

Límite de generación según tu saldo

El número máximo de códigos que puedes generar está limitado por tu saldo de Tokens de precompra (los mismos que compras a 1 € en la tienda de Tokens). Generar códigos no consume tu saldo — solo establece el tope. El consumo real del Token ocurre cuando el Player accede a la Aventura por primera vez, siguiendo el flujo estándar.

La tabla de Tokens

Una vez generados, los Tokens aparecen en una tabla con las siguientes columnas:

Columna	Descripción
Token	El código alfanumérico de 9 caracteres.
Estado	Activo o Inactivo. Solo los Tokens activos pueden ser canjeados por un Player.
E-Mail	Email asignado al Token (opcional). Si se rellena, solo el Player con ese email podrá usarlo.
Nickname	Nickname del Player que canjeó el Token (vacío si aún no se ha usado).
Fecha Creación	Cuándo se generó el Token.
Fecha Unión	Cuándo el Player canjeó el Token (vacío si aún no se ha usado).

La tabla incluye filtros por columna y paginación. El botón "Actualizar" refresca los datos para ver en tiempo real quién acaba de canjear su Token.

Editar un Token

Desde la columna de acciones de la tabla, puedes editar un Token individual para:

• Cambiar su valor — reemplazar el código por otro distinto.
• Asignar un email — vincular el Token a un email concreto. Solo el Player cuyo email coincida podrá canjearlo (la comparación no distingue mayúsculas).
• Desactivar el Token — cambiar su estado a Inactivo sin borrarlo. El Player no podrá usarlo mientras esté inactivo.

Eliminar Tokens

Puedes eliminar Tokens de dos formas: individualmente con el icono de papelera en cada fila, o en lote seleccionando varias filas con los checkboxes y pulsando "Eliminar seleccionados".

Qué ve el Player 🎮

Aventura visible pero bloqueada

Cuando el Player vincula una Aventura protegida con Tokens (usando el GamePIN o enlace directo), la Aventura aparece en su listado con normalidad. Sin embargo, al pulsar para entrar, se le muestra una pantalla de bloqueo con el título "Introduce tu Token de acceso" y un campo de texto.

Canjear el Token

1. El Player introduce el código de 9 caracteres que le proporcionó el Game Master.
2. Pulsa validar.
3. Si el Token es válido y no ha sido usado, el Player accede directamente a la Aventura y el Token queda vinculado a su cuenta de forma permanente.
4. En futuras visitas, el Player entra directamente sin necesidad de volver a introducir el código.

Errores posibles

Si el Token no es válido, el sistema muestra un mensaje claro según el caso:

Situación	Mensaje
Token no existe o está mal escrito	"Token inválido o no encontrado."
Token ya canjeado por otro Player	"Este Token ya ha sido utilizado por otro jugador."
Email no coincide con el asignado	"El email asignado al Token no coincide con el del jugador."

El modelo de monetización 💰

El Token de acceso único es la herramienta que permite al Game Master vender acceso a sus Aventuras. El flujo económico es sencillo:

1. Compra: el GM adquiere Tokens estándar en la tienda de AdventuriQ a 1 € por Token.
2. Genera: desde el Gamifier, genera códigos de acceso único para la Aventura. La cantidad de códigos está limitada por su saldo de Tokens, pero generarlos no consume el saldo.
3. Vende: distribuye los códigos a sus clientes/alumnos/participantes por el canal que prefiera (web propia, email, marketplace, en persona) al precio que decida.
4. El Player canjea: cada comprador introduce su código y desbloquea la Aventura. En ese momento se consume 1 Token del saldo del GM (flujo estándar de consumo).

El margen de beneficio lo fija el GM. El coste unitario del Token es siempre 1 € (se consume cuando el Player accede); el precio de venta del código lo decide el GM según el mercado y la propuesta de valor de la Aventura.

👑 Para el Game Master

El Token de acceso único es especialmente útil para formadores que venden cursos gamificados, organizadores de rutas turísticas, creadores de gymkanas con inscripción de pago, o cualquier escenario donde cada participante paga individualmente por su acceso.

Relación con Tokens estándar

El Token de acceso único y el Token estándar son dos usos del mismo recurso económico (el saldo de Tokens del GM), pero funcionan de forma diferente:

Aspecto	Token estándar (sin código de acceso)	Token de acceso único
Cuándo se consume el Token	Cuando el Player accede a la Aventura	Cuando el Player accede a la Aventura (igual)
Quién gestiona el acceso	Acceso directo — el Player entra sin barrera	El GM genera un código y controla quién puede entrar
Formato	Automático, transparente	Código alfanumérico de 9 caracteres que el Player introduce
Monetización	No directa	Sí — el GM vende los códigos al precio que decida
Pantalla de bloqueo	No	Sí — el Player debe introducir el código antes de acceder

En ambos casos, el consumo del Token ocurre en el mismo momento: cuando el Player accede a la Aventura por primera vez. La diferencia es que el Token de acceso único añade una barrera de entrada (el código) que el GM puede vender, controlando así quién accede y monetizando la experiencia.

Notas importantes

• Los Tokens no caducan. Una vez generados, los códigos son válidos indefinidamente hasta que alguien los canjee o el GM los elimine.
• Formato del código: 9 caracteres alfanuméricos en mayúsculas, sin espacios ni caracteres especiales. Únicos por Aventura.
• Email opcional pero recomendable. Si asignas un email a un Token, te aseguras de que solo esa persona pueda usarlo. Si no, el primero que lo teclee se lo queda.
• Aventuras existentes no se ven afectadas. Activar Tokens en una Aventura que ya tiene Players no bloquea a los Players que ya están jugando — solo afecta a nuevos accesos.

Continúa aprendiendo

• Modelo económico general: Tokens y Licencias.
• Cómo vincula el Player una Aventura (llave 1): Acceder a una Aventura.
• Configuración general de la Aventura: Configuración.