Minecraft-Plugin DeathMessages

🔌 Über DeathMessages

DeathMessages ist ein Minecraft-Plugin zum Ersetzen und Anpassen der eingebauten Todesnachrichten des Spiels. Es lädt konfigurierbare Nachrichtenvorlagen für Spieler-, Mob-, zähmbare und natürliche Tode und sendet Textkomponenten-Nachrichten (mit Hover-/Klick-Komponenten) statt der normalen Strings.

🎯 Zweck

Das Plugin soll Server-Administratoren die Kontrolle darüber geben, wie Todesinformationen für Spieler angezeigt werden: Formulierungen ändern, Platzhalter verwenden, Farben und Hover-/Klick-Daten hinzufügen, Ausgaben nach Welt oder Region einschränken und mit anderen Serversystemen integrieren (Platzhalter, Discord, MythicMobs).

⚙️ Funktionen

• Vollständiger Ersatz der normalen Todesnachrichten durch konfigurierbare Vorlagen.
• Unterstützung für Textkomponenten (Hover-Text, Klick-Aktionen) und Hex-Farbcodes.
• Mehrere Konfigurationsdateien mit vielen anpassbaren Nachrichten pro Schadensart.
• Nachrichten pro Welt und eine Liste deaktivierter Welten.
• WorldGuard-Regionsflags zum Unterdrücken bestimmter Todesnachrichtentypen (Spieler, Mobs, natürlich, zähmbar), wenn aktiviert.
• PlaceholderAPI-Integration: Das Plugin stellt eine Reihe von Platzhaltern für Opfer, Killer und Plugin-Status bereit.
• Optionale Hooks für MythicMobs und DiscordSRV (konfigurationsgesteuert).
• Bungee/Proxy-Unterstützung für globale Nachrichten.
• Gibt API-Events aus (BroadcastDeathMessageEvent, BroadcastTameableDeathMessageEvent) und stellt eine PlayerManager-Utility-Klasse bereit.
• Konfigurierbare Event-Priorität und Gang-Kill-Erkennung für gruppierte Mob-Kills.

🧩 Für wen es ist

• Survival-/SMP-Server, die benutzerdefinierte oder thematische Todesnachrichten wollen.
• Server, die Platzhalter oder externe Systeme (DiscordSRV, MythicMobs) nutzen und ein einheitliches Nachrichtenformat benötigen.
• Server, die eine welt- oder regionsbasierte Kontrolle über Nachrichten-Broadcasts brauchen.

🏗️ Beispielanwendungen

• Standard-Todeszeilen durch thematische oder Rollenspiel-ähnliche Nachrichten mit Hex-Farben und Hover-Text ersetzen.
• PlaceholderAPI-Werte (Name des Opfers, Name des Killers, letzter Ort) in Todesvorlagen verwenden.
• Verhindern, dass Todesnachrichten in durch WorldGuard geschützten Regionen angezeigt werden.
• Todesereignisse über DiscordSRV-Hooks an einen Discord-Kanal senden.

⌨️ Befehle

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die offizielle .jar-Datei des Plugins herunter und lege sie in den plugins/-Ordner deines Servers.
• Starte den Server neu und prüfe die Konsolenlogs, um zu bestätigen, dass das Plugin geladen wurde.
• Auf der Plugin-Seite wird erwähnt, dass Paper gegenüber Spigot empfohlen wird.

📦 Abhängigkeiten

• Vom Autor erwähnte optionale Integrationen: PlaceholderAPI, WorldGuard, MythicMobs, DiscordSRV. Diese Hooks sind optional und für den grundlegenden Nachrichtenersatz nicht zwingend erforderlich.

🧠 Technische Hinweise

• Das Plugin stellt API-Events bereit (BroadcastDeathMessageEvent und BroadcastTameableDeathMessageEvent) und bietet eine PlayerManager-Utility für Plugin-Autoren.
• Die Event-Priorität ist über die Einstellungen konfigurierbar; das Plugin kann mit einer gewählten PlayerDeathEvent-Priorität arbeiten.
• Unterstützt mehrere große Minecraft-Versionen (auf der offiziellen Ressourcenseite ausdrücklich über 1.12 bis 1.21 getestet).

🤝 Wann dieses Plugin nützlich ist

Wenn du präzise Kontrolle darüber brauchst, wie Todesinformationen den Spielern angezeigt werden (eigene Formulierungen, Platzhalter, welt- oder regionsbasierte Regeln und Integrationen), bietet DeathMessages konfigurierbare Vorlagen und Hooks und stellt gleichzeitig Events für weitere Erweiterungen bereit.