⚔️ EC-DTC — Destroy The Core

Evento PvP competitivo avanzado para servidores Paper donde los jugadores destruyen un núcleo para ganar recompensas, dominar el ranking y obtener premios automáticos.

Documentación para uso público. Los cambios recientes del plugin están en la sección Changelog al final.

---

🚀 ¿Qué es EC-DTC?

EC-DTC (Destroy The Core) es un sistema de eventos PvP automático y manual totalmente configurable.

Los jugadores deben destruir un núcleo con vida configurable.
Cada golpe cuenta. Cada porcentaje importa.
Al finalizar, se calcula un TOP de contribución y se reparten recompensas automáticamente.

---

✨ Características Principales

• ✅ Sistema multi-evento por ID (default, mina, nether, etc.)
• ✅ Scheduler independiente por evento
• ✅ Mensajes 100% editables en MiniMessage
• ✅ BossBar con progreso en tiempo real
• ✅ Sistema de contribución individual
• ✅ TOP final con recompensas por posición
• ✅ Recompensas por porcentaje acumulado
• ✅ Protección inteligente de bedrock fuera del evento
• ✅ Placeholders para HUD, Scoreboard y Menús
• ✅ Estadísticas guardadas por jugador
• ✅ Soporte completo para PlaceholderAPI

---

✅ Compatibilidad

• Java 17+
• Paper/Spigot 1.20+
• PlaceholderAPI (opcional, recomendado)

---

⚙️ Instalación

1. Compila o descarga el .jar.
2. Copia el archivo en plugins/.
3. Inicia el servidor para generar config.yml y lang.yml.
4. Edita configuración y mensajes.
5. Ejecuta /dtc reload para aplicar cambios.

---

⌨️ Comandos

Comando	Descripción	Permiso
/dtc start [id]	Inicia un evento por ID (default, mina, etc.)	dtc.admin
/dtc stop [id]	Detiene el evento activo (opcionalmente validando ID)	dtc.admin
/dtc info [id]	Muestra información del evento/perfil	dtc.admin
/dtc time	Muestra tiempo y ID del próximo evento programado	dtc.admin
/dtc top	Muestra ranking del evento activo	dtc.admin
/dtc reload	Recarga config y mensajes	dtc.admin

---

🧩 Placeholders (%dtc_*%)

Placeholder	Descripción
%dtc_blocks_broken%	Bloques rotos por el jugador
%dtc_blocks_remaining%	Bloques restantes del núcleo
%dtc_blocks_total%	Vida total del núcleo
%dtc_my_contribution%	Contribución del jugador en %
%dtc_global_stats%	Valor global de contribución del jugador
%dtc_minutes_until_event%	Minutos aproximados hasta el próximo evento
%dtc_time_until_event%	Tiempo restante formateado
%dtc_next_event%	Hora del próximo evento (HH:mm)
%dtc_event_active%	true / false si hay evento activo
%dtc_event_time_left%	Tiempo restante del evento activo

---

🗂️ Configuración recomendada

1) Perfil de núcleo por evento

Se define en Events.<id>:

Events:
  default:
    CoreHealth: 5
    CoreMaterial: OBSIDIAN
    Location:
      world: "world"
      x: -174
      y: 48
      z: -24
    break-sound: BLOCK_BEACON_DEACTIVATE
    break-sound-volume: 1.0
    break-sound-pitch: 1.0

2) Scheduler por evento (estructura única)

Schedule:
  TimeZone: "UTC"
  Events:
    default:
      ActiveDays: ["SUNDAY"]
      Times: ["03:00"]
    mina:
      ActiveDays: ["MONDAY"]
      Times: ["01:00"]

• Formato de hora: HH:mm
• Si falta configuración de horarios, el plugin no crashea; registra debug [DTC-DEBUG] y no programa ese evento.

3) Recompensas por golpe (umbrales acumulados)

Core:
  hit-rewards:
    "30":
      - give %player% diamond 1
    "60":
      - give %player% netherite_ingot 1
    "90":
      - give %player% emerald 1
    "100":
      - give %player% enchanted_golden_apple 1

Interpretación: 30% / 30% / 30% / 10%.

4) Control al finalizar evento

Core:
  replace-on-end: true

• true: reemplaza el núcleo por bedrock al terminar.
• false: no reemplaza automáticamente.

---

💬 Mensajería (MiniMessage)

lang.yml acepta MiniMessage:

• <red>Texto</red>
• <bold>Texto</bold>
• <gradient:#ff0000:#00ffff>Texto</gradient>

---

🧾 Changelog reciente

v2.0.0

• Nuevo sistema de multi-evento por ID (start/info/stop con id).
• Scheduler por evento con Schedule.Events.<id>.ActiveDays y Times.
• Soporte completo de MiniMessage en mensajes (lang.yml) y textos de config usados por el plugin.
• /dtc time ahora soporta %event_id% además de %time% en Messages.NextTimeCommand.
• Fix de Core.hit-rewards por umbrales acumulados (config y lectura consistentes).
• Clave explícita Core.replace-on-end para controlar reemplazo al terminar evento.
• Corrección de errores de compilación por imports y genéricos.
• Cancelación correcta de tareas para evitar duplicados tras reload.
• Null-safety en PlaceholderAPI cuando no hay jugador en contexto.
• Limpieza del mapa de cooldown en protección de bedrock.