Kits y cajas

Kits

Un kit es una fila en la base de datos, montada entera desde /kitadmin. No hay ningún archivo de kits.

/kit los lista, /kit preview <id> enseña uno sin reclamarlo, /kit claim <id> se lo lleva.

La lista dibuja un kit en uno de cuatro estados — listo, en cooldown, agotado o bloqueado — cada uno con su plantilla en modules/kits/menus/list.yml.

La vista previa merece conocerse: una shulker o un bundle dentro de un kit se puede abrir en la vista previa, así que un jugador ve lo que hay dentro antes de reclamarlo. settings.preview.container-hint es el lore que se añade a esos contenedores, con %items%.

exyliasurvivalcore.kits.bypass se salta cooldowns y límites de uso. /kitadmin give, reset y resetall manejan el registro de un jugador; give le entrega el kit haya esperado o no. Otro plugin puede hacer lo mismo a través de la API, con o sin cooldown y límite de usos.

Cajas

Una caja es un bloque en el mundo, una llave, una tabla de premios y una animación. Hacer clic derecho en el bloque gasta una llave y lanza la animación; /crates abre la lista, /crates preview <id> enseña los premios, /crates open <id> [all] abre sin el bloque, y /crates history muestra lo que se ha ganado.

Todo se monta desde /cratesadmin.

Llaves

Las llaves son objetos físicos por defecto: un TRIPWIRE_HOOK con el nombre de la caja, dado con /cratesadmin key give. Las llaves virtuales — un contador en el jugador en vez de un objeto — se dan con /cratesadmin key virtual. Las llaves que da otro plugin a través de la API son virtuales.

Esos cinco subcomandos key son los únicos que funcionan desde consola, que es lo que necesita una tienda web:

/cratesadmin key give <jugador> <caja> <cantidad>
/cratesadmin key giveall <caja> <cantidad>
/cratesadmin key virtual <jugador> <caja> <cantidad>
/cratesadmin key take <jugador> <caja> <cantidad>
/cratesadmin key set <jugador> <caja> <cantidad>

Las llaves físicas que no caben se guardan para la próxima vez que entre el jugador en vez de tirarse a sus pies — ver Objetos que no caben. Lo mismo pasa con las llaves que se devuelven cuando una apertura falla.

Tiers

modules/crates/tiers.yml convierte el peso de un premio en una rareza.

tiers:
  legendary: { display: "…", color: "…", max-weight: 1.0,       broadcast: true,  sound: "…" }
  epic:      { max-weight: 5.0,       broadcast: true }
  rare:      { max-weight: 25.0 }
  common:    { max-weight: 1000000.0 }

Un premio pertenece al primer tier, en max-weight ascendente, cuyo max-weight no supera. Así que un premio de peso 3 es epic, y uno de peso 0,5 es legendary. broadcast: true anuncia al servidor un premio de ese tier — uno de los siete anuncios que un jugador puede apagar en /settings.

Pity

Cada caja tiene un contador pityAfter y un pityTier: después de esas aperturas sin sacar el tier, la siguiente lo garantiza. Es por jugador y por caja.

Animaciones

modules/crates/animations.yml trae diez, una por estilo.

NONE es el undécimo estilo: sin animación, directo al premio.

Cada animación acepta duration, radius, height, spins, scale, items, glow, win-hold, tick-sound, y las listas de efectos intro y win. No todos los campos significan lo mismo en todos los estilos:

• radius lo ignoran SLOT y SLOTS, y REEL lo lee como a qué distancia por delante del jugador se dibuja la tira.
• spins lo ignoran KNOCKOUT y COMET, y SPOTLIGHT lo lee como cuántas vueltas da.
• items lo redondea KNOCKOUT hacia abajo a 4, 8 o 16, para que su cuadro divida bien.
• height tiene que quedar por encima del holograma, que está a 1,6.
• tick-sound sube de tono según se frena el giro. Una cadena vacía es un giro silencioso.

El premio ganador aparece por toda la tira como cualquier otro, así que el resultado no se ve antes de que aterrice la animación, y el bloque vuelve a aparecer cuando termina la apertura.

La animación en reposo

Una caja puede reproducir algo en bucle mientras nadie la abre:

idle-interval-seconds: 0 apaga el bucle entero, icono flotante incluido.

history-retention-days viene en 30; 0 lo guarda todo.

Cofres de loot

Una plantilla es una tabla de loot con nombre. Un cofre es una plantilla colocada en el mundo con su propio cooldown.

/lootchestsadmin abre la lista de plantillas. Place te da una varita — un BLAZE_ROD por defecto — y hacer clic en un cofre con ella le asocia esa plantilla.

El holograma tiene tres estados: listo, en cooldown con %time%, y desactivado.

Un cofre puede ser disperso, lo que reparte su loot por el contenedor en vez de llenarlo desde la primera ranura. exyliasurvivalcore.lootchests.bypass ignora el cooldown.

Spawners de objetos

Un bloque que suelta un objeto brillante en un intervalo aleatorio, bajo un holograma de cuenta atrás. Se monta desde /spawnersadmin: un spawner tiene una tabla de loot, un intervalo mínimo y máximo, y una lista de posiciones.

En una red

Cuando varios servidores comparten una base de datos, los bloques de caja, los cofres de loot colocados y los spawners de objetos pertenecen al servidor donde se colocaron, y cada servidor carga solo los suyos. Los cofres y spawners colocados antes de que se registrara el servidor cargan en todos los servidores que los leen.

Objetos que no caben

Lo que entregan estos módulos ya no se tira a los pies del jugador cuando tiene el inventario lleno. Lo que no cabe va a la tabla de recompensas pendientes de ExyliaLib y se entrega la próxima vez que entra el jugador, con la línea rewards.claimed de messages.yml: "Delivered N rewards that were waiting for you." Eso cubre:

• lo que sobra de un kit con Tirar si está lleno activado;
• las llaves físicas de /cratesadmin key give y giveall;
• las llaves que se devuelven cuando falla la apertura de una caja;
• la varita de colocación de cajas.

Mientras el jugador siga conectado no se entrega nada: la tabla se vacía al entrar.

Contadores

Estos módulos suman a los contadores de estadísticas, que leen los rankings, las misiones y las temporadas — ver Estadísticas.