Plugin Minecraft Rankup

🔌 À propos de Rankup

Rankup est un plugin Minecraft pour Bukkit/Spigot qui implémente un système de progression configurable par paliers de rang. Il fournit une GUI pour parcourir les étapes de rang, un moteur de prérequis flexible pour contrôler quand les joueurs peuvent avancer, ainsi qu’un système de prestige pour une progression répétée. Le plugin est destiné aux administrateurs de serveur qui veulent un moyen automatisé et configurable de faire progresser les joueurs à travers les rangs.

🎯 Objectif

Rankup résout le problème de gestion de la progression des joueurs (échelles de rang) sans promotion manuelle. Il centralise les définitions de rang, les prérequis d’avancement et les mécaniques de prestige optionnelles afin que les propriétaires de serveur puissent définir des progressions en plusieurs étapes liées aux permissions et à des prérequis personnalisés.

⚙️ Fonctionnalités

• Échelle de rang configurable définie dans rankups.yml.
• GUI pour permettre aux joueurs de voir et de confirmer les rankups.
• Système de prérequis pour définir les conditions de chaque étape de rang (par exemple, permissions, temps de jeu, tokens/valeurs fournis par des plugins de prérequis).
• Prise en charge du prestige avec un prestiges.yml séparé.
• Commandes pour lister les rangs, effectuer des rankups d’un ou plusieurs niveaux et recharger la configuration.
• Prise en charge des placeholders via le moteur de placeholders du plugin pour les messages et les GUIs.
• Contrôle d’accès basé sur les permissions pour les commandes et les fonctions administratives.

🧩 À qui il s’adresse

• Serveurs Survival / SMP utilisant une progression ou des échelles de rang.
• Serveurs Prison ou économie qui proposent des systèmes de promotion par étapes.
• Administrateurs de serveur qui veulent une progression de rang basée sur les permissions avec prise en charge de GUI.

🏗️ Exemples d’utilisation

• Définir une suite de rangs qui exige automatiquement plus de temps de jeu ou d’objets avant qu’un joueur puisse avancer.
• Utiliser les prestiges pour réinitialiser le rang d’un joueur tout en accordant des récompenses spéciales ou des compteurs de progression.
• Intégrer un plugin de permissions pour accorder ou retirer des nœuds de permission liés au rang lorsqu’un joueur avance.

⌨️ Commandes

🔐 Permissions

⚙️ Installation

📥 Mise en place

• Téléchargez le JAR du plugin depuis la distribution du plugin (ressource officielle) ou compilez-le depuis les sources.
• Placez le JAR dans le dossier plugins/ de votre serveur.
• Démarrez ou redémarrez le serveur et vérifiez la sortie de la console pour confirmer que le plugin a bien été chargé.
• Utilisez les fichiers de configuration fournis (rankups.yml, prestiges.yml, locale/config) ainsi que la commande de rechargement fournie pour appliquer les changements à chaud.

📦 Compiler à partir des sources

• Le projet inclut un Gradle wrapper ; exécutez le gradlew build inclus pour produire le JAR du plugin dans le dossier build/libs.

🧠 Notes techniques

• Le plugin utilise des fichiers de configuration YAML (notamment rankups.yml et prestiges.yml) pour les définitions de rang et de prestige.
• Il fournit un moteur de placeholders et prend en charge les placeholders pour les messages et les GUIs.
• Le plugin expose des nœuds de permission explicites pour les commandes ainsi qu’une permission administrative pour refléter l’accès OP.
• Le code source est publié sous GPL-3.0.

🤝 Quand ce plugin est utile

Si vous avez besoin d’une échelle de rang configurable et sensible aux permissions, avec prise en charge de GUI et de prestige, Rankup centralise les définitions de rang et les règles d’avancement pour automatiser la progression des joueurs sans promotions manuelles.