BattlePass y misiones: guía de setup

Qué es el BattlePass#

El BattlePass es una temporada de premios: los jugadores ganan XP, suben de nivel y desbloquean recompensas; las misiones son la forma más simple de darles XP.

Pensalo como cinco piezas que se conectan:

En una frase: el jugador completa misiones, las misiones le dan XP, el XP sube niveles y cada nivel entrega rewards.

XP y niveles#

El XP no se gana solo por jugar: llega siempre como una reward de una misión, un reto o un nivel, o a mano con un comando de admin.

Cuánto cuesta cada nivel

El primer nivel cuesta 10 000 XP y cada nivel siguiente suma 2 500 más.

Qué pasa al subir

• El nivel queda marcado como "sin reclamar". Los premios no se entregan solos.
• El jugador abre /battlepass, toca el nivel y ahí cobra la reward gratis y, si tiene el premium, también la premium.
• Si subió varios niveles de golpe, quedan todos pendientes y los cobra uno por uno.

Multiplicadores y boosts

• Hay un multiplicador general de XP (1.0 por defecto, o sea sin cambio).
• Un boost de XP multiplica lo que gana el jugador durante un tiempo. De fábrica existen xp-x1_5-30m, xp-x2-1h, xp-x2-3h y xp-x3-1h.
• Los boosts se crean con /xpboost create <nombre> <categoría> <multiplicador> <duración>.

Categorías de nivel

Cada pase tiene su propia categoría con el mismo nombre del pase, y siempre existe una global. La XP que cae en otra categoría también se suma al pase activo del jugador.

Crear y editar un BattlePass#

Un pase se crea en dos pasos: primero se arma, después se inicia. Mientras no lo iniciás, los jugadores no lo ven.

Crearlo

1. Ejecutá /battlepass create <nombre>. Necesitás el permiso apple.command.battlepass.
2. Se abre el editor con un pase vacío de 100 niveles.
3. Usá los botones del editor (tabla de abajo) para dejarlo como querés.
4. Cuando esté listo, tocá Start Season.

También se puede entrar por /apple setup, menú BattlePass System.

Los botones del editor

Se abre con /battlepass edit <nombre>.

Qué pasa al iniciar

• Solo hay una temporada activa a la vez. Si iniciás otra, la anterior termina.
• Los jugadores reciben el pase la próxima vez que entran al servidor.
• La fecha de fin es la de inicio más la duración.

Terminar una temporada

En /apple setup → BattlePass System → End Current Season, con confirmación. Terminar un pase no borra el nivel ni el XP de los jugadores.

Otros comandos útiles

Rewards#

Una reward es cualquier cosa que el servidor le entrega al jugador. Se usan en dos lugares: en los niveles del pase y en las misiones.

Tipos de reward

El tipo Cosmetic existe en el sistema pero todavía no hace nada. No lo uses.

Poner premios en un nivel

1. En el editor del pase, tocá Reward Configuration.
2. Elegí el nivel. Los cofres tienen premios, las esmeraldas están vacías.
3. Elegí la fila: hierro es gratis, diamante es premium.
4. Elegí el tipo de reward.
5. Respondé en el chat lo que te pide (cantidad, comando, etc.).

Para cambiar o quitar un premio, abrí el nivel: clic en el papel lo edita y Shift + clic lo borra. El botón "Get all rewards" te da todo lo del nivel para probar.

Gratis y premium

• La reward gratis la cobra siempre el jugador.
• La premium solo la cobra quien compró el pase con /battlepass premium.
• Si compra el premium después de subir de nivel, recibe también los premios premium de los niveles que ya había cobrado.

Rewards de misiones

Las misiones dan todas sus rewards juntas al completarse. En las misiones no hay fila gratis o premium: se entrega todo.

Misiones#

Una misión es una tarea con objetivo ("matá 10 jugadores") que al completarse da rewards. Es la forma principal de que los jugadores ganen XP del pase.

Las partes de una misión

La forma rápida: un solo comando

/quest create <nombre> <objetivo> <cantidad> [servidor] [repetición] [xp]

Ejemplo: /quest create matar-10 kills 10 kitmap daily 500. Crea una misión de matar 10 jugadores, solo en Kitmap, que se renueva a diario y da 500 XP de pase. Queda activada.

Qué significa la cantidad en cada objetivo

La forma completa: el editor

1. Ejecutá /quest create <nombre> o usá Missions en el editor del pase.
2. Se abre el editor de la misión. Una misión nueva nace desactivada.
3. Configurá los botones que necesites (tabla de abajo).
4. Tocá Activate Quest para que los jugadores la vean.

Cuánto tarda en renovarse

• Diaria: 1 día. Semanal: 7 días. Mensual: 30 días.
• Una vez: no se repite.
• Si ponés un Reset Time, ese valor manda sobre el tipo.
• El tiempo corre desde que el jugador la completa.

Cómo la usa el jugador

1. Abre /quests o el botón Missions del pase.
2. Hace clic en la misión para aceptarla. Puede tener hasta 10 activas.
3. Juega. El progreso se suma solo.
4. Al completarla recibe todas las rewards. Si se renueva, vuelve a estar disponible después del tiempo configurado.

Para abandonar una misión activa, hace clic de nuevo sobre ella y confirma.

Cosas para tener en cuenta

• Cuando un jugador acepta una misión recibe una copia. Si después editás la misión, los que ya la aceptaron siguen con la versión vieja.
• Una misión de kitmap también cuenta en los servidores de tipo UHCF_KITMAP.
• Racha diaria: quien completa todas las misiones diarias durante casi todo el mes recibe 40 Battle Points al cierre del mes.

