KOTH Configuration

Each KOTH has its own configuration file located in plugins/CocoKoth/koths/<name>.yml.

Basic Settings

plugins/CocoKoth/koths/example.yml

# Display name shown to players
display-name: "Example KotH"

# Game mode: CAPTURE or SCORE
mode: CAPTURE

# Minimum players online to start
minimum-players: 0

# Broadcast distance (0 = server-wide, -1 = world-wide)
broadcast-distance: 0

# Zone corners (set with /koth wand)
zone:
  location1: "world,0,64,0"
  location2: "world,10,74,10"

Capture Mode Settings

settings:
  # Time needed to capture (in seconds)
  capture-time-seconds: 180
  
  # Reset timer when player leaves?
  capture-end-reset-time: true
  
  # Max time the KOTH can run (-1 = unlimited)
  max-time-seconds: 7200
  
  # Reward current capturer if max time reached?
  end-reward-capturer: false

Score Mode Settings

settings:
  # Team mode (scores per team)
  team-mode: false
  
  # Points needed to win (-1 = time decides)
  capture-time-seconds: -1
  
  # Maximum time the KOTH can run
  max-time-seconds: 1200

Bossbar

bossbar:
  enabled: true
  only-show-when-capturing: false
  view-distance: 70  # -1 = world, 0 = server
  name: "&#FF0000%displayName% &#DDDDDD| &#FF6600%capturer% &#DDDDDD(%timeLeft_formatted%)"
  color: RED    # BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
  style: NOTCHED_20  # PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20

Scoreboard

scoreboard:
  enabled: true
  only-show-when-capturing: false
  view-distance: 70
  title: '&#FF0000&l%displayName%'
  lines:
    - ' '
    - '&#FF0000Location:'
    - ' &#444444❙ &fX%x%; Y%y%; Z%z%'
    - ' '
    - '&#FF0000Leaderboard:'
    - ' &#FFFF001. &f%score_1_player%: &f%score_1_points%'
    - ' &#FFAA002. &f%score_2_player%: &f%score_2_points%'
    - ' &#FF66003. &f%score_3_player%: &f%score_3_points%'
    - ' &#FF0000You: &f%score%'
    - ' '
    - '&#FF0000play.yourserver.com'

Scoreboard Placeholders

Placeholder	Description
%displayName%	KOTH display name
%capturer%	Current capturer
%capturer_raw%	Capturer without formatting
%timeLeft_formatted%	Time remaining
%maxTimeLeft_formatted%	Max time remaining
%score%	Your current score
%score_X_player%	Player at position X
%score_X_points%	Points of player at X
%x%, %y%, %z%	KOTH center coordinates

Hologram

hologram:
  enabled: true
  location-offset:
    x: 0
    y: 3
    z: 0
  lines:
    - "&#FF0000&l%displayName%"
    - "&f%capturer% &7| &f%timeLeft_formatted%"

Starter Item

starter:
  enabled: true
  material: "BLAZE_POWDER"
  glow: true
  name: "&#FF0000%displayName% &#DDDDDDStarter"
  lore:
    - " "
    - "&#FF0000Information:"
    - " &#444444❙ &#FFAA66Location: &#FFFFFF%world% %x%, %y%, %z%"
    - " &#444444❙ &#FFAA66Type: &#FFFFFFCapture KotH"
    - " "
    - "&#FFAA66Right-click to start!"

Reward Commands

# Executed when someone wins
reward-commands:
  - "give %player% diamond 5"
  - "say %player% has captured %displayName%!"

# Score mode: Reward specific positions
reward-commands:
  - "TOP:1:give %player% diamond 10"
  - "TOP:1:say %player% won 1st place!"
  - "TOP:2:give %player% gold_ingot 5"
  - "TOP:3:give %player% iron_ingot 5"

Event Commands

# Executed when KOTH starts
start-commands:
  - "say %displayName% has started!"

# Executed when KOTH ends
end-commands:
  - "say %displayName% has ended!"

# Executed when someone starts capturing
capture-start-commands:
  - "say %player% started capturing %displayName%!"

# Executed when someone stops capturing
capture-end-commands:
  - "say %player% stopped capturing %displayName%!"

Per-KOTH Broadcasts

Override global broadcast messages for specific KOTHs:

broadcasts:
  start: "&#FFFF00The &#FFCC00%displayName% &#FFFF00has started!"
  stop: "&#FFFF00The &#FFCC00%displayName% &#FFFF00has ended!"
  capture-start: "&#FFCC00%capturer% &#FFFF00started capturing!"
  capture-status: "&#FFCC00%capturer% &#FFFF00is capturing!"
  capture-lost: "&#FFCC00%capturer% &#FFFF00lost control!"
  captured: "&#FFCC00%capturer% &#FFFF00captured the KOTH!"
  out-of-time: "&#FFFF00Time ran out without a winner!"