Plugin Minecraft PvPManager

🔌 O PvPManager

PvPManager to plugin do Minecrafta służący do zarządzania walką gracz kontra gracz oraz zasadami serwera związanymi z combatem. Łączy przełączanie PvP, combat tagging, ochronę przed combat-logiem, ochronę nowych graczy i różne zachowania przy zabiciu/respawnie w jednym konfigurowalnym pluginie przeznaczonym dla administratorów serwera.

🎯 Cel

Głównym celem PvPManagera jest zapewnienie scentralizowanych, konfigurowalnych narzędzi do interakcji PvP i wyjątków związanych z combatem, aby właściciele serwerów mogli egzekwować spójne zasady (włączanie/wyłączanie PvP, karanie za combat logging, ochrona nowych graczy, kontrola nagród/kar za zabójstwa oraz zarządzanie ograniczeniami w walce).

⚙️ Funkcje

• Przełączanie PvP dla pojedynczego gracza, świata lub globalnie.
• System combat tag z konfigurowalnymi timerami i wskaźnikami wizualnymi (action bar/boss bar).
• Ochrona przed combat-logiem z konfigurowalnymi karami (wypadanie ekwipunku, zrzut zbroi/exp, kara finansowa, zabicie gracza, ogłaszanie/logowanie zdarzeń).
• Ochrona nowych graczy oraz ochrona przy respawnie/teleporcie.
• Anti border-hopping (uniemożliwia ucieczkę do bezpiecznych stref podczas oznaczenia) i wyzwalacze anti kill-abuse.
• Blokowanie działań podczas walki (latanie, zmiana gamemode, komendy, enderpearls, stawianie bloków itd.).
• Opcje obsługi ekwipunku (zachowanie, zrzut lub przekazanie dropów zabójcy) oraz wsparcie auto-soup.
• Nagrody/kary finansowe i wykonywalne komendy po zabójstwie.
• Integracje z PlaceholderAPI oraz obsługa pluginów strefowych (WorldGuard, Towny) i Citizens; opcjonalne integracje dla konkretnych zachowań.
• Telemetria i raportowanie użycia przez bStats.

🧩 Dla kogo

• Serwery Survival i SMP, które potrzebują konfigurowalnych zasad PvP.
• Serwery wymagające ochrony przed combat loggingiem i bezpiecznego wdrożenia nowych graczy.
• Administratorzy, którzy chcą zintegrowanych zasad nagród/kar za zabójstwa i prostego przełączania PvP bez wielu osobnych pluginów.

🏗️ Przykładowe zastosowania

• Włączenie ochrony nowych graczy podczas pierwszych sesji i zezwolenie na PvP dopiero po czasie ustawionym w konfiguracji.
• Oznaczanie graczy w walce i blokowanie im teleportów, komend oraz wejścia do bezpiecznych stref do czasu wygaśnięcia taga.
• Karanie graczy, którzy rozłączają się podczas walki, poprzez zrzucenie ekwipunku lub zastosowanie kary zdefiniowanej przez serwer.
• Automatyczne nagradzanie zabójców pieniędzmi lub wykonywanie własnych komend po zabiciu.

⌨️ Komendy

Uwagi: wymienione komendy pochodzą z oficjalnej dokumentacji pluginu oraz strony zasobu. Node’y uprawnień dla każdej komendy są opisane przez projekt, ale nie zostały tu powtórzone.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik JAR pluginu ze strony dystrybucji dla swojej platformy.
• Umieść plik JAR w katalogu plugins/ serwera na serwerze zgodnym ze Spigot/Paper.
• Uruchom ponownie serwer i sprawdź logi konsoli, aby potwierdzić, że plugin został załadowany.

📦 Zależności

• PlaceholderAPI (opcjonalna integracja dla placeholderów).
• Dostępne integracje dla pluginów strefowych i NPC, takich jak WorldGuard, Towny i Citizens (opcjonalne, używane gdy są obecne).

🧠 Uwagi techniczne

• Potwierdzone wspierane oprogramowanie serwerowe obejmuje Spigot i Paper; wsparcie dla Folii jest również wymienione przez projekt.
• Plugin udostępnia API dla deweloperów i publikuje buildy developerskie do testów.
• Projekt publikuje kod źródłowy i śledzenie zgłoszeń w swoim publicznym repozytorium oraz używa bStats do telemetrii.
• Testowane wersje Minecrafta obejmują wiele wydań; właściciele serwerów powinni sprawdzić dokumentację pluginu, aby uzyskać dokładną zgodność z konkretną wersją serwera.

🤝 Kiedy ten plugin jest przydatny

PvPManager jest przydatny, gdy potrzebujesz jednego, konfigurowalnego pluginu do obsługi przełączania PvP, combat tagów, kar za combat-log i ochrony nowych graczy bez składania wielu osobnych pluginów. Centralizuje typowe zasady PvP i zapewnia komendy administracyjne oraz integracje, aby dostosować działanie do różnych konfiguracji serwera.