CrazyCrates — un plugin para añadir cajas personalizadas y cofres de recompensas en Minecraft

CrazyCrates — un plugin para añadir cajas personalizadas y cofres de recompensas en Minecraft

CrazyCrates permite añadir cajas (crates) a un servidor de Minecraft. Cada caja es un bloque en el mundo o una posición en un menú que un jugador abre con una llave para recibir un premio aleatorio. El plugin proporciona 11 tipos diferentes de animaciones, dos tipos de llaves — físicas (objetos en el inventario) y virtuales (almacenadas en la base de datos) — y un sistema de probabilidad basado en el peso en lugar de porcentajes. Se distribuye de forma gratuita. 

Menú principal /crates con las cajas en forma de objetos en el inventario 

Tipos de cajas 

Cada caja en el servidor es un archivo .yml independiente en la carpeta crates/. El archivo tiene un parámetro CrateType, que determina la animación de apertura.

En el primer inicio, el plugin genera 6 ejemplos listos para usar que cubren 5 tipos confirmados. Puedes abrir cualquiera de ellos para una prueba sin una llave usando el comando /crazycrates forceopen <nombre_archivo> <apodo>.

Todas las cajas básicas disponibles 

Scroll - en el inventario aparece una cinta horizontal de objetos, que se desplaza, se ralentiza gradualmente y se detiene en el objeto ganador en el medio. Este tipo es utilizado por dos ejemplos — CrateExample.yml y AdvancedExample.yml.

Ejecución de CrateExample — una cinta horizontal de objetos se desplaza y se detiene en el ganador

Cosmic — en el inventario aparecen varios premios para elegir. El jugador hace clic en el que quiere llevarse. Si en 10 segundos no se selecciona nada, el plugin otorga un premio automáticamente. Casino — caja con niveles (tiers). Primero, la animación determina el nivel, y luego, dentro de él, el premio específico. 

QuadCrate — al abrir, cuatro bloques-caja físicos se generan alrededor del jugador en el mundo. El jugador se acerca a cada uno y los abre uno a uno — cada uno da un premio por separado. 

Wonder — aparece una ventana con un inventario completo del que los objetos desaparecen gradualmente; el que quede será el premio.

Llaves

Cada caja utiliza su propia llave. Una llave física — es un objeto común con un aspecto, nombre y descripción (lore) personalizados que el jugador tiene en su inventario. Una llave virtual no ocupa espacio — se almacena en la base de datos del plugin y está vinculada a la cuenta del jugador.

Por defecto, un bloque de caja física acepta ambos tipos. El comportamiento se puede cambiar en config.yml por separado para cada combinación.

Si el inventario del jugador está lleno al recibir la llave, el plugin la convierte en una virtual o la tira al suelo — dependiendo de la configuración. Al intentar abrir una caja sin llave, el jugador es empujado hacia atrás.

Los administradores pueden dar y quitar llaves incluso a jugadores sin conexión, repartir una llave a todos los jugadores conectados a la vez mediante un solo comando, o dar una llave aleatoria de todas las cajas disponibles. Los jugadores con el permiso adecuado pueden transferir sus llaves virtuales a otros.

Llave física de una caja — un objeto con descripción personalizada

Sistema de probabilidades 

La probabilidad de cada premio se determina no por porcentajes, sino por peso — el parámetro Weight en el archivo de la caja. Cuanto mayor sea el valor de peso, más a menudo sale el premio; cuanto menor sea, menos frecuente es.

El rango máximo es la suma de todos los pesos en la caja. Si tres premios tienen pesos de 10, 15 y 25, el rango es 50. La posibilidad del primero es del 20%, el segundo — 30%, y el tercero — 50%.

La ventaja de este enfoque sobre los porcentajes es que no es necesario asegurarse de que la suma no supere 100. Simplemente se pueden establecer valores relativos y agregar nuevos premios sin tener que recalcular el resto.

Comandos

El comando principal del plugin es /crazycrates, con los alias /crates y /cc. Los jugadores solo tienen acceso a /keys (ver sus llaves) y /crates (abrir el menú).

Comandos de administrador:

• /crazycrates give y /crazycrates take — dar o quitar una llave a un jugador específico, incluso estando desconectado.

• /crazycrates giveall — repartir una llave a todos los jugadores en línea simultáneamente.

• /crazycrates forceopen — abrir una caja para un jugador de forma gratuita, sin necesidad de llave.

• /crazycrates editor — modo de colocación de cajas en el mundo: apuntas a un bloque y le vinculas una caja.

• /crazycrates debug — obtener todos los premios de la caja de una vez para probar los ajustes.

• /crazycrates mass-open — apertura masiva de una cantidad específica de cajas a la vez.

• /crazycrates reload — recargar todas las configuraciones sin reiniciar el servidor.

• /crazycrates migrate — importar cajas desde otros plugins o convertir un formato de archivo obsoleto.

Los permisos están divididos en tres comodines (wildcards): crazycrates.players.* para jugadores, crazycrates.admin.* para administradores, crazycrates.schematic.* para trabajar con schematics. Se puede excluir a un jugador del reparto masivo /giveall mediante un permiso independiente.

Configuración

Todos los archivos del plugin están en la carpeta plugins/CrazyCrates/. El principal es config.yml, donde se concentran las configuraciones globales del servidor. Las cajas se guardan en la subcarpeta crates/ — cada una en un archivo separado. La carpeta examples/ contiene ejemplos de los desarrolladores, pero no debes editarlos: se sobrescribe por completo en cada /crazycrates reload. Todos los textos de los mensajes se encuentran en messages.yml y se editan por separado.

En config.yml debes prestar atención a algunas cosas. Los hologramas sobre las cajas aparecen automáticamente si en el servidor está instalado DecentHolograms, FancyHolograms o CMI — el plugin los captará por sí mismo. Si no hay ninguno, simplemente no habrá hologramas. Los mensajes a los jugadores se pueden enviar al chat o a la barra de acción (action bar) — dependiendo de cómo esté configurado el servidor. El registro (log) de acciones con llaves y cajas se activa por separado para la consola y para un archivo; los registros de archivo se comprimen en zip al reiniciar.

Cada caja se configura en su propio archivo. Además del tipo de animación y la lista de premios, se define el aspecto de la llave física, el texto del holograma sobre el bloque, el tamaño y diseño de la ventana de vista previa, los sonidos durante el desplazamiento y al finalizar, y la posibilidad de volver a sortear el premio si el resultado no es satisfactorio.

Conclusión

CrazyCrates añade sistemas de animaciones tanto para tiendas de donación como para la progresión del juego en supervivencia. El sistema de probabilidades basado en el peso es más conveniente que el porcentaje cuando se edita activamente — no es necesario volver a calcular toda la lista cada vez.

Para servidores de PvP y supervivencia con un sistema de donación, CrazyCrates es una opción cómoda. Para un servidor simple, donde solo se necesita una caja sin animaciones, QuickCrate y una configuración mínima serán suficientes.