Minecraft-plugin PvPManager

🔌 Om PvPManager

PvPManager er et Minecraft-plugin til at styre player-versus-player-adfærd og serverregler relateret til combat. Det kombinerer PvP-toggles, combat tagging, forebyggelse af combat-log, beskyttelse af nye spillere og flere kill/respawn-begivenheder i ét konfigurerbart plugin, der er rettet mod serveradministratorer.

🎯 Formål

PvPManagers kerneformål er at give centraliserede, konfigurerbare kontroller til PvP-interaktioner og combat-relaterede edge cases, så serverejere kan håndhæve ensartede regler (slå PvP til/fra, straffe combat logging, beskytte nytilkomne, styre belønninger/straffe ved kills og håndtere combat-restriktioner).

⚙️ Funktioner

• Slå PvP til/fra for den enkelte spiller, for en verden eller globalt.
• Combat tag-system med konfigurerbare timere og visuelle indikatorer (action bar/boss bar).
• Forebyggelse af combat-log med konfigurerbare straffe (drop inventory, drop armor/exp, pengebøde, dræb spilleren, broadcast/log events).
• Beskyttelse af begyndere og beskyttelse ved respawn/teleport.
• Anti border-hopping (forhindrer flugt til sikre zoner, mens man er tagged) og anti kill-abuse triggers.
• Deaktiver handlinger under combat (fly, gamemode-ændringer, commands, enderpearls, placering af blokke osv.).
• Muligheder for inventory-håndtering (behold, drop eller overfør drops til killer) samt support for auto-soup.
• Pengebelønninger/-straffe og commands, der kan køres ved kill.
• Integrationer med PlaceholderAPI og support til zoneplugins (WorldGuard, Towny) og Citizens; valgfrie integrationer til specifikke funktioner.
• Telemetri og brugsrapportering via bStats.

🧩 Hvem er det til

• Survival- og SMP-servere, der har brug for konfigurerbare PvP-regler.
• Servere, der kræver beskyttelse mod combat logging og sikker onboarding for nye spillere.
• Administratorer, der ønsker integrerede kill/reward-regler og simple PvP-toggles uden flere separate plugins.

🏗️ Eksempler på brug

• Aktivér beskyttelse af nye spillere i de første spilletimer og tillad først PvP efter en konfigurerbar tid.
• Tag spillere under combat og forhindre dem i at bruge teleports, commands eller gå ind i sikre zoner, indtil taggen udløber.
• Straff spillere, der logger af under combat, ved at få dem til at droppe inventory eller anvende en serverdefineret straf.
• Beløn automatisk killeres med penge eller kør tilpassede commands ved kill.

⌨️ Commands

Noter: de nævnte commands er taget fra den officielle plugin-dokumentation og resource-siden. Permission nodes for hver command er dokumenteret af projektet, men gengives ikke her.

⚙️ Installation

📥 Opsætning

• Download den officielle plugin-JAR fra distributionssiden for din platform.
• Læg JAR-filen i mappen plugins/ på en Spigot/Paper-kompatibel server.
• Genstart serveren og tjek console logs for at bekræfte, at pluginet blev indlæst.

📦 Afhængigheder

• PlaceholderAPI (valgfri integration til placeholders).
• Integrationer findes til zone- og NPC-plugins som WorldGuard, Towny og Citizens (valgfrit, bruges når de er til stede).

🧠 Tekniske noter

• Bekræftet understøttet serversoftware omfatter Spigot og Paper; støtte til Folia er også angivet af projektet.
• Pluginet tilbyder et developer API og udgiver dev builds til test.
• Projektet offentliggør source code og issue tracking i sit offentlige repository og bruger bStats til telemetri.
• Testede Minecraft-versioner spænder over mange releases; serverejere bør se pluginets dokumentation for præcis kompatibilitet med en bestemt serverversion.

🤝 Hvornår dette plugin er nyttigt

PvPManager er nyttigt, når du har brug for ét konfigurerbart plugin til at håndtere PvP-toggles, combat tagging, combat-log-straffe og beskyttelse af nye spillere uden at samle flere separate plugins. Det centraliserer almindelige PvP-regler og giver admin-commands samt integrationer, der kan tilpasses forskellige serveropsætninger.