Comandos de admin

Permiso: apple.command.quest.admin.

El <id> puede ser el id o el nombre de la misión.

Retos y contenido de fábrica#

Retos (challenges)

Un reto es parecido a una misión pero más largo: combina varios objetivos, por ejemplo ganar partidas y matar jugadores. Se manejan por comando.

El permiso de admin es apple.command.challenge.admin. En el editor del reto se puede elegir el tipo, el servidor y el tiempo de renovación.

Lo que trae el servidor de fábrica

A los 15 segundos de arrancar, el plugin crea su contenido base. Se hace por nombre, así que reiniciar no duplica nada.

Las misiones de fábrica usan los modos UHC, Meetup y Arena, o cualquiera, con objetivos de matar y ganar. Si querés misiones para Kitmap, creá las tuyas con /quest create.

Setup completo, paso a paso#

Seguilo en orden y tildá cada paso. Con esto una temporada queda lista para jugadores.

1. Antes de empezar

• Tenés los permisos apple.command.battlepass y apple.command.quest.admin.
• Sabés en qué modo va (Kitmap, Practice, UHC...): las misiones se filtran por modo.

2. Armar el pase

• /battlepass create <nombre> y esperar a que abra el editor.
• Display Name: el nombre bonito, con colores.
• Season Duration: cuánto dura (por ejemplo 30d).
• Premium Price: el precio en Battle Points.

3. Cargar los premios

• Reward Configuration: recorré los niveles uno por uno.
• En cada nivel, al menos una reward gratis. El premium es el incentivo para comprar.
• Revisá el primer y el último nivel: son los que más mira el jugador.
• Probá un nivel con Get all rewards.

4. Crear las misiones

• Una misión diaria fácil para engancharlos (por ejemplo /quest create kill-diaria kills 5 kitmap daily 500).
• Una semanal con más esfuerzo.
• Una de "una vez" como meta larga (once).
• Todas con servidor any o el modo correcto.
• Revisá con /quest list que digan Enabled.

5. Iniciar

• Start Season en el editor, o /battlepass start <nombre>.
• /battlepass list muestra el pase como (active).

6. Probar con una cuenta normal

• Entrar al servidor y abrir /battlepass: aparece el pase.
• Abrir Missions, aceptar una misión y completarla.
• Confirmar que subió la XP y el nivel (/battlepass playerInfo <nombre> <jugador>).
• Cobrar un nivel tocando el cofre.
• Comprar el premium con /battlepass premium y cobrar la fila premium.

7. Mantener

• Mirar /quest list cada tanto y apagar las que no tengan sentido.
• Al final de la temporada: End Current Season, crear y empezar la siguiente.
• En la nueva temporada, usar Battle Pass XP en las misiones para que den XP al pase activo.

Referencia rápida: permisos y comandos#

Permisos

Los comandos de jugador (/battlepass, /quests, /challenge list, /level) no piden permiso.

Comandos de jugador

Comandos de admin de niveles

Otros

Qué objetivos funcionan en cada modo#

Un objetivo solo avanza si el modo avisa que pasó. No todos los modos avisan lo mismo.

Qué no existe

Lo que no está en la tabla de arriba, por ejemplo matar mobs, pescar o fabricar, no existe todavía. Para sumarlo hace falta que el modo dispare un evento y crear el objetivo en el addon.

Detalles que ahorran dolores de cabeza

• Para romper o poner bloques se puede pedir un material concreto (por ejemplo solo diamante).
• En capturas se puede pedir un evento concreto por nombre, por ejemplo 3 Eclipse.
• En kills se puede pedir una víctima concreta. Los suicidios no cuentan.
• Una misión con servidor kitmap solo avanza en servidores Kitmap. Si el servidor está registrado en la red con otro tipo, no avanza.
• En Arena y Practice, "jugar partida" cuenta una sola vez por partida, en la primera ronda.
• Tiempo jugado y distancia se miden por muestreo: avanzan en saltos chicos, no de forma continua.
• En recolectar ítems no cuentan los que el mismo jugador tiró al suelo.

Qué muestra hoy battle-web#

• La página /pase ("Pase de batalla") muestra los días que quedan, los niveles con sus premios gratis y Battle+ (el premium), el ranking y el nivel del jugador.
• En el perfil público del jugador aparece su nivel, XP y si tiene premium.
• Las misiones activas se listan en una sección propia dentro de /pase, con filtros por tipo y por modo.
• Crear o editar pases y misiones se hace siempre en el juego, no desde la web.

Problemas conocidos y qué hacer si algo falla#

Si algo no anda

Cosas que conviene saber

• Borrar un pase no borra el progreso. Si después creás otro con el mismo nombre, los jugadores recuperan su nivel.
• /battlepass buy no cobra. Es una entrega gratis de admin. Para el cobro real está /battlepass premium.
• Las misiones dan todas sus rewards juntas. No hay fila gratis y premium como en los niveles.
• Los valores generales son fijos: 30 días de temporada, 100 niveles, 10 000 XP base, 2 500 de incremento y 1000 Battle Points de premium. La duración y el precio se cambian por pase en el editor; los demás valores no se pueden cambiar sin tocar el código.
• Los boosts globales de XP no se pueden activar todavía. Solo existen boosts personales.
• Algunas escrituras a la base y a la billetera se hacen en el hilo principal. Si el servidor se pone lento justo al cobrar o al guardar, es por eso.