Wiki Release: 2026.09.5 · UltimateKoth: 2.26.1 · Documentation branch: 2

Capture modes and event flow#

Classic KOTH mode#

The normal KOTH mode tracks control of the configured region and capture time. A player/group must satisfy the event rules long enough for the capture to complete. When another eligible participant contests the area, the plugin applies its configured dispute/reset behavior.

Use a short capture time in staging so you can test entry, control transfer, contesting and completion repeatedly.

Percentage mode#

The supplied modes.yml contains a PercentageEvent mode under the percent entry. Use /ukoth mode to change the event mode supported by the current build, then test it independently from classic KOTH behavior.

Do not assume a value that makes sense for the normal timer has the same meaning in a percentage-based mode.

Proximity#

Global defaults live under Config.koth.proximity. The supplied configuration enables proximity and uses 16 blocks as the default.

Use /ukoth proximity toggle and /ukoth proximity setsize for per-event administration exposed by the command tree. If a player appears to be “inside” visually but is not affecting the event, verify the configured region and proximity separately.

Maximum time#

Config.koth.maxtime is enabled in the supplied configuration with a default of 300 seconds. /ukoth maxtime exposes toggle, size/time and end-action editing.

Maximum time is not the same as capture time: capture time is how long control is needed to win; maximum time limits how long the overall event can continue.

Group handling#

Config.group.default_allow_without_group is true in the supplied configuration. When a group implementation is active, UltimateKoth can attribute control/winner state to the player group. Test group behavior with the actual integration used on the server, not only with OP accounts.

Scoreboard and visual state#

The supplied configuration enables the scoreboard and recover_boards. If a board remains after an event or another scoreboard plugin conflicts, verify the scoreboard extension/preference and event cleanup before editing the KOTH itself.