FoKoTH

!FoKoTH cover image

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/<id>.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.

!Fokoth Koth Edit !Fokoth Main Editor !Fokoth Reward Commands !Fokoth Schedule Browser !Fokoth Schedule Edit

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 <name> <CAPTURE|SCORE> - Create a KOTH from the current wand selection.
• /fokothadmin delete <name> - Delete a KOTH.
• /fokothadmin start <name> - Start a KOTH manually.
• /fokothadmin stop <name> - Stop a running KOTH.
• /fokothadmin stopall - Stop all running KOTH events.
• /fokothadmin schedules - Open the schedule editor.
• /fokothadmin tp <name> - Teleport to a KOTH center.
• /fokothadmin list - List configured KOTHs.
• /fokothadmin info <name> - Show KOTH status and next schedule time.
• /fokothadmin givestarter <koth> <player> [amount] - Give starter items.
• /fokothadmin resetwins <player> - 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_<schedule>% - Seconds until a specific schedule runs.
• %fokoth_next_<schedule>_formatted% - Formatted time until a specific schedule runs.
• %fokoth_<koth>_active% - Whether a KOTH is currently active.
• %fokoth_<koth>_display_name% - Configured display name.
• %fokoth_<koth>_world% - KOTH center world.
• %fokoth_<koth>_x%, %fokoth_<koth>_y%, %fokoth_<koth>_z% - KOTH center coordinates.
• %fokoth_<koth>_capturer% - Current capturer display name.
• %fokoth_<koth>_timeleft% - Capture time remaining in seconds.
• %fokoth_<koth>_timeleft_formatted% - Formatted capture time remaining.
• %fokoth_<koth>_maxtimeleft% - Event time remaining in seconds.
• %fokoth_<koth>_maxtimeleft_formatted% - Formatted event time remaining.
• %fokoth_<koth>_score% - Viewer score for score-mode KOTHs.