Plugin Minecraft SkinsRestorer

🔌 O SkinsRestorer

SkinsRestorer to wtyczka Minecraft do przywracania i zarządzania skinami graczy na serwerach online-mode i offline-mode. Zapewnia komendy w grze, GUI, buforowanie oraz funkcje niestandardowych skinów, dzięki czemu serwery mogą niezawodnie stosować i zmieniać skiny graczy nawet wtedy, gdy zewnętrzne usługi skinów są niedostępne.

🎯 Cel

SkinsRestorer rozwiązuje problem brakujących lub domyślnych skinów (Steve/Alex) na serwerach, szczególnie na serwerach offline/cracked lub dużych sieciach, gdzie wymagane jest natychmiastowe lub buforowane zastosowanie skinów. Jest skierowany do administratorów serwerów, którzy potrzebują spójnej obsługi skinów dla graczy i proxy.

⚙️ Funkcje

• Zastosowanie skina konta gracza po dołączeniu lub użycie domyślnych/niestandardowych skinów dla graczy bez premium.
• Komenda /skin dla graczy (w tym generowanie skinów na podstawie URL) oraz GUI do przeglądania/wybierania skinów.
• Obsługa niestandardowych skinów (upload / skiny z URL) i tworzenie niestandardowych skinów dla całego serwera.
• Buforowanie i żądania Mojang/MineSkin z uwzględnieniem limitów, aby zwiększyć niezawodność na dużych sieciach.
• Opcje konfiguracji dotyczące ograniczeń skinów, uprawnień per skin, zachowania domyślnego skina i ustawień GUI.
• Działanie z uwzględnieniem proxy oraz opcje konfiguracji specyficzne dla backendu/proxy.

🧩 Dla kogo

• Serwery Survival i SMP, które chcą niezawodnego wyświetlania skinów.
• Serwery offline-mode lub cracked, które potrzebują wsparcia kosmetycznego dla graczy bez premium.
• Sieci korzystające z proxy lub wielu serwerów backend, które potrzebują buforowanego lub spójnego działania skinów.

🏗️ Przykładowe zastosowania

• Prywatny serwer offline pozwala graczom zmieniać skiny przez /skin <name> bez posiadania konta Mojang.
• Sieć buforuje skiny, aby wygląd graczy pozostawał stabilny, gdy nadrzędne usługi skinów działają wolno lub są niedostępne.
• Administrator ustawia domyślny zestaw skinów dla nowych lub niepremiumowych graczy przez konfigurację.

⌨️ Komendy

(Uwaga: rejestrację komend można przełączać w konfiguracji; dokładne węzły uprawnień dla wielu komend są opisane w przewodniku po komendach i uprawnieniach wtyczki.)

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR wtyczki ze strony wydań projektu.
• Umieść plik JAR w katalogu plugins/ swojego serwera na backendzie zgodnym ze Spigot/Paper (lub w odpowiedniej konfiguracji proxy/backend, gdy używasz proxy).
• Uruchom lub zrestartuj serwer i sprawdź konsolę, aby potwierdzić, że SkinsRestorer został załadowany.

📦 Zależności

• Obsługiwana jest opcjonalna integracja z MineSkin (można skonfigurować klucz API, aby przyspieszyć generowanie skinów). W oficjalnej dokumentacji nie wymieniono innych wymaganych zależności wtyczek.

🧾 Konfiguracja

• Wtyczka używa konfiguracji YAML z opcjami dla domyślnych skinów, cooldownów komend, kart GUI, uprawnień per skin, ustawień proxy/backendu i buforowania.
• Klucze konfiguracji obejmują flagi takie jak forceDefaultPermissions, perSkinPermissions, disableSkinCommand i enablePaperJoinListener (używane do poprawy natychmiastowego stosowania skinów na Paper).

🧠 Uwagi techniczne

• Obsługuje konfiguracje uwzględniające proxy (backend vs proxy) i ma opcje wykrywania trybu proxy.
• Zapewnia buforowanie i grupowanie żądań, aby uniknąć limitów API podczas kontaktu z Mojang lub zewnętrznymi usługami skinów.
• Konfiguracja udostępnia obsługę klucza API MineSkin dla opcjonalnie szybszego/zarządzanego generowania skinów.
• Projekt jest open source i utrzymywany z wydaniami na GitHubie oraz dokumentacją dostępną na oficjalnej stronie dokumentacji.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli potrzebujesz spójnej, konfigurowalnej obsługi skinów dla graczy na serwerach online/offline lub sieciach proxy — w tym niestandardowych skinów, skinów z URL i buforowania, aby przetrwać awarie zewnętrznych usług — SkinsRestorer oferuje wyspecjalizowane narzędzia i konfigurację, aby niezawodnie zarządzać tymi potrzebami.