Plugin de Minecraft ExcellentCrates

🔌 Acerca de ExcellentCrates

ExcellentCrates es un plugin de Minecraft para servidores Spigot/Paper que implementa un sistema completo de crates (lootbox). Se centra en tipos de crates configurables, gestión de llaves (virtuales y físicas) y definiciones flexibles de recompensas que los administradores del servidor pueden gestionar principalmente mediante un editor GUI dentro del juego.

🎯 Propósito

El plugin resuelve el problema de crear, configurar y presentar recompensas basadas en crates en un servidor sin necesidad de editar archivos manualmente. Está pensado para propietarios y administradores de servidores que quieren usar crates de recompensas (para eventos, recompensas diarias, funciones monetizadas o progresión del jugador) manteniendo la configuración y las vistas previas accesibles dentro del juego.

⚙️ Características

• Editor GUI dentro del juego para crear y gestionar crates, llaves y recompensas.
• Compatibilidad con llaves físicas y virtuales (las llaves virtuales evitan el intercambio/compartición).
• Hologramas integrados y efectos de partículas para bloques de crates (pueden requerirse plugins opcionales para algunas funciones de holograma).
• Crate Blocks: vincula crates a bloques/zonas físicas para la interacción con crates en el mundo.
• GUIs personalizadas de vista previa y GUIs personalizadas de apertura por crate.
• Tipos de recompensa: recompensas de objetos y recompensas de comandos.
• Compatibilidad con bundles: varios stacks de objetos por recompensa (límite documentado de hasta 27 objetos por recompensa de objeto) y comandos ilimitados por recompensa de comando.
• Rarezas y pesos para equilibrar la probabilidad de recompensa.
• Hitos y funcionalidad de apertura masiva.
• Tiempos de espera entre aperturas y coste de apertura por jugador (la integración con economía se подразуме por la función de coste de apertura).
• Requisitos de permisos y llaves para crates y recompensas.
• Límites de recompensa (globales y por jugador) y difusión/registro de recompensas.
• Compatibilidad con PlaceholderAPI indicada por fuentes oficiales.

🧩 Para quién es

• Servidores públicos y privados de Spigot/Paper que usan crates para eventos, monetización o participación de jugadores.
• Administradores de servidor que prefieren un editor dentro del juego en lugar de editar YAML manualmente.

🏗️ Casos de uso de ejemplo

• Configura una crate con rarezas y recompensas ponderadas, coloca un bloque de crate en el spawn y dales a los jugadores llaves virtuales para abrirla.
• Crea vistas previas de crates y hologramas para que los jugadores puedan inspeccionar las recompensas antes de gastar llaves.
• Usa la apertura masiva y los hitos para ejecutar eventos por tiempo limitado o recompensar a los jugadores activos.

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin y colócalo en el directorio plugins/ de tu servidor en una build confirmada como compatible (Spigot o Paper).
• Reinicia el servidor y revisa la consola para confirmar que el plugin se cargó.
• Si el plugin requiere la dependencia del motor complementario, instala el plugin de dependencia necesario (nightcore) antes o junto con ExcellentCrates.

📦 Dependencias

• Requerido: nightcore (motor del plugin), según indican las fuentes oficiales.
• Opcional: ProtocolLib o PacketEvents para funcionalidad avanzada de hologramas; PlaceholderAPI es compatible para placeholders en textos.

🧠 Notas técnicas

• Software de servidor compatible confirmado: Spigot y Paper.
• Requisito mínimo de versión del servidor confirmado: 1.21.8 o superior (según indica el proyecto).
• Requisito de Java confirmado: Java 21 o superior.
• La compatibilidad con Folia y Forge no está admitida explícitamente.
• El repositorio del proyecto indica una licencia GPL-3.0.

🤝 Cuándo es útil este plugin

Si necesitas un sistema de crates configurable dentro del juego con llaves virtuales/físicas, hologramas y definiciones flexibles de recompensas (objetos, comandos, rarezas y límites) para un servidor Spigot/Paper, ExcellentCrates ofrece esas funciones y un flujo de edición que mantiene la mayor parte de la configuración manejable sin editar archivos manualmente.