Plugin de Minecraft Rankup

🔌 Acerca de Rankup

Rankup es un plugin de Minecraft para Bukkit/Spigot que implementa un sistema configurable de progresión por escalones de rango. Proporciona una GUI para explorar los pasos de rango, un motor de requisitos flexible para controlar cuándo los jugadores pueden avanzar y un sistema de prestigio para la progresión repetida. El plugin está pensado para administradores de servidores que quieren una forma automatizada y configurable de promover jugadores a través de rangos.

🎯 Propósito

Rankup resuelve el problema de gestionar la progresión de los jugadores (escaleras de rango) sin promociones manuales. Centraliza las definiciones de rango, los requisitos de avance y las mecánicas opcionales de prestigio para que los dueños del servidor puedan definir progresiones en varios pasos vinculadas a permisos y requisitos personalizados.

⚙️ Características

• Escalera de rangos configurable definida en rankups.yml.
• GUI para que los jugadores vean y confirmen rankups.
• Sistema de requisitos para definir las condiciones de cada paso de rango (por ejemplo, permisos, tiempo de juego, tokens/valores proporcionados por plugins de requisitos).
• Compatibilidad con prestigio mediante un prestiges.yml separado.
• Comandos para listar rangos, realizar rankups de uno o varios pasos y recargar la configuración.
• Compatibilidad con placeholders mediante el motor de placeholders del plugin para mensajes y GUIs.
• Control de acceso basado en permisos para comandos y funciones administrativas.

🧩 Para quién es

• Servidores Survival / SMP que usan progresión o escaleras de rango.
• Servidores Prison o de economía que exponen sistemas de promoción por etapas.
• Administradores de servidor que quieren un avance de rango basado en permisos con soporte de GUI.

🏗️ Casos de uso de ejemplo

• Definir una secuencia de rangos que requiera automáticamente más tiempo de juego o objetos antes de que un jugador pueda avanzar.
• Usar prestigios para reiniciar el rango de un jugador mientras se otorgan recompensas especiales o contadores de progreso.
• Integrarlo con un plugin de permisos para conceder o quitar nodos de permiso relacionados con el rango cuando un jugador avanza.

⌨️ Comandos

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Descarga el archivo JAR del plugin desde la distribución del plugin (recurso oficial) o compílalo desde el código fuente.
• Coloca el JAR en el directorio plugins/ de tu servidor.
• Inicia o reinicia el servidor y revisa la salida de la consola para confirmar que el plugin se cargó.
• Usa los archivos de configuración proporcionados (rankups.yml, prestiges.yml, locale/config) y el comando de recarga proporcionado para aplicar los cambios en tiempo de ejecución.

📦 Compilar desde el código fuente

• El proyecto incluye un Gradle wrapper; ejecuta el gradlew build incluido para generar el JAR del plugin en el directorio build/libs.

🧠 Notas técnicas

• El plugin usa archivos de configuración YAML (especialmente rankups.yml y prestiges.yml) para las definiciones de rango y prestigio.
• Proporciona un motor de placeholders y admite placeholders para usarlos en mensajes y GUIs.
• El plugin expone nodos de permiso explícitos para comandos y un permiso administrativo para reflejar el acceso de OP.
• El código fuente se publica bajo GPL-3.0.

🤝 Cuándo es útil este plugin

Si necesitas una escalera de rangos configurable y consciente de permisos, con soporte de GUI y prestigio, Rankup centraliza las definiciones de rango y las reglas de avance para automatizar la progresión de los jugadores sin promociones manuales.