Plugin Minecraft DeathMessages

🔌 O DeathMessages

DeathMessages to plugin do Minecrafta służący do zastępowania i dostosowywania wbudowanych wiadomości o śmierci w grze. Wczytuje konfigurowalne szablony wiadomości dla śmierci graczy, mobów, oswajalnych stworzeń i śmierci naturalnych, a następnie wysyła wiadomości jako komponenty tekstowe (z komponentami hover/click) zamiast domyślnych stringów.

🎯 Cel

Plugin istnieje po to, aby administratorzy serwera mogli kontrolować, jak informacje o śmierci są pokazywane graczom: zmieniać treść, używać placeholderów, dodawać kolory i dane hover/click, ograniczać transmisję według świata lub regionu oraz integrować się z innymi systemami serwera (placeholdery, Discord, MythicMobs).

⚙️ Funkcje

• Pełne zastąpienie domyślnych wiadomości o śmierci konfigurowalnymi szablonami.
• Obsługa komponentów tekstowych (tekst hover, akcje kliknięcia) i kodów kolorów hex.
• Wiele plików konfiguracyjnych z dużą liczbą personalizowanych wiadomości dla każdego typu obrażeń.
• Wiadomości per świat i lista wyłączonych światów.
• Flagi regionów WorldGuard do ukrywania określonych typów wiadomości o śmierci (gracz, moby, naturalna, oswajalna) po włączeniu.
• Integracja z PlaceholderAPI: plugin udostępnia zestaw placeholderów dla ofiary, zabójcy i stanu pluginu.
• Opcjonalne hooki dla MythicMobs i DiscordSRV (sterowane konfiguracją).
• Obsługa Bungee/Proxy dla globalnych wiadomości.
• Emituje zdarzenia API (BroadcastDeathMessageEvent, BroadcastTameableDeathMessageEvent) i udostępnia klasę narzędziową PlayerManager.
• Konfigurowalny priorytet zdarzeń i wykrywanie gang-kill dla grupowych zabójstw mobów.

🧩 Dla kogo

• Serwery Survival / SMP, które chcą własnych lub tematycznych wiadomości o śmierci.
• Serwery używające placeholderów lub systemów zewnętrznych (DiscordSRV, MythicMobs), które potrzebują spójnego formatowania wiadomości.
• Serwery wymagające kontroli wiadomości per świat lub per region.

🏗️ Przykłady zastosowań

• Zastąpienie domyślnych linii śmierci wiadomościami tematycznymi lub w stylu roleplay z użyciem kolorów hex i tekstu hover.
• Używanie wartości PlaceholderAPI (nazwa ofiary, nazwa zabójcy, ostatnia lokalizacja) w szablonach śmierci.
• Zapobieganie wyświetlaniu wiadomości o śmierci w regionach chronionych przez WorldGuard.
• Wysyłanie zdarzeń śmierci do kanału Discord za pomocą hooków DiscordSRV.

⌨️ Komendy

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik .jar pluginu i umieść go w folderze plugins/ na serwerze.
• Uruchom ponownie serwer i sprawdź logi konsoli, aby potwierdzić, że plugin został załadowany.
• Na stronie pluginu zaznaczono, że Paper jest zalecany zamiast Spigota.

📦 Zależności

• Opcjonalne integracje wspomniane przez autora: PlaceholderAPI, WorldGuard, MythicMobs, DiscordSRV. Są to opcjonalne hooki i nie są bezwzględnie wymagane do podstawowej zamiany wiadomości.

🧠 Uwagi techniczne

• Plugin udostępnia zdarzenia API (BroadcastDeathMessageEvent i BroadcastTameableDeathMessageEvent) oraz klasę narzędziową PlayerManager dla autorów pluginów.
• Priorytet zdarzeń można skonfigurować w ustawieniach; plugin może działać z wybranym priorytetem PlayerDeathEvent.
• Obsługuje wiele głównych wersji Minecrafta (oficjalna strona zasobu podaje testy od 1.12 do 1.21).

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz precyzyjnej kontroli nad tym, jak informacje o śmierci są pokazywane graczom (własna treść, placeholdery, reguły per świat lub per region oraz integracje), DeathMessages oferuje konfigurowalne szablony i hooki, a jednocześnie udostępnia zdarzenia do dalszej rozbudowy.