La caja

La caja es cómo se ganan los trims en vez de regalarlos. Se gasta una llave, cae un rodillo, y lo que sale se desbloquea en la cuenta del jugador — suyo para siempre, pase lo que pase con su rango. La caja en sí es de ExyliaLib; este plugin le pasa el catálogo y lee sus ajustes y sus textos de config.yml y messages.yml.

Funciona en cualquier modo: las llaves, las pantallas de la caja y los bloques de caja están incluso con mode: item. Abrirla pide exyliaarmortrims.crate, que todo el mundo tiene por defecto.

En qué puede caer

Dos tipos de premio, todos de trims.yml:

Una combinación nunca es un premio; sus dos mitades sí. Un trim se lleva en cuanto el jugador tiene las dos mitades, por nodo o por desbloqueo.

Rarezas

Cada patrón y material declara un tier en trims.yml, y config.yml declara qué rarezas existen, bajo crate.tiers:

crate:
  tiers:
    common:
      name: "Common"
      color: "{muted}"
      chance: 60.0
      priority: 1
    rare:
      name: "Rare"
      color: "{info}"
      chance: 25.0
      priority: 2
    epic:
      name: "Epic"
      color: "{accent}"
      chance: 12.0
      priority: 3
    legendary:
      name: "Legendary"
      color: "{highlight}"
      chance: 3.0
      priority: 4

El catálogo que viene tiene 29 premios:

Nada está fijado en el código. Borra legendary, inventa mythic, renombra las cuatro: la clave es el id que trims.yml escribe como tier, y una entrada que nombra una rareza que ya no existe cae en la primera. Una entrada sin tier es common.

Llaves

Dos tipos, y la caja acepta los dos.

En la cuenta

Un número en la fila de caja del jugador. Nada se puede tirar, duplicar ni perder por un inventario lleno:

/armortrimsadmin keys give <jugador> <cantidad>
/armortrimsadmin keys take <jugador> <cantidad>
/armortrimsadmin keys set <jugador> <cantidad>
/armortrimsadmin keys check <jugador>

Se puede ejecutar desde consola y con jugadores desconectados — una tienda, un listener de votos o un plugin de recompensas entregan llaves igual:

[console] armortrimsadmin keys give %player% 1

Cada jugador recibe crate.start-keys llaves — ninguna por defecto — la primera vez que se le ve.

En la mano

Un objeto, para venderlo, meterlo en un kit, tirarlo o regalarlo a un amigo:

/armortrimsadmin item key <jugador> [1-64]

Clic derecho con una en la mano sobre un bloque de caja y se abre al momento: una llave, un rodillo, sin pantalla de pregunta. El clic izquierdo nunca gasta una — así pregunta el jugador qué es un bloque. Cómo se dibuja la llave es crate.key-item en config.yml (material y brillo) y key-item en messages.yml (nombre y lore); se reconoce por lo que lleva en sus datos, no por su nombre ni su material. Las llaves que no caben en el inventario esperan y se entregan al volver a entrar, con rewards-claimed.

Abrir

/armortrim crate, el botón TRIM CRATE en la esquina del menú de trims, el icono de la caja del vestidor 3D, o un bloque de caja pulsado sin llave en la mano. La primera pantalla solo pregunta una cosa: cuántas a la vez.

Con crate.opening: SPATIAL los rodillos se sustituyen por la apertura en el mundo — ver La apertura en 3D.

Qué sale

Lo decide crate.reward:

Un patrón o un material no tiene objeto propio, así que, siendo mitades todos los premios, ITEM y BOTH se comportan como UNLOCK: una llave nunca se gasta a cambio de nada. crate.won nombra lo que salió (%reward%) y su rareza (%tier%).

Repetidos

Caer en algo que el jugador ya tiene le devuelve llaves, tantas como diga crate.duplicate-refund, con crate.duplicate (%refund% es cuántas). Con el 1 por defecto un repetido es una tirada gratis, no una pérdida.

Comprar con moneda

Lo que sigue bloqueado se puede comprar en vez de ganarlo. Un patrón o material bloqueado con precio se dibuja con la plantilla *_purchasable_template del menú, con su precio; pulsarlo pide confirmar, cobra y lo desbloquea igual que una caja. El vestidor 3D vende las mismas mitades con su botón BUY & SAVE. Comprar pide exyliaarmortrims.buy, que todo el mundo tiene por defecto.

shop:
  enabled: true
  tier-prices:
    common: 500
    rare: 1500
    epic: 4000
    legendary: 10000

Una entrada de trims.yml puede poner su propio price, que gana al de su rareza:

patterns:
  silence:
    tier: legendary
    price: 25000                          # la moneda por defecto
materials:
  netherite:
    tier: epic
    price: {amount: 50, currency: gems}   # una moneda con nombre

La confirmación y cada resultado — comprado, ya lo tienes, no te llega — son textos de ExyliaLib, bajo purchase en su messages.yml. Tras la compra el menú se vuelve a abrir.

Ajustes

crate:
  enabled: true
  start-keys: 0
  duplicate-refund: 1
  reward: UNLOCK
  blocks: []
  max-at-once: 4
  spin-frames: 34
  stagger-seconds: 2.0
  opening: INVENTORY
  key-item:
    material: TRIPWIRE_HOOK
    glow: true

on-spin, on-win y on-duplicate son bloques de efecto completos de ExyliaLib — título, action bar, boss bar, sonido, partícula y fuego artificial — que suenan mientras giran los rodillos y luego una vez por rodillo al caer. Vienen con un sonido cada uno: BLOCK_NOTE_BLOCK_HAT, ENTITY_PLAYER_LEVELUP y BLOCK_NOTE_BLOCK_BASS.

La apertura en 3D

crate.opening: SPATIAL juega una apertura delante del jugador en vez de los rodillos: una caja en el mundo, un rodillo que frena sobre el premio, la revelación y una vista previa — un patrón se le prueba al jugador como set completo en el primer material del catálogo, un material muestra su icono. Agacharse salta al final y entrega el premio al momento.

El premio se sortea igual en los dos casos: las llaves, las probabilidades, los repetidos y los pagos no cambian. Su aspecto es spatial/crate.yml, la escena de caja de ExyliaLib. Un cliente anterior a la 1.21.4 recibe los rodillos.

Bloques de caja

Un bloque físico, en cualquier parte del mundo, que abre la caja al pulsarlo:

/armortrimsadmin crate block add      # el bloque que miras, hasta seis bloques de distancia
/armortrimsadmin crate block remove
/armortrimsadmin crate block list
/armortrimsadmin crate block clear

Se escriben en config.yml, no en el mundo, así que un bloque enlazado sobrevive a pegar una schematic, a una edición del mundo y a un rollback. Mientras está enlazado no se puede romper, volar ni empujar, y pulsarlo ya no hace lo que hace su material — una caja dibujada en un barril no debe abrir un barril.

Entregar trims sin caja

/armortrimsadmin unlocks grant <jugador> <premio>
/armortrimsadmin unlocks revoke <jugador> <premio>

<premio> es pattern:<id> o material:<id>. El mismo desbloqueo que escribe una caja, para un plugin de recompensas o un ticket de soporte. Sobrevive a que caduque un rango y no necesita plugin de permisos. Para quitarle a un jugador todo lo que desbloqueó, usa el reinicio de jugador de ExyliaLib con @account.