Minecraft plugin PvPManager

🔌 Over PvPManager

PvPManager is een Minecraft-plugin voor het beheren van player-versus-player-gedrag en serverregels die met combat te maken hebben. Het combineert PvP-toggles, combat tagging, het voorkomen van combat-log, bescherming voor nieuwelingen en verschillende kill/respawn-gedragingen in één configureerbare plugin, gericht op serverbeheerders.

🎯 Doel

Het hoofddoel van PvPManager is om gecentraliseerde, configureerbare controle te bieden over PvP-interacties en randgevallen rond combat, zodat servereigenaren consistente regels kunnen afdwingen (PvP aan/uit zetten, combat logging bestraffen, nieuwkomers beschermen, beloningen/straffen bij kills beheren en combat-beperkingen instellen).

⚙️ Functies

• PvP per speler, per wereld of globaal in- en uitschakelen.
• Combat-tagsysteem met configureerbare timers en visuele indicatoren (action bar/boss bar).
• Voorkomen van combat-log met configureerbare straffen (inventory droppen, armor/exp droppen, geldboete, speler doden, events broadcasten/loggen).
• Bescherming voor nieuwelingen en bescherming bij respawn/teleport.
• Anti border-hopping (voorkomt vluchten naar veilige zones terwijl je tagged bent) en anti kill-abuse triggers.
• Acties uitschakelen tijdens combat (vliegen, gamemode-wissels, commands, enderpearls, blocks plaatsen, enz.).
• Opties voor inventory-afhandeling (houden, droppen of drops doorgeven aan de killer) en ondersteuning voor auto-soup.
• Geldbeloningen/straffen en uitvoerbare commands bij kills.
• Integraties met PlaceholderAPI en ondersteuning voor zoneplugins (WorldGuard, Towny) en Citizens; optionele integraties voor specifieke gedragingen.
• Telemetrie en gebruiksrapportage via bStats.

🧩 Voor wie is het

• Survival- en SMP-servers die configureerbare PvP-regels nodig hebben.
• Servers die bescherming tegen combat logging en veilige onboarding voor nieuwelingen vereisen.
• Beheerders die geïntegreerde kill/reward-regels en eenvoudige PvP-toggles willen zonder meerdere aparte plugins.

🏗️ Voorbeeldtoepassingen

• Bescherming voor nieuwelingen inschakelen voor de eerste speeltijd en PvP pas toestaan na een configureerbare tijd.
• Spelers taggen tijdens combat en voorkomen dat ze teleports, commands of veilige zones gebruiken totdat de tag verloopt.
• Spelers straffen die tijdens combat disconnecten door hun inventory te laten droppen of een servergedefinieerde straf toe te passen.
• Killers automatisch geld geven of aangepaste commands uitvoeren bij een kill.

⌨️ Commands

Opmerkingen: de genoemde commands zijn afkomstig uit de officiële plugin-documentatie en resourcepagina. Permission nodes voor elk command zijn gedocumenteerd door het project, maar hier niet weergegeven.

⚙️ Installatie

📥 Setup

• Download de officiële plugin-JAR van de distributiepagina voor jouw platform.
• Plaats de JAR in de plugins/-map op een Spigot/Paper-compatibele server.
• Herstart de server en controleer de consolelogs om te bevestigen dat de plugin geladen is.

📦 Afhankelijkheden

• PlaceholderAPI (optionele integratie voor placeholders).
• Integraties beschikbaar voor zone- en NPC-plugins zoals WorldGuard, Towny en Citizens (optioneel, gebruikt wanneer aanwezig).

🧠 Technische notities

• Bevestigde ondersteunde serversoftware omvat Spigot en Paper; Folia-ondersteuning staat ook vermeld door het project.
• De plugin biedt een developer API en publiceert dev builds voor testdoeleinden.
• Het project publiceert broncode en issue-tracking in de openbare repository en gebruikt bStats voor telemetrie.
• Geteste Minecraft-versies bestrijken veel releases; servereigenaren moeten de documentatie van de plugin raadplegen voor exacte compatibiliteit met een specifieke serverversie.

🤝 Wanneer deze plugin nuttig is

PvPManager is nuttig wanneer je één configureerbare plugin nodig hebt om PvP-toggles, combat tagging, combat-log-straffen en bescherming voor nieuwelingen te regelen zonder meerdere aparte plugins samen te stellen. Het centraliseert gangbare PvP-regels en biedt admin-commands en integraties om het gedrag aan te passen aan verschillende serveropstellingen.