✨ qsCrates v3.0.0 – Actualización 6 de noviembre de 2025 ✨
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Descripción general del plugin

qsCrates es un plugin avanzado para servidores Spigot y Paper que permite crear cajas personalizadas con llaves, cofres vinculados, hologramas y efectos visuales únicos.
Ideal para recompensas de jugadores, llaves de donadores, votaciones, cajas de batalla ¡y mucho más!

• ️ Animaciones únicas al abrir cajas
• Llaves y cofres personalizables
• Asignación de cajas a cofres físicos
• ✨ Hologramas visibles
• ⏱️ Cooldowns globales e individuales
• ️ Permisos configurables
• Menú GUI para administración
• ✅ Autocompletado de comandos

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Instalación paso a paso

1. ⬇️ Descarga el archivo [.jar] desde la sección de lanzamientos.
2. Coloca el archivo en la carpeta
   Code (Text):

   plugins/
   de tu servidor.
3. Reinicia el servidor para cargar el plugin.
4. ️ Configura las cajas desde
   Code (Text):

   plugins/qsCrates/
   .

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requisitos mínimos

• Servidor Spigot o Paper 1.21.1 o superior
• ☕ Java 17 o superior (según versión del servidor)
• Dependencia: Vault (obligatoria para funciones de economía/permisos)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Comandos y permisos disponibles

Comando	Descripción	Permiso
/qscrates crearcaja	Inicia creación guiada de una caja.	qsCrates.crearcaja
/qscrates asignar <id>	Asigna una caja al cofre que estás mirando.	qsCrates.asignarcaja
/qscrates quitar	Quita la caja del cofre seleccionado.	qsCrates.asignarcaja
/qscrates darllave <jugador> <id> [cantidad]	Entrega llaves al jugador.	qsCrates.darllave
/qscrates resetcooldowns [jugador]	Resetea cooldowns globales o individuales.	qsCrates.resetcooldowns
/qscrates recargar	Recarga la configuración y los hologramas.	qsCrates.recargar
/qscrates adminmenu	Abre el menú administrativo GUI.	qsCrates.admin

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
️ Animaciones disponibles

ID	⏳ Duración	Descripción
sol	10 seg	Partículas giran en un patrón radial.
serpiente	10 seg	Espiral mágica ascendente.
ruedas	8 seg	Giro visual con ítems flotantes.
ruleta	10 seg	Rueda con flecha de selección final.
fuegos	6 seg	Fuegos artificiales celebratorios.
ninguna	Instantáneo	Sin animación (recompensa directa).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Formas de partículas disponibles

• circle: Círculo giratorio
• ️ spiral: Espiral ascendente
• burst: Explosión rápida
• helix: Hélice doble
• wave: Onda circular
• sphere: Esfera envolvente
• beam: Columna vertical
• ❤️ pulse: Latido pulsante
• orbit: Órbita constante
• rings: Anillos verticales

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Tipos de partículas

• FLAME
• SMOKE
• HEART
• ENCHANT
• ✨ CRIT
• SOUL
• NOTE
• DRAGON_BREATH
• END_ROD
• EXPLOSION
• ️ ASH
• ⚡ ELECTRIC_SPARK
• BUBBLE
• LAVA
• PORTAL
• ☠️ OMNIOUS_SPAWNING
• SONIC_BOOM

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️ Importante: configuración de recompensas

⚠️ No edites manualmente las recompensas en los archivos YAML.
✅ Usa exclusivamente la GUI del plugin para configurar recompensas.
Esto evita errores y garantiza compatibilidad total con efectos y animaciones.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Ejemplo de configuración – Caja épica
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
️ Interfaz gráfica (GUI) del plugin

Descubre una administración sencilla e intuitiva con los menús integrados del plugin. ¡Todo al alcance de unos clics!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Menú Principal – Cajas y Llaves
Gestiona fácilmente todas tus cajas y llaves desde un solo lugar.
Haz clic en cualquiera de los ítems para acceder a su configuración detallada.



Menú de Llaves – Configura cada llave

Gestiona fácilmente todas las llaves vinculadas a tus cajas desde una interfaz clara e intuitiva.
Cada llave representa un acceso directo a una caja específica del servidor.

• ️ Dar llaves rápidamente: haz clic derecho sobre una llave para entregarla a un jugador, indicando la cantidad deseada.
• ️ Cambiar nombre de la llave: edita el nombre visible del ítem (soporta colores con &).
• Modificar material del ítem: elige el material visual que representará la llave (por defecto TRIPWIRE_HOOK).
• Asignar caja vinculada: selecciona qué caja abrirá esta llave dentro del sistema.
• ️ Eliminar llave: elimina llaves que ya no estén en uso de manera segura.

Las llaves se crean automáticamente al generar una nueva caja, y pueden editarse o duplicarse desde este menú.






Menú de Cajas – Visualiza y edita cajas existentes

Administra de forma completa todas tus cajas personalizadas directamente desde la interfaz gráfica (GUI).
Cada caja mostrada corresponde a las creadas en tu archivo crates.yml.

• Muestra todas las cajas creadas: visualiza las cajas disponibles con su nombre, material e ID.
• ➕ Crear nuevas cajas: usa el ítem de papel para generar una caja vacía desde la GUI.
• ✏️ Editar cajas existentes: haz clic en una caja para abrir su panel de configuración detallado.
• ❌ Eliminar cajas innecesarias: elimina cajas de forma segura con confirmación por chat.
• ⏱️ Configurar cooldowns: establece tiempos personalizados de reutilización (por ejemplo 30s, 5m, 1h).
• Configurar precios: define el costo para abrir una caja sin llave usando la economía del servidor (Vault).
• Configurar recompensas: administra las recompensas de cada caja desde una interfaz intuitiva.
• Activar o desactivar llave requerida: decide si la caja necesita una llave o puede abrirse pagando o gratis.
• ✨ Gestionar animaciones de apertura: agrega, cambia o elimina animaciones visuales al abrir una caja.
• Animaciones permanentes de caja: añade efectos visuales o partículas continuas alrededor de los cofres asignados.

Todo se configura de forma visual, sin necesidad de editar archivos YAML manualmente.





Todos los menús son accesibles con el comando /qscrates adminmenu

¡Gracias por usar qsCrates! Mejora tu servidor con cajas visuales y animadas ✨