Tiers

Sistema de progresion con tiers y experiencia.

El sistema de tiers permite crear una progresion permanente para tus usuarios basada en XP (experiencia).

Configuracion

Ve a Tiers en la consola
Define los tiers con:
- Nombre — ej: "Bronce", "Plata", "Oro"
- XP requerido — XP necesario para alcanzar el tier
- Recompensa (opcional) — premio al subir de tier

Como se gana XP

El XP se otorga automaticamente al:

Jugar un juego — configurable por campana
Ganar un juego — configurable por campana
Canjear un codigo
Trackear eventos custom

Progresion

Tier 1: Novato     (0 XP)
Tier 2: Bronce     (100 XP)
Tier 3: Plata      (300 XP)
Tier 4: Oro        (600 XP)
Tier 5: Diamante   (1000 XP)

El XP es permanente — nunca se pierde. A diferencia de los puntos, no se puede gastar.

API

curl "https://southgames.ai/api/sdk/clients/tier?externalUserId=user_123" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

Respuesta:

{
  "success": true,
  "data": {
    "tier": 3,
    "tierName": "Plata",
    "xp": 450,
    "xpForCurrentTier": 300,
    "xpForNextTier": 600,
    "progress": 0.5
  }
}

Webhook

Se dispara client.tier_up cuando un usuario sube de tier.

XP vs Puntos

	XP	Puntos
Permanente	Si	No (se gastan)
Determina tier	Si	No
Se canjea	No	Si
Proposito	Progresion	Economia

Ambos sistemas funcionan en paralelo y se configuran de forma independiente.