Plugin Minecraft Rankup

🔌 O Rankup

Rankup to plugin Minecraft dla Bukkit/Spigot, który implementuje konfigurowalny system progresji po szczeblach rang. Udostępnia GUI do przeglądania etapów rang, elastyczny silnik wymagań do kontrolowania, kiedy gracze mogą awansować, oraz system prestige do wielokrotnej progresji. Plugin jest przeznaczony dla administratorów serwerów, którzy chcą zautomatyzowanego i konfigurowalnego sposobu awansowania graczy przez rangi.

🎯 Cel

Rankup rozwiązuje problem zarządzania postępem graczy (drabiną rang) bez ręcznego awansowania. Centralizuje definicje rang, wymagania awansu i opcjonalne mechaniki prestige, dzięki czemu właściciele serwerów mogą definiować wieloetapowe ścieżki powiązane z uprawnieniami i niestandardowymi wymaganiami.

⚙️ Funkcje

• Konfigurowalna drabina rang zdefiniowana w rankups.yml.
• GUI, dzięki któremu gracze mogą przeglądać i potwierdzać rankupy.
• System wymagań do definiowania warunków dla każdego etapu rangi (np. uprawnienia, czas gry, tokeny/wartości dostarczane przez pluginy wymagań).
• Obsługa prestige z osobnym prestiges.yml.
• Komendy do wyświetlania rang, wykonywania rankupów jedno- lub wieloetapowych oraz przeładowywania konfiguracji.
• Obsługa placeholderów poprzez silnik placeholderów pluginu dla wiadomości i GUI.
• Kontrola dostępu oparta na uprawnieniach dla komend i funkcji administracyjnych.

🧩 Dla kogo

• Serwery Survival / SMP korzystające z progresji lub drabin rang.
• Serwery Prison lub ekonomiczne, które udostępniają systemy awansowania oparte na etapach.
• Administratorzy serwerów, którzy chcą awansowania opartego na uprawnieniach z obsługą GUI.

🏗️ Przykładowe zastosowania

• Zdefiniowanie sekwencji rang, które automatycznie wymagają coraz większego czasu gry lub większej liczby przedmiotów, zanim gracz będzie mógł awansować.
• Używanie prestige do resetowania rangi gracza przy jednoczesnym przyznawaniu specjalnych nagród lub liczników postępu.
• Integracja z pluginem uprawnień w celu przyznawania lub usuwania węzłów uprawnień związanych z rangą, gdy gracz awansuje.

⌨️ Komendy

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR pluginu z dystrybucji pluginu (oficjalnego zasobu) albo zbuduj go ze źródeł.
• Umieść JAR w katalogu plugins/ swojego serwera.
• Uruchom lub zrestartuj serwer i sprawdź log konsoli, aby potwierdzić, że plugin został załadowany.
• Użyj dostarczonych plików konfiguracyjnych (rankups.yml, prestiges.yml, locale/config) oraz komendy przeładowania, aby zastosować zmiany w czasie działania.

📦 Budowanie ze źródeł

• Projekt zawiera Gradle wrapper; uruchom dołączone gradlew build, aby wygenerować plik JAR pluginu w katalogu build/libs.

🧠 Uwagi techniczne

• Plugin używa plików konfiguracyjnych YAML (zwłaszcza rankups.yml i prestiges.yml) do definicji rang i prestige.
• Udostępnia silnik placeholderów i obsługuje placeholdery używane w wiadomościach oraz GUI.
• Plugin wystawia jawne węzły uprawnień dla komend oraz uprawnienie administracyjne odzwierciedlające dostęp OP.
• Kod źródłowy jest opublikowany na licencji GPL-3.0.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnej, opartej na uprawnieniach drabiny rang z obsługą GUI i prestige, Rankup centralizuje definicje rang i zasady awansu, aby zautomatyzować progresję graczy bez ręcznych promocji.