Minecraft-Plugin PvPManager

🔌 Über PvPManager

PvPManager ist ein Minecraft-Plugin zur Verwaltung von Spieler-gegen-Spieler-Verhalten und kampfbezogenen Serverregeln. Es vereint PvP-Umschalter, Combat-Tagging, Schutz vor Combat-Logging, Anfängerschutz und mehrere Verhaltensweisen bei Kill/Respawn in einem einzigen konfigurierbaren Plugin für Server-Administratoren.

🎯 Zweck

Der Hauptzweck von PvPManager besteht darin, zentrale, konfigurierbare Kontrollen für PvP-Interaktionen und kampfbezogene Sonderfälle bereitzustellen, damit Serverbetreiber einheitliche Regeln durchsetzen können (PvP umschalten, Combat-Logging bestrafen, Neulinge schützen, Belohnungen/Strafen bei Kills steuern und Kampf-Einschränkungen verwalten).

⚙️ Funktionen

• PvP pro Spieler, pro Welt oder global umschalten.
• Combat-Tag-System mit konfigurierbaren Timern und visuellen Anzeigen (Action Bar/Boss Bar).
• Schutz vor Combat-Logging mit konfigurierbaren Strafen (Inventar fallen lassen, Rüstung/XP fallen lassen, Geldstrafe, Spieler töten, Ereignisse im Chat/Log ankündigen).
• Anfängerschutz sowie Schutz beim Respawn/Teleport.
• Anti Border-Hopping (verhindert das Fliehen in sichere Zonen, solange man markiert ist) und Anti-Kill-Abuse-Auslöser.
• Aktionen während des Kampfes deaktivieren (Fliegen, Gamemode-Wechsel, Befehle, Enderperlen, Blöcke platzieren usw.).
• Inventar-Behandlungsoptionen (behalten, fallen lassen oder Drops an den Killer übertragen) und Auto-Soup-Support.
• Geldbelohnungen/-strafen und ausführbare Befehle beim Kill.
• Integrationen mit PlaceholderAPI sowie Unterstützung für Zonen-Plugins (WorldGuard, Towny) und Citizens; optionale Integrationen für bestimmte Verhaltensweisen.
• Telemetrie und Nutzungsberichte über bStats.

🧩 Für wen es ist

• Survival- und SMP-Server, die konfigurierbare PvP-Regeln brauchen.
• Server, die Schutz vor Combat Logging und sichere Einführung für Neulinge benötigen.
• Administratoren, die integrierte Regeln für Kills/Belohnungen und einfache PvP-Umschalter ohne mehrere separate Plugins wollen.

🏗️ Beispielanwendungen

• Anfängerschutz für erste Spielsessions aktivieren und PvP erst nach einer konfigurierbaren Zeit erlauben.
• Spieler im Kampf markieren und verhindern, dass sie Teleports oder Befehle nutzen oder sichere Zonen betreten, bis die Markierung abläuft.
• Spieler bestrafen, die sich während des Kampfes trennen, indem ihr Inventar fallen gelassen oder eine vom Server definierte Strafe angewendet wird.
• Kills automatisch mit Geld belohnen oder bei einem Kill benutzerdefinierte Befehle ausführen.

⌨️ Befehle

Hinweise: Die aufgeführten Befehle stammen aus der offiziellen Plugin-Dokumentation und der Ressourcenseite. Die Berechtigungsknoten für jeden Befehl sind vom Projekt dokumentiert, werden hier aber nicht wiedergegeben.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR von der Distributionsseite des Plugins für deine Plattform herunter.
• Lege die JAR in das Verzeichnis plugins/ des Servers auf einem mit Spigot/Paper kompatiblen Server.
• Starte den Server neu und prüfe die Konsolenlogs, um zu bestätigen, dass das Plugin geladen wurde.

📦 Abhängigkeiten

• PlaceholderAPI (optionale Integration für Platzhalter).
• Verfügbare Integrationen für Zonen- und NPC-Plugins wie WorldGuard, Towny und Citizens (optional, werden bei Vorhandensein genutzt).

🧠 Technische Hinweise

• Zu den bestätigten unterstützten Server-Softwares gehören Spigot und Paper; Folia-Unterstützung ist ebenfalls vom Projekt aufgeführt.
• Das Plugin bietet eine Entwickler-API und veröffentlicht Dev-Builds zum Testen.
• Das Projekt veröffentlicht Quellcode und Issue-Tracking in seinem öffentlichen Repository und nutzt bStats für Telemetrie.
• Die getesteten Minecraft-Versionen umfassen viele Releases; Serverbetreiber sollten die Dokumentation des Plugins für die genaue Kompatibilität mit einer bestimmten Serverversion konsultieren.

🤝 Wann dieses Plugin nützlich ist

PvPManager ist nützlich, wenn du ein einziges, konfigurierbares Plugin brauchst, um PvP-Umschalter, Combat-Tagging, Strafen für Combat-Logging und Anfängerschutz zu verwalten, ohne mehrere separate Plugins zusammenzustellen. Es zentralisiert gängige PvP-Regeln und bietet Admin-Befehle sowie Integrationen, um das Verhalten an unterschiedliche Server-Setups anzupassen.