The KOTH mod allows for the creation and scheduling of PvP events that require capturing a designated area for a specific duration to earn a reward; the entire mod is based on the `/koth` command, which is explained below.

/koth Command Documentation

The /koth (King of the Hill) command allows server administrators (requires permission level 2) to create, manage, schedule, and run KOTH events on the server.

🛠️ General & Setup Commands

• /koth create <name>

  Creates a new KOTH arena with the specified name.

• /koth list

  Lists all registered KOTH arenas along with their current status (e.g., active, idle, or disabled).

• /koth save

  Manually saves all current KOTH data and settings to disk.

📍 Arena Configuration Commands

Replace <name> with the name of the KOTH arena you wish to configure:

• /koth <name> area hill set <cord1> <cord2>

  Sets the hill (capture zone) area using two block coordinates.

• /koth <name> area arena set <cord1> <cord2>

  Sets the full outer arena area using two block coordinates.

• /koth <name> reward

  Opens an inventory GUI allowing admins to place and edit the reward items given to the event winner.

• /koth <name> minplayers <amount>

  Sets the minimum number of online players required to trigger or start the event.

• /koth <name> capturetime <seconds>

  Sets how many seconds a player/faction must hold the hill to win the KOTH.

• /koth <name> message <message>

  Customizes the broadcast message announced when the event starts.

  • Placeholders available: {koth}, {x}, {y}, {z}, {minplayers}, {capturetime}.

  • Use & for color codes (e.g., &6Event started!).

  • Type /koth <name> message reset to reset to default.

• /koth <name> enable / /koth <name> disable

  Enables or disables the KOTH arena.

⏱️ Scheduling & Control Commands

• /koth <name> schedule minutes|hours|days <amount>

  Schedules the KOTH event to repeat automatically at the specified interval.

• /koth <name> start

  Forces the specified KOTH event to start immediately (requires hill and arena areas to be configured first).

• /koth <name> cancel

  Cancels an active KOTH event and resets its progress.

• /koth <name> show

  Highlights the boundaries of the hill and arena areas in-game for 10 seconds.

• /koth <name> info

  Displays complete information about the specified KOTH (status, coordinates, capture time, schedule, etc.).

🔮 Hologram Commands

• /koth hologram create <target> [location]

  Creates a leaderboard hologram.

  • <target>: Use global for global stats, or specify a KOTH arena name.

  • [location]: (Optional) Standard block coordinates (x y z). If omitted, the hologram spawns slightly above the player's current head position.

• /koth hologram remove <id>

  Deletes an existing hologram by its ID.

• /koth hologram list

  Lists all active holograms, including their IDs, target KOTH, and coordinates.

🏆 Leaderboard Commands

• /koth leaderboard

  Displays the top 10 global KOTH winners.

• /koth leaderboard <name>

  Displays the top 10 winners for a specific KOTH arena.

  Community & Support

  Need help, want to share your custom contract datapacks, or need to download the Datapack Template? Join our community Discord!

  👉 Join our Discord Server
  
  Español

  El mod KOTH permite la creación y programación de eventos PvP que requieren capturar un área designada durante una duración específica para ganar una recompensa; todo el mod se basa en el comando /koth, el cual se explica a continuación.

  Documentación del Comando /koth

  El comando /koth (King of the Hill / Rey de la Colina) permite a los administradores del servidor (requiere nivel de permiso 2) crear, gestionar, programar y ejecutar eventos KOTH en el servidor.

  🛠️ Comandos Generales y de Configuración

  • /koth create <nombre>

    Crea una nueva arena KOTH con el nombre especificado.

  • /koth list

    Muestra una lista de todas las arenas KOTH registradas junto con su estado actual (por ejemplo: activa, inactiva o deshabilitada).

  • /koth save

    Guarda manualmente en el disco todos los datos y la configuración actual de KOTH.

  📍 Comandos de Configuración de Arenas

  Reemplaza <nombre> por el nombre de la arena KOTH que deseas configurar:

  • /koth <nombre> area hill set <cord1> <cord2>

    Establece la zona de la colina (zona de captura) utilizando dos coordenadas de bloques.

  • /koth <nombre> area arena set <cord1> <cord2>

    Establece el área exterior completa de la arena utilizando dos coordenadas de bloques.

  • /koth <nombre> reward

    Abre una interfaz (GUI) de inventario que permite a los administradores colocar y editar los ítems de recompensa otorgados al ganador del evento.

  • /koth <nombre> minplayers <cantidad>

    Establece la cantidad mínima de jugadores conectados requeridos para activar o iniciar el evento.

  • /koth <nombre> capturetime <segundos>

    Establece cuántos segundos debe mantener la colina un jugador o facción para ganar el KOTH.

  • /koth <nombre> message <mensaje>

    Personaliza el mensaje global que se anuncia cuando inicia el evento.

    • Marcadores de posición (placeholders) disponibles: {koth}, {x}, {y}, {z}, {minplayers}, {capturetime}.

    • Usa & para códigos de color (por ejemplo: &6¡El evento ha comenzado!).

    • Escribe /koth <nombre> message reset para restablecer el mensaje por defecto.

  • /koth <nombre> enable / /koth <nombre> disable

    Habilita o deshabilita la arena KOTH.

  ⏱️ Comandos de Control y Programación

  • /koth <nombre> schedule minutes|hours|days <cantidad>

    Programa el evento KOTH para que se repita automáticamente en el intervalo especificado (minutes = minutos, hours = horas, days = días).

  • /koth <nombre> start

    Fuerza el inicio inmediato del evento KOTH especificado (requiere que las áreas de la colina y de la arena estén configuradas previamente).

  • /koth <nombre> cancel

    Cancela un evento KOTH activo y reinicia su progreso.

  • /koth <nombre> show

    Resalta en el juego los límites de la colina y de la arena durante 10 segundos.

  • /koth <nombre> info

    Muestra información completa sobre el KOTH especificado (estado, coordenadas, tiempo de captura, programación, etc.).

  🔮 Comandos de Hologramas

  • /koth hologram create <objetivo> [ubicación]

    Crea un holograma con la tabla de clasificación.

    • <objetivo>: Usa global para estadísticas globales, o especifica el nombre de una arena KOTH.

    • [ubicación]: (Opcional) Coordenadas estándar de bloques (x y z). Si se omite, el holograma aparecerá ligeramente por encima de la cabeza del jugador.

  • /koth hologram remove <id>

    Elimina un holograma existente mediante su ID.

  • /koth hologram list

    Muestra una lista de todos los hologramas activos, incluyendo sus IDs, el KOTH al que apuntan y sus coordenadas.

  🏆 Comandos de la Tabla de Clasificación

  • /koth leaderboard

    Muestra el Top 10 global de ganadores de KOTH.

  • /koth leaderboard <nombre>

    Muestra el Top 10 de ganadores de una arena KOTH específica.

  Comunidad y Soporte

  ¿Necesitas ayuda, quieres compartir tus datapacks de contratos o descargar la plantilla? ¡Únete a nuestro servidor de Discord!

  👉 Únete a nuestro servidor de Discord