Plugin de Minecraft PvPManager

🔌 Acerca de PvPManager

PvPManager es un plugin de Minecraft para gestionar el comportamiento jugador contra jugador y las reglas del servidor relacionadas con el combate. Combina la activación/desactivación de PvP, la marca de combate, la prevención de combat-log, la protección para novatos y varios comportamientos de muerte/respawn en un solo plugin configurable, pensado para administradores de servidores.

🎯 Propósito

El propósito principal de PvPManager es ofrecer controles centralizados y configurables para las interacciones de PvP y los casos especiales relacionados con el combate, de modo que los propietarios del servidor puedan aplicar reglas coherentes (activar/desactivar PvP, castigar el combat logging, proteger a los nuevos jugadores, controlar recompensas/penalizaciones por kills y gestionar restricciones de combate).

⚙️ Funciones

• Activar/desactivar PvP por jugador, por mundo o globalmente.
• Sistema de marca de combate con temporizadores configurables e indicadores visuales (action bar/boss bar).
• Prevención de combat-log con castigos configurables (soltar inventario, soltar armadura/exp, penalización de dinero, matar al jugador, anunciar/registrar eventos).
• Protección para novatos y protección al reaparecer/teletransportarse.
• Anti border-hopping (impide huir a zonas seguras mientras estás marcado) y activadores anti abuso de kills.
• Desactivar acciones durante el combate (volar, cambiar de gamemode, comandos, ender pearls, colocar bloques, etc.).
• Opciones de gestión del inventario (conservar, soltar o transferir los objetos al killer) y soporte para auto-soup.
• Recompensas/penalizaciones en dinero y comandos ejecutables al matar.
• Integraciones con PlaceholderAPI y soporte para plugins de zonas (WorldGuard, Towny) y Citizens; integraciones opcionales para comportamientos específicos.
• Telemetría e informes de uso mediante bStats.

🧩 Para quién es

• Servidores Survival y SMP que necesitan reglas de PvP configurables.
• Servidores que requieren protección contra combat logging y seguridad de incorporación para novatos.
• Administradores que quieren reglas integradas de kills/recompensas y alternancia sencilla de PvP sin varios plugins separados.

🏗️ Casos de uso de ejemplo

• Activar la protección para novatos en las primeras sesiones y permitir PvP solo después de un tiempo configurable.
• Marcar a los jugadores en combate e impedir que usen teleports, comandos o entren en zonas seguras hasta que expire la marca.
• Penalizar a los jugadores que se desconectan durante el combate soltando el inventario o aplicando un castigo definido por el servidor.
• Recompensar automáticamente a los killers con dinero o ejecutar comandos personalizados al matar.

⌨️ Comandos

Notas: los comandos listados se toman de la documentación oficial del plugin y de la página del recurso. Los nodos de permiso de cada comando están documentados por el proyecto, pero no se reproducen aquí.

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin desde la página de distribución del plugin para tu plataforma.
• Coloca el JAR en el directorio plugins/ del servidor en un servidor compatible con Spigot/Paper.
• Reinicia el servidor y revisa los registros de consola para confirmar que el plugin se cargó.

📦 Dependencias

• PlaceholderAPI (integración opcional para placeholders).
• Integraciones disponibles para plugins de zonas y NPC como WorldGuard, Towny y Citizens (opcionales, se usan cuando están presentes).

🧠 Notas técnicas

• El software de servidor compatible y confirmado incluye Spigot y Paper; el soporte para Folia también aparece indicado por el proyecto.
• El plugin ofrece una API para desarrolladores y publica builds de desarrollo para pruebas.
• El proyecto publica el código fuente y el seguimiento de issues en su repositorio público y usa bStats para telemetría.
• Las versiones de Minecraft probadas abarcan muchos lanzamientos; los propietarios del servidor deberían consultar la documentación del plugin para conocer la compatibilidad exacta con una versión concreta del servidor.

🤝 Cuándo es útil este plugin

PvPManager es útil cuando necesitas un único plugin configurable para gestionar la activación/desactivación de PvP, la marca de combate, el castigo por combat-log y la protección para novatos sin reunir varios plugins separados. Centraliza las reglas comunes de PvP y ofrece comandos de administración e integraciones para adaptar el comportamiento a distintas configuraciones de servidor.