Plugin Minecraft PvPManager

🔌 Despre PvPManager

PvPManager este un plugin Minecraft pentru gestionarea comportamentului player-versus-player și a regulilor de server legate de combat. Combină comutatoare PvP, combat tagging, prevenirea combat-log, protecția începătorilor și mai multe comportamente la kill/respawn într-un singur plugin configurabil, destinat administratorilor de servere.

🎯 Scopul

Scopul principal al PvPManager este să ofere controale centralizate și configurabile pentru interacțiunile PvP și cazurile speciale legate de combat, astfel încât proprietarii de servere să poată aplica reguli consecvente (activare/dezactivare PvP, pedepsirea combat logging-ului, protejarea noilor jucători, controlul recompenselor/penalizărilor la kill și gestionarea restricțiilor de combat).

⚙️ Funcții

• Activare/dezactivare PvP per jucător, per lume sau global.
• Sistem de combat tag cu temporizatoare configurabile și indicatori vizuali (action bar/boss bar).
• Prevenirea combat-log-ului cu pedepse configurabile (drop inventory, drop armor/exp, penalizare financiară, omorârea jucătorului, broadcast/log events).
• Protecție pentru începători și protecție la respawn/teleport.
• Anti border-hopping (împiedică fuga în zone sigure când ești tagged) și triggere anti kill-abuse.
• Dezactivarea acțiunilor în timpul combatului (fly, schimbări de gamemode, comenzi, ender pearls, plasarea blocurilor etc.).
• Opțiuni de gestionare a inventory-ului (păstrează, aruncă sau transferă dropurile către killer) și suport auto-soup.
• Recompense/penalizări financiare și comenzi executabile la kill.
• Integrări cu PlaceholderAPI și suport pentru pluginuri de zonă (WorldGuard, Towny) și Citizens; integrări opționale pentru comportamente specifice.
• Telemetrie și raportare a utilizării prin bStats.

🧩 Pentru cine este

• Servere Survival și SMP care au nevoie de reguli PvP configurabile.
• Servere care necesită protecție împotriva combat logging-ului și onboarding sigur pentru începători.
• Administratori care vor reguli integrate pentru kill/reward și comutatoare PvP simple fără mai multe pluginuri separate.

🏗️ Exemple de utilizare

• Activează protecția pentru începători în primele sesiuni de joc și permite PvP doar după un timp configurabil.
• Marchează jucătorii în combat și împiedică-i să folosească teleporturi, comenzi sau să intre în zone sigure până expiră tag-ul.
• Penalizează jucătorii care se deconectează în timpul combatului prin drop de inventory sau prin aplicarea unei pedepse definite de server.
• Recompensează automat killerii cu bani sau execută comenzi personalizate la kill.

⌨️ Comenzi

Note: comenzile listate sunt preluate din documentația oficială a pluginului și pagina de resource. Nivelele de permisiune pentru fiecare comandă sunt documentate de proiect, dar nu sunt reproduse aici.

⚙️ Instalare

📥 Configurare

• Descarcă JAR-ul oficial al pluginului de pe pagina de distribuție pentru platforma ta.
• Plasează JAR-ul în directorul plugins/ pe un server compatibil Spigot/Paper.
• Repornește serverul și verifică logurile consolei pentru a confirma că pluginul s-a încărcat.

📦 Dependențe

• PlaceholderAPI (integrare opțională pentru placeholders).
• Integrări disponibile pentru pluginuri de zonă și NPC precum WorldGuard, Towny și Citizens (opțional, utilizate când sunt prezente).

🧠 Note tehnice

• Software-ul de server confirmat ca suportat include Spigot și Paper; suportul Folia este de asemenea menționat de proiect.
• Pluginul oferă un API pentru dezvoltatori și publică dev builds pentru testare.
• Proiectul publică source code și issue tracking în repository-ul său public și folosește bStats pentru telemetrie.
• Versiunile Minecraft testate acoperă multe release-uri; proprietarii de servere ar trebui să consulte documentația pluginului pentru compatibilitatea exactă cu o anumită versiune de server.

🤝 Când este util acest plugin

PvPManager este util atunci când ai nevoie de un singur plugin configurabil pentru a gestiona comutatoarele PvP, combat tagging, pedepsele pentru combat-log și protecția începătorilor fără a asambla mai multe pluginuri separate. Centralizează regulile comune PvP și oferă comenzi de admin și integrări pentru a adapta comportamentul la diferite configurații de server.