iKoth — MC SETTINGS

Acerca del Plugin

iKoth es una solución competitiva de alto rendimiento diseñada para gestionar eventos de captura de zonas de forma automática y personalizable. Cuenta con integración completa con Discord vía Webhooks con embeds personalizables, interfaz GUI intuitiva para la gestión de loot, programador de eventos automático y almacenamiento persistente en base de datos SQLite.

Características Principales

Editor de Loot en Juego (GUI): Configura recompensas arrastrando ítems a un menú interactivo o registrando comandos ejecutables para el ganador.
Programación Automática: Establece horarios exactos de inicio (HH:mm) de forma individual para cada KOTH.
Base de Datos SQLite: Almacenamiento rápido y eficiente en mkoth.db para guardado de estadísticas y tops históricos.
Integración con Discord: Webhooks nativos con embeds configurables en español y visualización de skin/cabeza del ganador vía URL.
Visuales Configurables: BossBar nativa, ActionBars, Titles, compatibilidad con colores HEX (&#D21414) y aviso de actualizaciones en el juego.
Placeholders Dinámicos: Integración completa con PlaceholderAPI para mostrar el estado en tiempo real, temporizadores y rankings en Scoreboards, TAB o Hologramas.

Comandos de Administración

/ikoth wand - Otorga la varita para seleccionar la región de la zona
/ikoth create <nombre> - Crea un KOTH utilizando la selección de la varita
/ikoth edit - Abre el menú GUI interactivo de administración
/ikoth setloot <nombre> - Abre el editor GUI de recompensas (ítems y comandos)
/ikoth start <nombre> [player|console|auto] - Inicia un evento KOTH
/ikoth stop - Detiene la partida activa del KOTH
/ikoth schedule <nombre> <HH:mm[,HH:mm...]> - Programa horarios de inicio automático
/ikoth set <nombre> <propiedad> <valor> - Ajusta configuraciones dinámicas
/ikoth addcommand <nombre> <comando> - Añade un comando ejecutable de recompensa
/ikoth removecmd <nombre> <índice> - Remueve un comando de recompensa por su índice
/ikoth top [cantidad] - Muestra el top global de victorias
                

Variables & Placeholders (PlaceholderAPI)

El plugin incluye un conjunto completo de placeholders actualizados para consultar el estado global, partidas activas y estadísticas de jugadores:

# Estado del Evento y Tiempos
%ikoth_active% - Nombre del KOTH en ejecución o mensaje por defecto
%ikoth_active_boolean% - Devuelve true o false si hay un evento activo
%ikoth_active_started_at% - Hora de inicio en formato ISO-8601 UTC
%ikoth_active_elapsed_seconds% - Segundos transcurridos desde el inicio
%ikoth_koth_active_<nombre>% - Estado legible (Activo / Apagado) de un KOTH
%ikoth_cooldown_<nombre>% - Tiempo restante para la próxima ejecución programada

# Estadísticas y Ganadores
%ikoth_winner% / %ikoth_winer% / %ikoth_last_winner% - Último ganador del evento
%ikoth_last_winners_5% - Lista de los últimos 5 ganadores
%ikoth_top_winner% / %ikoth_top_wins% - Líder global del ranking y sus victorias
%ikoth_player_wins% - Cantidad de victorias del jugador local
%ikoth_player_rank% - Posición del jugador en el ranking global
%ikoth_top_1_name% / %ikoth_top_1_wins% - Nombre y victorias del 1.º lugar
%ikoth_top_2_name% / %ikoth_top_2_wins% - Nombre y victorias del 2.º lugar
%ikoth_top_3_name% / %ikoth_top_3_wins% - Nombre y victorias del 3.º lugar
%ikoth_koth_top_winner_<koth>% - Mayor ganador de un KOTH específico
%ikoth_koth_top_wins_<koth>% - Cantidad de victorias del Top 1 en un KOTH específico
                

Permisos del Sistema

ikoth.admin - Acceso total a los comandos administrativos y editor de recompensas
ikoth.notify - Permite recibir alertas in-game sobre nuevas versiones publicadas en GitHub
                

Estructura de Archivos