FoKoTH

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.

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.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoKoTH</artifactId>
  <version>1.7</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foKoTH.api.FoKothApi;
import me.foesio.foKoTH.api.event.FoKothCaptureEndEvent;

FoKothApi api = Bukkit.getServicesManager().load(FoKothApi.class);
if (api != null) api.hills();

@EventHandler
public void onFoKothCaptureEndEvent(FoKothCaptureEndEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}