Llaves y costes

Una llave es un registro propio: un id, un nombre y el ítem con el que se dibuja. Qué cajas abre lo deciden las cajas — cada una lista las llaves que pide — así que una llave puede abrir varias cajas y sobrevive a una caja que se elimina.

Ítems y saldos

Un jugador puede tener una llave de dos formas, y las dos abren las mismas cajas:

Al abrir una caja se gastan primero los ítems de llave que lleva el jugador y el saldo paga el resto. Un jugador con dos ítems y cinco de saldo puede abrir siete.

Un ítem de llave abre lo que su llave abra ahora: renombrar la llave o cambiar qué cajas la piden cambia lo que hace cada ítem existente. Los ítems de llave no funcionan como su material — una llave dibujada como una baya no se come, una dibujada como un bloque no se coloca.

/crates abre Cajas: cada caja activada con cuántas de su llave tiene el jugador, ítems y saldo juntos, y su total abajo. Un clic abre el contenido de esa caja.

La pantalla de llaves

/cratesadmin keys (o /cratesadmin key list dentro del juego), o Llaves en la lista de cajas, lista todas las llaves con las cajas que las piden. /cratesadmin key create <id> ejecutado dentro del juego abre la pantalla de la llave nueva.

La pantalla de una llave edita su nombre (el nombre del ítem; admite colores), su icono (un material, una cabeza o un ítem de otro plugin; settings.default-key-material hasta que se elige uno, TRIPWIRE_HOOK por defecto), y tiene Obtener llaves, que te da esa cantidad de ítems de llave para probar, y Eliminar llave.

Una llave nueva se nombra con default-key-name de messages.yml: LLAVE » <id>. Solo las llaves nuevas lo toman; una llave existente se renombra desde su pantalla.

Eliminar una llave

Eliminar una llave la quita de los costes de todas las cajas que la pedían, y la confirmación dice cuántas son. Los saldos de los jugadores se conservan, sin leerse: una llave creada otra vez con el mismo id los encuentra ahí. Los ítems de una llave eliminada dejan de abrir nada.

Lo que cuesta una caja

Una caja cobra una lista ordenada de costes por apertura. Coste de apertura en la vista general de la caja los lista.

Sobre un coste: clic izquierdo cambia su cantidad, clic derecho lo quita tras una confirmación. Añadir una llave que la caja ya pide cambia su cantidad en vez de añadir una segunda línea. Una caja sin costes es gratis y lo dice en su vista general.

Una caja puede pedir varias llaves — una llave vote y una llave event — y dinero con ellas. El jugador tiene que pagarlas todas: cuando falta una se le dice cuál ("Necesitas 1x Llave de evento para abrir Rara.") y no se cobra nada.

Cómo se cobra

Primero se cobra el dinero y después cada coste de llave en orden. El cobro es todo o nada: cuando un coste posterior no se puede pagar — otro servidor gastó el saldo un momento antes — se devuelve todo lo ya cobrado, dinero y llaves.

Dinero

El dinero pasa por la economía de ExyliaLib: ExyliaEconomy o cualquier economía de Vault. Un coste de dinero sin moneda es en la moneda por defecto del servidor, y su cantidad se escribe como la escribe esa moneda. Sin un plugin de economía un coste de dinero no se puede pagar, y la caja no se puede abrir. Cada cobro lleva el motivo crates:open y cada devolución crates:refund, para que el registro y las estadísticas de una economía los distingan.

Abrir varias de una vez

Abrir agachado paga tantas aperturas como permitan todos los costes, hasta el límite de aperturas múltiples del jugador: settings.max-multi-open (10), o su exyliacrates.multiopen.<n> más alto. Necesita exyliacrates.multiopen, que tiene todo el mundo por defecto; ver Permisos. Una caja que cuesta 2 llaves y 100 monedas, abierta por un jugador con 7 llaves y 250 monedas, se abre dos veces.

Una caja gratis abierta agachado se abre tantas veces como ese límite cada vez.

Dar y quitar llaves

Todos los comandos de llaves reciben el id de una llave. Un id que no es de ninguna llave pero sí de una caja se lee como la llave de esa caja — la primera llave que lista su coste — así que un comando de tienda puede nombrar la caja.

take y set actúan solo sobre el saldo; nunca tocan los ítems de llave de un inventario.

Los ítems de llave se entregan por la vía de entrega de ExyliaLib: un inventario lleno, la pantalla de muerte o una desconexión los guardan para la siguiente entrada del jugador en vez de tirarlos al suelo.

Al jugador se le avisa cuando le llegan llaves — "Recibiste 3 llaves de Vote." — con el efecto keys.received de config.yml (un título, un sonido y unas partículas por defecto). Las llaves sumadas al saldo de un jugador que no está conectado se anuncian en su siguiente entrada, en el servidor que sea: "Mientras no estabas llegaron 3 llaves de Vote." Un take o un set le dice a un jugador conectado cómo queda.

take y set pueden responder "Las llaves de jugador cambiaron en otro servidor mientras tanto. Inténtalo de nuevo." cuando otro servidor siguió cambiando el mismo saldo durante cinco intentos.

Cada give, take y set, y crear y eliminar llaves y cajas, se escribe en el registro de staff de ExyliaLib, que se lee con /exylialib logs.

Desde una tienda web

Una tienda ejecuta comandos desde la consola mientras el comprador puede estar desconectado. Usa key virtual:

cratesadmin key virtual {username} vote 5

Las llaves se suman en la propia base de datos, así que una compra que llega mientras el jugador gasta una llave en otro servidor cuenta las dos cosas.