PhantomKoth v1.0

PhantomKoth
A lightweight, high-performance King of the Hill plugin
Paper 1.21+ · Folia Support · Java 21

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Features

• Two Game Modes — Score mode (accumulate points) and Capture mode (hold the zone to win)
• GUI Arena Editor — Create, configure, and manage arenas entirely through an in-game GUI
• Cron Scheduler — Automate events with 5-field cron expressions (e.g. every hour, weekdays at noon)
• BossBar Display — Fully configurable live BossBar with view distance and world filtering
• Leaderboard System — Time-windowed leaderboards: hourly, daily, weekly, monthly, and all-time
• Reward System — Run custom commands for 1st, 2nd, 3rd place (and beyond)
• Multi-Database — SQLite, MySQL, H2, and PostgreSQL with HikariCP connection pooling
• 20+ Placeholders — Full PlaceholderAPI integration for scoreboards, holograms, and tab
• Wand Selection — WorldEdit-style region selection tool built in
• Concurrent Events — Run multiple KOTH events simultaneously across different arenas
• Folia Support — Region-threaded scheduling for full Folia compatibility
• Fully Configurable Messages — MiniMessage formatting with gradients, colors, and full customization

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Game Modes

Score Mode
Players earn 1 point per second while standing alone on the hill. The first player to reach the score target wins. If multiple players are on the hill, the zone is contested and nobody scores.

Capture Mode
Hold the zone uncontested to fill a capture bar. If you leave or get contested, progress resets. First player to fill the bar wins. Live capture progress is shown on the BossBar.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

/koth create <name> Create a new arena
/koth delete <name> Delete an arena
/koth start <name> Start an event
/koth stop [name] Stop event(s)
/koth wand Get selection wand
/koth set <arena> <prop> <value> Configure arena properties
/koth list List all arenas
/koth editor [arena] Open GUI editor
/koth leaderboard [arena] [time] View leaderboards
/koth schedule <arena> <action> Manage cron schedules
/koth reload Reload configuration

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

phantomkoth.admin Full admin access (create, delete, start, stop, set, reload)
phantomkoth.editor Open the GUI arena editor
phantomkoth.info View arena list
phantomkoth.leaderboard View leaderboards

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

PlaceholderAPI

20+ placeholders for full integration with scoreboards, holograms, and tab plugins.

Active Session:
%phantomkoth_active_<arena>_status% Event status
%phantomkoth_active_<arena>_time% Time remaining
%phantomkoth_active_<arena>_mode% Game mode
%phantomkoth_active_<arena>_score% Your score
%phantomkoth_active_<arena>_capturer% Current capturer
%phantomkoth_active_<arena>_capture_progress% Capture progress %
%phantomkoth_active_<arena>top<n>_name% Top N player name (1-10)
%phantomkoth_active_<arena>top<n>_score% Top N player score (1-10)

Leaderboard (timeframes: hourly, daily, weekly, monthly, all):
%phantomkoth_lb_<timeframe>_<n>_name% #N player name
%phantomkoth_lb_<timeframe>_<n>_score% #N total score
%phantomkoth_lb_<timeframe>_<n>_wins% #N total wins

Player Stats:
%phantomkoth_stats_<timeframe>_score% Your total score
%phantomkoth_stats_<timeframe>_wins% Your total wins
%phantomkoth_stats_<timeframe>_participations% Your participations

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Database Support

All leaderboard and stats data is stored with your choice of database:

• SQLite — Zero-config, works out of the box (default)
• MySQL — For shared/network setups
• PostgreSQL — Enterprise-grade option
• H2 — Lightweight embedded alternative

All connections use HikariCP pooling for high performance.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Cron Scheduling

Schedule events to start automatically using standard cron expressions:

/koth schedule arena1 add 0 * * * * Every hour
/koth schedule arena1 add 0 18 * * * Daily at 6pm
/koth schedule arena1 add 0 12 * * 1-5 Weekdays at noon
/koth schedule arena1 add */30 * * * * Every 30 minutes

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements

• Paper 1.21.1+ or Folia
• Java 21+
• PlaceholderAPI (optional — needed for placeholders)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Developed by JavaTwyx & baldzikaa
If you enjoy PhantomKoth, leave a review — it helps a lot!