Creating KOTHs

KOTHs are created in-game. You select the capture zone with the wand, run one command, and the plugin writes a ready-to-run file to koths/<koth>.yml. Everything here needs optimalkoth.admin.

1. Get the wand

/kothadmin wand

You receive the KOTH Wand (a glowing blaze rod by default, styled in config.yml). If your inventory is full it drops at your feet.

2. Select the zone

• Left click a block to set Position 1.
• Right click a block to set Position 2.

Each click sends POSITION-SET with the coordinates and plays the WAND-SELECT sound. Once both corners are set in the same world, a particle outline (Selection-Particle, happy villager by default) shows the box you selected.

The zone is a box between the two blocks, both included. Mind the height: a player counts as inside when the block their feet are in is inside the box, and that is the block above the one they stand on. A selection of only the floor layer never contains anyone, so include at least one layer above the floor. The total number of blocks is shown when you create the KOTH.

The wand does not break blocks

While you hold the wand, block breaking is cancelled and clicks do not interact with the block, so you can click chests, doors and buttons safely. The selection is cleared when you log out.

3. Create the KOTH

/kothadmin create spawn

The id is 1 to 32 lower-case letters, digits or dashes. It becomes the file name (koths/spawn.yml) and the <koth> argument of every other command.

The plugin copies the built-in template, writes your selection into Region, sets Display-Name to &d&lSpawn (the id with a capital first letter) and saves the file. The hologram appears above the zone straight away and your selection is cleared.

Template defaults, all editable in the file:

Setting	Default
Capture-Time	180 (3 minutes)
Max-Duration	1800 (30 minutes)
Reset-On-Leave	true
Minimum-Players	0
Progress-Announcement-Interval	30
Hologram	enabled, 2 blocks above the zone
Boss bar	enabled, shown to everyone, pink, 20 notches
Rewards	a message to the winner and eco give {player} 10000

4. Edit the file

Open plugins/OptimalKoth/koths/spawn.yml. The most common changes:

Settings:
  Enabled: true
  Display-Name: "&6&lSpawn KOTH"
  Capture-Time: 300
  Max-Duration: 1800
  Reset-On-Leave: true
  Minimum-Players: 5
  Progress-Announcement-Interval: 60

Rewards:
  - "[message] &5[&d&lKOTH&5] &7You won {koth} &7and received your rewards!"
  - "[broadcast] &f{player} &7just won {koth}&7!"
  - "crates key give {player} koth 1"
  - "eco give {player} 25000"

Every key is explained in the koths reference. Then reload:

/kothadmin reload

A file that fails to load is skipped and the console names the file and the problem, so check the console after every reload.

5. Test it

/kothadmin start spawn

Walk into the zone. You should see HILL-TAKEN, the boss bar filling up and the hologram switch to its running lines. Stay until Capture-Time runs out to win, or end it early with:

/kothadmin stop spawn

/kothadmin list shows every KOTH with its status, capturer and next scheduled start.

To start KOTHs automatically, continue to Scheduling KOTHs.

Managing KOTHs

• See a zone again: /kothadmin outline spawn draws the zone in Koth-Particle particles (flame by default) for you only. Run it again to hide it. Particles only show within Outline.Range blocks.
• Go there: /kothadmin tp spawn teleports you on top of the centre of the zone.
• Move a zone: delete the KOTH and create it again from a new selection, or edit the Region coordinates by hand and reload. Changing the Region of a running KOTH stops it on reload.
• Disable without deleting: set Settings.Enabled: false. A disabled KOTH cannot be started, is skipped by schedules and has no hologram.
• Delete: /kothadmin delete spawn stops it if it is running, removes the hologram and deletes the file. Its capture history stays in the database.

Notes

• Reloading a running KOTH keeps its progress and switches it to the new settings (capture time, displays, rewards). It is only stopped when its file is gone, it was disabled, or its Region changed.
• The world must be loaded. A KOTH whose world is not loaded cannot be started or teleported to, and gets no hologram until the next reload.
• Files starting with _ are ignored, so you can keep a copy like _spawn-old.yml in the folder without it loading.
• Several KOTHs can run at once. Each one has its own capturer, boss bar and hologram.