Minecraft-plugin Rankup

🔌 Om Rankup

Rankup er et Minecraft Bukkit/Spigot-plugin, der implementerer et konfigurerbart progressionssystem med en rangstige. Det giver en GUI til at gennemse rangtrin, en fleksibel kravmotor til at styre, hvornår spillere kan avancere, og et prestige-system til gentagen progression. Pluginet er lavet til serveradministratorer, der vil have en automatisk og konfigurerbar måde at forfremme spillere gennem ranger.

🎯 Formål

Rankup løser problemet med at administrere spillerprogression (rangstiger) uden manuel forfremmelse. Det samler rangdefinitioner, krav til avancement og valgfrie prestige-mekanikker, så serverejere kan definere flertrins-progressionsforløb koblet til permissions og egne krav.

⚙️ Funktioner

• Konfigurerbar rangstige defineret i rankups.yml.
• GUI, så spillere kan se og bekræfte rankups.
• Kravsystem til at definere betingelser for hvert rangtrin (f.eks. permissions, spilletid, tokens/værdier leveret af krav-plugins).
• Prestige-support med en separat prestiges.yml.
• Commands til at vise ranglisten, udføre rankups i ét eller flere trin og genindlæse konfigurationen.
• Placeholder-support via pluginets placeholder-motor til beskeder og GUI'er.
• Permission-baseret adgangskontrol til commands og administrative funktioner.

🧩 Hvem det er til

• Survival / SMP-servere, der bruger progression eller rangstiger.
• Prison- eller economy-servere, der tilbyder trinvise forfremmelsessystemer.
• Serveradmins, der ønsker permission-styret rangavancement med GUI-support.

🏗️ Eksempler på brug

• Definér en række ranger, der automatisk kræver mere spilletid eller flere items, før en spiller må avancere.
• Brug prestige til at nulstille en spillers rang og samtidig give særlige belønninger eller progressions-tællere.
• Integrér med et permissions-plugin for at give eller fjerne rank-relaterede permission nodes, når en spiller avancerer.

⌨️ Commands

🔐 Permissions

⚙️ Installation

📥 Setup

• Download pluginets JAR fra den officielle distribution eller byg fra source.
• Læg JAR-filen i serverens plugins/-mappe.
• Start eller genstart serveren, og tjek konsoloutputtet for at bekræfte, at pluginet blev indlæst.
• Brug de medfølgende konfigurationsfiler (rankups.yml, prestiges.yml, locale/config) og den medfølgende reload-kommando til at anvende ændringer under drift.

📦 Build from source

• Projektet inkluderer en Gradle wrapper; kør den medfølgende gradlew build for at producere pluginets JAR i mappen build/libs.

🧠 Tekniske noter

• Pluginet bruger YAML-konfigurationsfiler (især rankups.yml og prestiges.yml) til definitioner af rank og prestige.
• Det tilbyder en placeholder-motor og understøtter placeholders til brug i beskeder og GUI'er.
• Pluginet eksponerer eksplicitte command permission nodes og en administrativ permission for at afspejle OP-adgang.
• Kildekoden er udgivet under GPL-3.0.

🤝 Hvornår dette plugin er nyttigt

Hvis du har brug for en konfigurerbar, permission-bevidst rangstige med GUI- og prestige-support, samler Rankup rangdefinitioner og avancementsregler for at automatisere spillerprogression uden manuel forfremmelse.