PVPITEM

Este plugin permite a los jugadores iniciar duelos 1v1 usando un item especial. Al golpear a otro jugador con este item, ambos son teletransportados a una arena de combate, donde lucharán durante un tiempo configurado. Si un jugador muere, el otro gana automáticamente. Si el tiempo se agota, el duelo termina en empate.

El plugin admite múltiples arenas configurables para evitar que varios jugadores se interpongan en una sola arena. También incluye un sistema de cooldown, soporte para mensajes personalizables y un sistema de recompensas para el ganador.

Características Principales
✅ Duelos 1v1 al golpear con un item especial.
✅ Varias arenas configurables en config.yml.
✅ Cooldown para evitar spam de duelos.
✅ Tiempo límite para cada combate.
✅ Opción de teleportación inmediata o con aceptación (instant o accept).
✅ Mensajes configurables en messages.yml con soporte para colores RGB.
✅ Sistema de recompensas opcional para el ganador.
✅ Comandos de administración para dar el item y recargar la configuración.

Comandos y Funcionalidad
Comando Descripción Permiso Requerido
/pvpitem give <jugador> Da el item especial de duelo a un jugador. pvpitem.admin
/pvpitem reload Recarga config.yml y messages.yml. pvpitem.admin




Explicación de la Configuración
Arenas

• Se pueden configurar múltiples zonas de combate para los duelos.
• Si todas las arenas están ocupadas, el jugador debe esperar.

Item de duelo

• Se puede cambiar el material, nombre y lore del item especial en config.yml.

Cooldown

• Se evita que los jugadores usen el item constantemente con un cooldown configurable.
• Si todas las arenas están llenas, el cooldown se activa automáticamente para evitar errores.

Duelos

• duel.duration: Duración máxima de la pelea en segundos.
• duel.teleport-type:
  • "instant" → Teletransporta a los jugadores de inmediato.
  • "accept" → Requiere que el otro jugador acepte el duelo.
• duel.exit-delay: Tiempo que los jugadores tienen para recoger objetos antes de ser teletransportados al spawn.

Recompensas

• Si rewards.enabled = true, se ejecutará el comando configurado cuando alguien gane.
• {winner} se reemplaza automáticamente con el nombre del ganador.

Spawn

• Ubicación a la que los jugadores serán teletransportados cuando termine el duelo.

Soporte para colores
Los mensajes admiten códigos de color de Minecraft (&a, &c, etc.) y colores RGB (&#ff0000 para rojo).


Funcionamiento del Sistema
1️⃣ Un jugador obtiene el item con /pvpitem give <jugador>.
2️⃣ Golpea a otro jugador con el item.
3️⃣ Ambos jugadores son teletransportados a una arena disponible.
4️⃣ Tienen un tiempo configurado (duel.duration) para luchar.
5️⃣ Si alguien muere, el otro es declarado ganador.

• Si rewards.enabled = true, el ganador recibe la recompensa.
  6️⃣ Si el tiempo se agota, el duelo termina en empate.
  7️⃣ Después de duel.exit-delay, los jugadores son teletransportados al spawn.

✅ Conclusión
Este plugin es ideal para servidores PvP, permitiendo duelos organizados en arenas personalizadas. Con mensajes editables, cooldowns, recompensas y múltiples arenas, se adapta fácilmente a cualquier servidor de Minecraft.