FoKoTH

!(https://cdn.modrinth.com/data/STHZPBmc/images/a78ec67e5e4fcdee07015e5c4e562e0df604ba02.png)

FoKoTH adds configurable King of the Hill events for servers that want timed PvP objectives, capture rewards, and admin-friendly event control. Create KOTH zones, start them manually or on a schedule, and show players clear live progress through broadcasts, bossbars, scoreboards, holograms, and optional actionbar messages.

## Features - Run KOTH events in CAPTURE mode for classic hold-the-zone gameplay or SCORE mode for point-based contests. - Create and edit zones through `/fokothadmin editor`, including wand selection, display names, timers, minimum players, worlds, starter items, and delete confirmations. - Keep event definitions organized in separate `koths/.yml` files instead of burying every KOTH in the main config. - Auto-start events from `schedules.yml` with clear 5-part cron timing, random KOTH selection, or all listed KOTHs. - Reward winners with console commands and item rewards, including score-mode reward targeting. - Keep players informed with configurable broadcasts, bossbars, scoreboards, holograms, and optional actionbar capture progress. - Send start, stop, capture-start, capture-end, and captured events to Discord-compatible webhooks. - Use team mode with supported team hooks when your server wants captures and wins to respect team identity.

!(https://cdn.modrinth.com/data/cached_images/d0ab3f4ecb93bc1e39ab33647d7fdfed96640495.png)

!(https://cdn.modrinth.com/data/cached_images/6b79d01b945ccd22f468d627179cc7b244de227c.png)

!(https://cdn.modrinth.com/data/cached_images/779a44307ab863c91facf8f4e7952a6168206a08.png)

!(https://cdn.modrinth.com/data/cached_images/bcf1b210f47371f35b20eac5529e76bcaf6ff520.png)

!(https://cdn.modrinth.com/data/cached_images/73dc4d032777f0091ad2e15e00e22b09496ef821.png)

!(https://cdn.modrinth.com/data/cached_images/14669d4fd9829199df92cf3e5d692eebfbff6ec0.png)

## Admin Workflow - Use the selection wand to mark both KOTH corners. - Create a KOTH with a capture or score mode. - Edit the event in the GUI browser. - Add one reward command at a time from the reward command browser. - Add schedules from the schedule browser and edit each schedule in its own GUI.

## Optional Integrations - `PlaceholderAPI` - registers FoKoTH placeholders for active events, schedules, wins, capturers, timers, and score-mode values. - Discord-compatible webhooks - send configured event notifications to webhook URLs. - Team hooks - supports Bukkit scoreboard teams and external team lookups such as BetterTeams, Towny Advanced, KingdomsX, Parties, and FoTeams.

## Commands - `/fokothadmin editor` - Open the main editor. - `/fokothadmin wand` - Get the KOTH region selection wand. - `/fokothadmin create ` - Create a KOTH from the current wand selection. - `/fokothadmin delete ` - Delete a KOTH. - `/fokothadmin start ` - Start a KOTH manually. - `/fokothadmin stop ` - Stop a running KOTH. - `/fokothadmin stopall` - Stop all running KOTH events. - `/fokothadmin schedules` - Open the schedule editor. - `/fokothadmin tp ` - Teleport to a KOTH center. - `/fokothadmin list` - List configured KOTHs. - `/fokothadmin info ` - Show KOTH status and next schedule time. - `/fokothadmin givestarter ` - Give starter items. - `/fokothadmin resetwins ` - Reset stored wins. - `/fokothadmin reload` - Reload FoKoTH. - `/fokothadmin version` - Check the installed version.

Aliases: `/fokoth` and `/koth`.

## Permissions - `fokoth.admin` - Access all FoKoTH admin commands, editor tools, wand actions, and update notices.

## Placeholders Requires PlaceholderAPI.

• `%fokoth_player_wins%` - Player KOTH win count.
• `%fokoth_team_wins%` - Current team win count.
• `%fokoth_next%` - Seconds until the next scheduled KOTH.
• `%fokoth_next_formatted%` - Formatted time until the next scheduled KOTH.
• `%fokoth_next_%` - Seconds until a specific schedule runs.
• `%fokoth_next__formatted%` - Formatted time until a specific schedule runs.
• `%fokoth__active%` - Whether a KOTH is currently active.
• `%fokoth__display_name%` - Configured display name.
• `%fokoth__world%` - KOTH center world.
• `%fokoth__x%`, `%fokoth__y%`, `%fokoth__z%` - KOTH center coordinates.
• `%fokoth__capturer%` - Current capturer display name.
• `%fokoth__timeleft%` - Capture time remaining in seconds.
• `%fokoth__timeleft_formatted%` - Formatted capture time remaining.
• `%fokoth__maxtimeleft%` - Event time remaining in seconds.
• `%fokoth__maxtimeleft_formatted%` - Formatted event time remaining.
• `%fokoth__score%` - Viewer score for score-mode KOTHs.