ApexKoth

ApexKOTH
The Ultra-Professional King of the Hill Plugin
Modern visuals, 100% customizable, and zero chat spam.

Introduction
Tired of old, buggy KOTH plugins that spam your chat and rely on ancient, confusing configuration?
ApexKOTH is a brand new, lightweight, and modern solution built from the ground up for performance, ease of use, and a professional server experience.

It provides the classic King of the Hill gameplay your players love while adding powerful, modern features that server owners demand. From its smart anti-spam logic to its automatic scheduler and clean visuals, ApexKOTH is designed to be the last KOTH plugin you'll ever need.

⚙️ Core Features

Dynamic Visuals (Boss Bar + Action Bar)

No more clutter!
A dynamic Boss Bar (visible only to players in the KOTH zone) shows the total remaining lifetime, while a clean Action Bar displays capture progress only to the active player.

⏳ KOTH Max Duration (Lifetime)

Each KOTH has a configurable max duration (e.g., 20 minutes).
If nobody captures it in time, the event ends automatically with no winner — preventing endless or “stuck” KOTHs.

Advanced Automatic Scheduler

Set it and forget it!
The built-in scheduler can start KOTHs automatically every few hours, with configurable:

• Interval (e.g., every 120 minutes)
  
  
• Minimum player requirement
  
  
• Pre-start warning messages
  
  
• Randomized KOTH selection
  

100% Customizable Messages

Every message, prefix, and visual text is editable in messages.yml.
Easily translate or brand the plugin for your server’s style.

Universal Reward System

The rewards.yml file supports unlimited reward packages.
ApexKOTH executes console commands directly, so it works with any economy, crate, or permissions plugin — including Essentials, CMI, UltraEconomy, and more.

Intelligent Anti-Spam Logic

Only the important events are announced globally:

• KOTH start
  
  
• KOTH end (by capture or timeout)
  
  
• Capture relay (when ownership changes)
  

No more repetitive “player entered/left zone” spam.

Professional “Soulbound” Admin Wand

The /koth wand command gives you a smart, secure selection tool that:

• Can’t be dropped, stored, or moved
  
  
• Automatically disappears after setting both positions
  

Flexible Time Formats

No need to calculate seconds — commands like /koth create and /koth setduration accept:


1h30m, 20m, 45s, or numeric values (e.g., 300)

Full PlaceholderAPI Support

Integrate ApexKOTH into your existing plugins using placeholders like:

• %apexkoth_time_left%
  
  
• %apexkoth_lifetime_left%
  
  
• %apexkoth_capper%
  
  
• %apexkoth_koth_name%
  

⚡ Lightweight & Performant

Built with clean, modern code for minimal impact on server TPS.
ApexKOTH runs smoothly even on high-population servers.

5-Minute Setup Guide
Step 1: Get the Wand
Use:


/koth wand

• Left-click a block → Set Position 1
  
  
• Right-click a block → Set Position 2
  
  
• The wand disappears once both are set
  

Step 2: Create the KOTH

/koth create <name> [capture_time]
Example:


/koth create Arena 5m
Creates a KOTH named Arena that takes 5 minutes to capture.

Step 3: Set Max Duration (Optional)

/koth setduration Arena 30m
Makes the KOTH auto-cancel after 30 minutes if uncaptured.

Step 4: Set the Reward (Optional)

After adding a reward in rewards.yml, link it with:


/koth setreward Arena legendary

Step 5: Start It

Start manually with:


/koth start Arena
or let the Scheduler start it automatically!

Capture Logic (Relay System)

ApexKOTH uses a single-capper relay system:

• The first player entering becomes the capper.
  
  
• If they leave and others remain, one is randomly chosen as the new capper.
  
  
• If the zone empties completely, progress resets.
  
  
• When a new capper takes over, a “relay” announcement is broadcast.
  

Commands & Permissions

Admin Commands (Permission: apexkoth.admin.<command>)
Command Description

/koth create <name> [time] Creates a new KOTH using your wand selection.
/koth delete <name> Deletes a KOTH. Stops it first if active.
/koth wand Gives the soulbound KOTH selection wand.
/koth start <name> Force-starts a KOTH event.
/koth stop Force-stops the active KOTH.
/koth setduration <koth> <time> Sets a custom max duration.
/koth setreward <koth> <package> Links a KOTH to a reward from rewards.yml.
/koth reload Reloads all configs and restarts the scheduler.

User Commands (Default Permissions)
Command Description

/koth schedule Check when the next KOTH starts.
/koth feedback <message> Send feedback directly to the developer.
⚙️ Configuration Files

config.yml
Simple and powerful configuration that includes:

• Default capture and lifetime durations
  
  
• Scheduler interval, warnings, and player requirements
  
  
• Custom wand material, name, and lore
  

messages.yml
All messages are fully translatable and customizable, including:

• Broadcasts (start, stop, win, timeout)
  
  
• Action bar and boss bar messages
  
  
• Error and admin feedback messages
  

rewards.yml
Create unlimited reward packages compatible with any economy, crate, or permission plugin.

Example:


legendary:
commands:
- "eco give %player% 50000"
- "crate key give %player% legendary 1"
- "give %player% netherite_block 1"

PlaceholderAPI Placeholders

Placeholder Description

%apexkoth_status% Shows "Inactive", "Capturing", etc.
%apexkoth_capper% Displays the capturing player’s name.
%apexkoth_koth_name% Name of the current KOTH.
%apexkoth_time_left% Time left to complete capture.
%apexkoth_lifetime_left% Time remaining before KOTH ends.
Dependencies

• Required: None
  
  
• Optional: PlaceholderAPI (for placeholders)
  

Future Updates

We’re continuously improving ApexKOTH with new features, optimizations, and integrations.
Every aspect of the plugin — including messages, rewards, and configuration — can be customized inside the ApexKOTH folder to match your server perfectly.

Our goal is to keep ApexKOTH as professional, lightweight, and easy-to-use as possible.

Thank You

Thank you for choosing ApexKOTH!
If you have questions or suggestions, you can send them directly in-game using:

/koth feedback <message>