Plugin Minecraft PvPManager

🔌 À propos de PvPManager

PvPManager est un plugin Minecraft destiné à gérer le comportement joueur contre joueur et les règles du serveur liées au combat. Il regroupe les bascules de PvP, le marquage en combat, la prévention du combat-log, la protection des débutants et plusieurs comportements liés aux kills/respawn dans un seul plugin configurable pensé pour les administrateurs de serveur.

🎯 Objectif

L’objectif principal de PvPManager est de fournir des contrôles centralisés et configurables pour les interactions PvP et les cas particuliers liés au combat, afin que les propriétaires de serveur puissent appliquer des règles cohérentes (activer/désactiver le PvP, punir le combat logging, protéger les nouveaux joueurs, contrôler les récompenses/pénalités de kill et gérer les restrictions de combat).

⚙️ Fonctionnalités

• Activer/désactiver le PvP par joueur, par monde ou globalement.
• Système de marquage en combat avec temporisateurs configurables et indicateurs visuels (action bar/boss bar).
• Prévention du combat-log avec punitions configurables (faire tomber l’inventaire, faire tomber l’armure/l’XP, pénalité d’argent, tuer le joueur, annoncer/enregistrer les événements).
• Protection des débutants et protection au respawn/teleport.
• Anti border-hopping (empêche de fuir vers des zones sûres pendant qu’on est marqué) et déclencheurs anti abus de kill.
• Désactiver des actions pendant le combat (vol, changement de gamemode, commandes, ender pearls, placement de blocs, etc.).
• Options de gestion de l’inventaire (conserver, faire tomber ou transférer les drops au killer) et support de l’auto-soup.
• Récompenses/pénalités d’argent et commandes exécutables au kill.
• Intégrations avec PlaceholderAPI et prise en charge de plugins de zones (WorldGuard, Towny) et Citizens ; intégrations optionnelles pour des comportements spécifiques.
• Télémétrie et rapports d’utilisation via bStats.

🧩 Pour qui

• Serveurs Survival et SMP qui ont besoin de règles PvP configurables.
• Serveurs qui nécessitent une protection contre le combat logging et une sécurité d’accueil pour les nouveaux joueurs.
• Administrateurs qui veulent des règles intégrées de kill/récompense et des bascules PvP simples sans multiplier les plugins séparés.

🏗️ Exemples d’utilisation

• Activer la protection des débutants pour les premières sessions de jeu et n’autoriser le PvP qu’après un délai configurable.
• Marquer les joueurs en combat et les empêcher d’utiliser les téléports, les commandes ou d’entrer dans des zones sûres jusqu’à l’expiration du marquage.
• Pénaliser les joueurs qui se déconnectent pendant le combat en faisant tomber l’inventaire ou en appliquant une punition définie par le serveur.
• Récompenser automatiquement les killers avec de l’argent ou exécuter des commandes personnalisées au kill.

⌨️ Commandes

Notes : les commandes listées proviennent de la documentation officielle du plugin et de la page de la ressource. Les nœuds de permission pour chaque commande sont documentés par le projet, mais ne sont pas reproduits ici.

⚙️ Installation

📥 Configuration

• Téléchargez le JAR officiel du plugin depuis la page de distribution du plugin pour votre plateforme.
• Placez le JAR dans le dossier plugins/ du serveur sur un serveur compatible Spigot/Paper.
• Redémarrez le serveur et vérifiez les journaux de la console pour confirmer que le plugin a bien été chargé.

📦 Dépendances

• PlaceholderAPI (intégration optionnelle pour les placeholders).
• Intégrations disponibles pour des plugins de zones et de PNJ tels que WorldGuard, Towny et Citizens (optionnelles, utilisées lorsqu’elles sont présentes).

🧠 Notes techniques

• Les logiciels de serveur pris en charge et confirmés incluent Spigot et Paper ; la prise en charge de Folia est également indiquée par le projet.
• Le plugin fournit une API pour les développeurs et publie des builds de développement pour les tests.
• Le projet publie le code source et le suivi des issues dans son dépôt public et utilise bStats pour la télémétrie.
• Les versions de Minecraft testées couvrent de nombreuses releases ; les propriétaires de serveur devraient consulter la documentation du plugin pour connaître la compatibilité exacte avec une version précise du serveur.

🤝 Quand ce plugin est utile

PvPManager est utile lorsque vous avez besoin d’un seul plugin configurable pour gérer les bascules de PvP, le marquage en combat, les punitions de combat-log et la protection des débutants sans assembler plusieurs plugins séparés. Il centralise les règles PvP courantes et fournit des commandes d’administration ainsi que des intégrations pour adapter le comportement à différentes configurations de serveur.