messages.yml

Every message lives in messages.yml. Each supports legacy & codes, &#hex, MiniMessage and (with PlaceholderAPI) %...%. After editing, run /kothadmin reload.

Format

Messages:
  HILL-TAKEN:
    Message:
      Enabled: true
      Value:
      - '&5[&d&lKOTH&5] &f{capturer} &7now holds {koth}&7, &f{time-left} &7left to win it!'

• Enabled: false silences a message entirely.
• Value is a list - every line is sent. An empty line '' sends a blank line.
• Keep the {tokens} intact; don’t rename the message keys.

Missing keys are re-added with their defaults the next time the file loads, so you can delete a block to reset it.

Titles

Any message can also show a title and subtitle on screen. Add a Title: block next to Message::

Messages:
  KOTH-WON:
    Message:
      Enabled: true
      Value:
      - '&5[&d&lKOTH&5] &f{capturer} &7won {koth} &7after &f{elapsed}&7!'
    Title:
      Enabled: true
      Title: "&2&m━━━&r &a&lKOTH &f&lWon &2&m━━━&r"
      Sub-Title: "&f{capturer} &7won {koth}&7!"

• Title is the large centre line, Sub-Title the smaller line beneath it. Either can be left ''.
• Optional Fade-In, Stay and Fade-Out set the timings in ticks (defaults 10, 60, 10).
• The same {tokens} the message uses resolve in the title and subtitle.
• Enabled: false hides only the title, leaving the chat message untouched.
• Titles only show to players, never to the console.

KOTH-STARTED and KOTH-WON ship with a title enabled. Add a Title: block to any other key the same way.

Who sees what

• Announcements (KOTH-STARTED, KOTH-STOPPED, KOTH-TIMED-OUT, MINIMUM-PLAYERS-NOT-MET, HILL-TAKEN, HILL-PROGRESS, HILL-DROPPED, KOTH-WON) go to every online player and to the console. Most come with a sound from Inventories-Sounds.
• Everything else goes only to the admin who ran the command (or clicked with the wand).

Message keys

Errors: PLAYER-ONLY, NO-PERMISSION, INVALID-KOTH, INVALID-NAME, KOTH-EXISTS, KOTH-DISABLED, SELECTION-INCOMPLETE, SELECTION-WORLD-MISMATCH, WORLD-NOT-LOADED, ALREADY-ACTIVE, NOT-ACTIVE, NO-KOTHS.

Admin: WAND-RECEIVED, POSITION-SET, KOTH-CREATED, KOTH-DELETED, KOTH-TELEPORTED, OUTLINE-SHOWN, OUTLINE-HIDDEN, RELOAD, KOTH-LIST, KOTH-LIST-LINE, KOTH-ADMIN-HELP.

Announcements: KOTH-STARTED, KOTH-STOPPED, KOTH-TIMED-OUT, MINIMUM-PLAYERS-NOT-MET, HILL-TAKEN, HILL-PROGRESS, HILL-DROPPED, KOTH-WON.

Key	Sent when
INVALID-KOTH	The <koth> argument matches no KOTH.
INVALID-NAME	create was given an id with characters other than lower-case letters, digits and dashes (or over 32).
KOTH-EXISTS	create was given an id that is already used.
KOTH-DISABLED	start on a KOTH with Enabled: false.
SELECTION-INCOMPLETE	create without both wand positions set.
SELECTION-WORLD-MISMATCH	The two wand positions are in different worlds.
WORLD-NOT-LOADED	start or tp on a KOTH whose world is not loaded.
ALREADY-ACTIVE	start on a KOTH that is running.
NOT-ACTIVE	stop on a KOTH that is not running.
NO-KOTHS	list with no KOTHs created yet.
KOTH-STOPPED	A KOTH is stopped by stop, by delete, or by a reload that removed, disabled or moved it.
KOTH-TIMED-OUT	Max-Duration ran out with no winner.
MINIMUM-PLAYERS-NOT-MET	A schedule tried to start a KOTH with too few players online.
HILL-PROGRESS	Every Progress-Announcement-Interval held seconds.
KOTH-LIST / KOTH-LIST-LINE	/kothadmin list. {koths} in KOTH-LIST is replaced by one KOTH-LIST-LINE per KOTH.

Tokens per message

“KOTH tokens” means the full KOTH token set ({koth}, {koth-id}, {world}, {x}, {y}, {z}, {status}, {capture-time}, {time-left}, {progress}, {elapsed}, {ends-in}, {capturer}, {last-winner}, {next}, {next-date}).

Message	Tokens
KOTH-STARTED, KOTH-STOPPED, KOTH-TIMED-OUT, HILL-TAKEN, HILL-PROGRESS	KOTH tokens
HILL-DROPPED	KOTH tokens; {capturer} is the player who lost the hill
KOTH-WON	KOTH tokens; {capturer} and {player} are the winner
MINIMUM-PLAYERS-NOT-MET	KOTH tokens, {required}, {online}
KOTH-DISABLED, WORLD-NOT-LOADED, ALREADY-ACTIVE, NOT-ACTIVE, KOTH-TELEPORTED, OUTLINE-SHOWN, OUTLINE-HIDDEN, KOTH-LIST-LINE	KOTH tokens
KOTH-CREATED	KOTH tokens, {blocks} (zone size in blocks)
KOTH-DELETED	{koth-id}
INVALID-KOTH, INVALID-NAME	{koth} (what was typed)
KOTH-EXISTS	{koth} (the id)
POSITION-SET	{position} (1 or 2), {x}, {y}, {z}
KOTH-LIST	{amount}, {koths}
RELOAD	{ms} (reload time in milliseconds)

A token only resolves in the messages that provide it.

Notes

• In KOTH-WON and KOTH-TIMED-OUT, {elapsed} is how long the KOTH ran in total, not how long the winner held it.
• KOTH-ADMIN-HELP is the help panel shown by /kothadmin with no (or an unknown) subcommand, and when a subcommand is missing its <koth> argument.