PvPDirector

PvPDirector
Plugin avanzado de PvP para Paper/Spigot 1.20+ diseñado para que el combate deje de ser plano y predecible, ofreciendo un PvP vivo, justo y controlado sin configuraciones complejas para el administrador.

Características Principales
1️⃣ Combate Avanzado

• Detección inteligente: Detecta automáticamente el inicio y fin de combates reales entre jugadores.
  
  
• Daño por arma: Multiplicadores según tipo (espadas, arcos, dagas, tridentes, hachas).
  
  
• Daño por clase: Clases con permisos (warrior, archer, rogue, mage).
  
  
• Knockback personalizado: Ajustable por arma, clase o efectos de poción.
  
  
• Críticos: Probabilidad configurable con efectos visuales y sonoros.
  
  
• Combos y rachas: Multi-hit y bonus de daño por rachas consecutivas.
  
  
• Velocidad de ataque: Modificable según efectos activos.
  
  
• Daño progresivo por rachas: Bonus acumulativo configurable.
  
  
• Protección de zonas seguras: Reducción de daño en spawn y áreas protegidas.

2️⃣ Estadísticas y Progresión

• Historial completo de combates.
  
  
• Rankings globales: kills, K/D, rachas.
  
  
• Estadísticas individuales: kills, muertes, K/D ratio, racha actual y mejor racha.
  
  
• Estadísticas por arma: kills y muertes según arma usada.
  
  
• Recompensas automáticas por milestones de kills.

3️⃣ Prevención de Abusos y Seguridad

• Anti-logout progresivo: Castigos por desconexión en combate.
  
  
• Anti-camping y anti-runaway: Penalizaciones por permanecer o huir excesivamente.
  
  
• Anti-cleanup: Penalización por rematar jugadores debilitados.
  
  
• Protección de spawn y zonas seguras.
  
  
• Configuración de mundos/zona PvP permitidos.

4️⃣ Sistema de Zonas PvP

• Definición de zonas con reglas únicas.
  
  
• Modos: libre, 1v1, equipos, arenas.
  
  
• Multiplicadores de daño y knockback por zona.
  
  
• Activación/desactivación temporal de zonas.
  
  
• Integración con perfiles automáticos por mundo.

5️⃣ Feedback Visual y Auditivo

• Partículas de combate, críticos y rachas.
  
  
• Sonidos al iniciar/terminar combate y golpes críticos.
  
  
• Indicadores visuales de estados especiales (stun, bleed).
  
  
• Efectos especiales al eliminar jugadores.

6️⃣ Configuración Avanzada

• Perfiles PvP personalizados por mundo, permiso o zona.
  
  
• Escalado de daño y knockback configurable por perfil.
  
  
• Cooldowns ajustables por perfil.
  
  
• Detección de toxicidad y castigos progresivos.
  
  
• Combat-tag configurable por perfil.

7️⃣ Integración y Compatibilidad

• API para otros plugins: Consultar estados de combate y perfiles.
  
  
• PlaceholderAPI: %pvpdirector_in_combat%, %pvpdirector_profile%.
  
  
• Integración con sistemas de economía y clanes.

8️⃣ Soporte Multi-idioma

• Idiomas incluidos: Español, Inglés, Francés.
  
  
• Detección automática del idioma del cliente.
  
  
• Fallback configurable en config.yml.
  
  
• Mensajes editables en langs/.

⚙️ Configuración
Archivos principales

• config.yml: Configuración principal.
  
  
• langs/messages_es.yml: Español.
  
  
• langs/messages_en.yml: Inglés.
  
  
• langs/messages_fr.yml: Francés.

Secciones destacadas

• language: Idioma por defecto.
  
  
• profiles: Perfiles PvP.
  
  
• toxicity: Detección de comportamiento tóxico.
  
  
• combat-log: Castigos por desconexión.
  
  
• advanced-combat: Configuración de críticos y rachas.
  
  
• statistics: Stats y milestones.
  
  
• zones: Zonas PvP y protección de spawn.
  
  
• visual-feedback: Efectos visuales y auditivos.
  
  
• update-checker: Comprobación de actualizaciones.

Comandos
Comando Descripción Permiso
/pvpdirector Muestra la ayuda -
/pvpdirector reload Recarga configuración pvpdirector.admin
/pvpdirector profile Muestra perfil PvP actual -
/pvpdirector stats Muestra estadísticas PvP -
/pvpdirector top [kills/kdr/streak] Top 10 jugadores -
/pvpdirector logs Últimos eventos de combate pvpdirector.logs
/pvpdirector version Muestra versión del plugin -

Permisos Clave

• pvpdirector.admin: Administración completa.
  
  
• pvpdirector.logs: Ver logs de combate.
  
  
• pvpdirector.profile.arena: Forzar perfil arena.
  
  
• pvpdirector.class.warrior/archer/rogue/mage: Clases con bonuses de daño.

API
import com.pvpdirector.api.PvPDirectorAPI;

// Verificar si un jugador está en combate
boolean inCombat = PvPDirectorAPI.isInCombat(player);

// Obtener estado de combate
CombatState state = PvPDirectorAPI.getCombatState(player);
if(state != null && state.isInCombat()){
UUID opponent = state.getLastOpponent();
}

PlaceholderAPI disponibles:

• %pvpdirector_in_combat%
  
  
• %pvpdirector_profile%

Estadísticas Registradas

• Kills y muertes por jugador
  
  
• K/D ratio
  
  
• Rachas actuales y mejores
  
  
• Tiempo total en combate
  
  
• Kills y muertes por arma
  
  
• Historial de últimos 100 combates por jugador

Efectos Visuales y Auditivos

• Partículas de daño y críticos
  
  
• Efectos de rachas y kills
  
  
• Sonidos de combate, críticos y eliminaciones
  
  
• Indicadores visuales de estados especiales

Zonas PvP
Ejemplo de configuración:

zones:
pvp-zones:
mi-arena:
world: world
min: { x: -100, y: 0, z: -100 }
max: { x: 100, y: 256, z: 100 }
mode: free
enabled: true
damage-multiplier: 1.2
knockback-multiplier: 1.0

Actualizaciones

• Comprobación automática en:
  https://raw.githubusercontent.com/MushhDev/Plugins-versions/main/pvpdirector.txt
  
  
• Desactivable en config.yml.

Notas

• Compatible con Paper/Spigot 1.20+
  
  
• Requiere Java 17+
  
  
• Optimizado para rendimiento y limpieza automática de estados
  
  
• Mensajes editables y traducibles

Reportar Problemas

• Abrir issues en el repositorio oficial del plugin.

Licencia

• Propiedad de MushhX. Todos los derechos reservados.

Autor: MushhX
Compatibilidad: Paper/Spigot 1.20+