Introducción
Qué es ExyliaCrates, qué cubre, qué necesita para funcionar y cómo está organizada esta documentación.
ExyliaCrates convierte cualquier bloque en una caja. Un jugador le hace clic derecho con una llave, la caja reproduce una de once animaciones de apertura sobre el bloque y el premio sale delante de todos los que están cerca. Con clic izquierdo en el mismo bloque se ve qué contiene y la probabilidad real de cada recompensa.
Todo lo de una caja — su nombre, lo que cuesta abrirla, sus recompensas, su garantía, su animación y dónde
está — se crea y se edita dentro del juego desde /cratesadmin. Nada de una caja vive en un archivo: cajas,
llaves, saldos e historial son filas de la base de datos, así que una red que comparte una base de datos
lo comparte todo.
Es un plugin premium, a la venta en BuiltByBit e instalado a través de un cargador de licencias. Las cajas eran antes un módulo de ExyliaSurvivalCore; ahora son este plugin. Ver Instalación para lo que eso significa en un servidor que las usaba.
Qué incluye
Creadas desde un menú, colocadas en cualquier bloque con una varita, cada una con un icono flotante, un holograma y una pantalla general dividida en cinco secciones.
Llaves y costesLas llaves son registros propios, que se tienen como ítems y como un saldo que vale lo mismo en todos los servidores. Una caja pide cualquier lista de llaves y dinero, o nada.
Recompensas y rarezasRecompensas con peso, rarezas que siguen a las probabilidades reales, una garantía tras tantas aperturas y una pantalla de contenido que muestra las probabilidades reales.
AperturasAperturas compartidas o privadas, abrir varias llaves de una vez, clic para acelerar, el historial y los anuncios a todo el servidor.
AnimacionesWheel of Fortune, Carousel, Cosmic Orb, Pick a Card, Tier Slots, Rift, Tesseract, Event Horizon, Constellation, Orrery y Starfall, cada una ajustada en su propio archivo.
API para desarrolladoresLeer y dar llaves desde otro plugin, y escuchar cada apertura.
Requisitos
| Requisito | Detalle |
|---|---|
| Servidor | Paper 1.21.1 o superior, o un fork. Folia 1.21.4 o superior. |
| Java | 21 |
| Dependencias obligatorias | packetevents, y ExyliaLib 1.448.1 o superior — se instala sola si falta |
| Dependencias opcionales | PlaceholderAPI, una economía (ExyliaEconomy o Vault) para cajas que cuestan dinero |
La configuración, los menús y sus preguntas, el editor de recompensas, la base de datos, los hologramas, los displays con los que se dibujan las animaciones, los efectos, el canal de anuncios y el registro de staff vienen de ExyliaLib. ExyliaCrates está escrito sobre ella y no funciona sin ella, por eso el cargador la instala en un servidor que no la tiene.
Cómo funciona una caja, en un párrafo
Una llave es un registro con un id, un nombre y un ítem. Una caja indica qué llaves pide por apertura — o dinero, o nada. El jugador paga primero con los ítems de llave que lleva encima y con su saldo de llaves el resto. El premio se sortea en el momento en que se gasta la llave, por peso y con la garantía aplicada; la animación solo lo muestra y cae en él. Se entrega cuando sale en pantalla, y se entrega igualmente si el jugador se va, muere o cambia de mundo antes.
Cómo leer esta documentación
Empezar
La instalación, y después una primera caja con una llave, una recompensa y un bloque en pocos minutos.
Cajas
Las pantallas de una caja, llaves y costes, recompensas y rarezas, qué pasa durante una apertura y las once animaciones.
Referencia
Comandos, permisos, placeholders, cada clave de configuración, la API para desarrolladores y las preguntas más frecuentes.
Convenciones
- Los valores marcados como por defecto son los que el plugin escribe la primera vez que arranca. Si el archivo ya existe, se conserva tu valor.
- Los identificadores entre
<y>son variables./crates preview <crate>significa/crates preview vote, no/crates preview <vote>. - El id de una caja es con el que se creó y nunca cambia; su nombre visible es lo que ven los jugadores.
- Los colores usan los tokens de paleta de ExyliaLib (
{primary},{highlight},{muted}), y los códigos&también funcionan.
¿Falta algo en esta página? Dínoslo en Discord