Minecraft-plugin Rankup

🔌 Om Rankup

Rankup är ett Minecraft Bukkit/Spigot-plugin som implementerar ett konfigurerbart progressionssystem med en rankstege. Det erbjuder ett GUI för att bläddra bland ranksteg, en flexibel kravmotor för att styra när spelare kan gå vidare, och ett prestige-system för upprepad progression. Pluginet är avsett för serveradministratörer som vill ha ett automatiserat, konfigurerbart sätt att befordra spelare genom rangen.

🎯 Syfte

Rankup löser problemet med att hantera spelarnas progression (rankstegar) utan manuell befordran. Det samlar rangdefinitioner, krav för avancemang och valfria prestige-mekanismer så att serverägare kan definiera flerstegsprogressioner kopplade till permissions och anpassade krav.

⚙️ Funktioner

• Konfigurerbar rankstege definierad i rankups.yml.
• GUI för att spelare ska kunna se och bekräfta rankups.
• Kravsystem för att definiera villkor för varje ranksteg (t.ex. permissions, speltid, tokens/värden som tillhandahålls av kravplugins).
• Stöd för prestige med en separat prestiges.yml.
• Kommandon för att lista rangen, utföra enstegs- eller flerstegs-rankups och ladda om konfigurationen.
• Stöd för placeholders via pluginets placeholder-motor för meddelanden och GUI.
• Åtkomstkontroll baserad på permissions för kommandon och administrativa funktioner.

🧩 Vem det är för

• Survival / SMP-servrar som använder progression eller rankstegar.
• Prison- eller economy-servrar som erbjuder stegvisa befordringssystem.
• Serveradmins som vill ha permission-styrd rankprogression med GUI-stöd.

🏗️ Exempel på användning

• Definiera en sekvens av ranker som automatiskt kräver ökande speltid eller föremål innan en spelare får gå vidare.
• Använd prestige för att återställa en spelares rank samtidigt som särskilda belöningar eller progressionsräknare delas ut.
• Integrera med ett permissions-plugin för att ge eller ta bort rankrelaterade permission nodes när en spelare avancerar.

⌨️ Kommandon

🔐 Permissions

⚙️ Installation

📥 Setup

• Ladda ner pluginets JAR från den officiella distributionen eller bygg från källkod.
• Placera JAR-filen i serverns plugins/-katalog.
• Starta eller starta om servern och kontrollera konsolutmatningen för att bekräfta att pluginet laddades.
• Använd de medföljande konfigurationsfilerna (rankups.yml, prestiges.yml, locale/config) och det medföljande reload-kommandot för att tillämpa ändringar under drift.

📦 Bygg från källkod

• Projektet inkluderar en Gradle wrapper; kör den medföljande gradlew build för att skapa pluginets JAR i katalogen build/libs.

🧠 Tekniska noteringar

• Pluginet använder YAML-konfigurationsfiler (särskilt rankups.yml och prestiges.yml) för definitioner av rank och prestige.
• Det tillhandahåller en placeholder-motor och stöder placeholders för användning i meddelanden och GUI.
• Pluginet exponerar tydliga permission nodes för kommandon och en administrativ permission för att spegla OP-åtkomst.
• Källkoden publiceras under GPL-3.0.

🤝 När detta plugin är användbart

Om du behöver en konfigurerbar, permission-medveten rankstege med GUI- och prestige-stöd, centraliserar Rankup rangdefinitioner och avancemangsregler för att automatisera spelarnas progression utan manuella befordringar.