Serwery Minecraft z pluginem 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 | **Komenda** | **Opis** | **Uprawnienie** | **Dostęp** | |---|---|---|---| | `/skin <skin>` | Ustawia skin gracza na nazwany skin lub skin konta. | (zobacz uprawnienia) | Player | | `/skin url "<url>"` | Generuje/stosuje skin z zewnętrznego adresu URL obrazu. | (zobacz uprawnienia) | Player | | `/skull` | Tworzy lub pobiera głowy graczy (rejestrację komendy można wyłączyć). | nie określono | Player | | `/skins` | Otwiera GUI skinów (rejestrację komendy można wyłączyć). | nie określono | Player | | `/sr createcustom` | Tworzy niestandardowy wpis skinu serwera (akcja na poziomie administratora). | nie określono | Admin | (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 | **Uprawnienie** | **Opis** | **Domyślne** | |---|---|---| | `skinsrestorer.player` | Podstawowe uprawnienie przyznawane graczom do korzystania z funkcji skinów (może być wymuszone w konfiguracji). | true | | `skinsrestorer.skin.<name>` | Uprawnienie per skin wymagane, gdy `perSkinPermissions` jest włączone dla konkretnych skinów. | nie określono | ## ⚙️ 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.

Pluginy