🏔️ JelloKoth — King of the Hill

A modern, fully customizable King of the Hill plugin for Paper 1.21.x. Players (or entire teams) compete to hold a zone for a set time and win rewards. No fluff, no bloat — just a clean, powerful KOTH that works.

---

⚔️ How it Works

1. Set up a zone with the wand
2. Players stand inside to capture it
3. First to hold it long enough wins
4. Rewards are handed out automatically

---

✨ Features

Capture

• Solo OR team-based capture — toggle per KOTH
• Configurable capture time (5 seconds to 5+ hours)
• Pause when contested (multiple players stop progress)
• Knockout on damage — getting hit freezes your progress briefly
• Empty timeout — event cancels if nobody shows up

Teams

• Works with AdvancedTeams, UltimateTeams, BetterTeams, and any team plugin with a PlaceholderAPI placeholder
• Whole team captures and wins together
• Stats still tracked per player

Rewards

• Placement rewards — 1st, 2nd, 3rd place
• Percentage rewards — everyone who contributed enough gets rewarded
• Chance rolls — optional % chance per reward
• Money payouts via Vault (works with EssentialsX)
• Custom commands, items and messages per reward

Scheduling

• Manual, interval (every X seconds) or set times (HH:mm)
• Random rotation — auto-starts a random KOTH every X hours
• Pre-start warnings broadcast to the server

Notifications

• Fully configurable per event (start, win, cancel, stop, warning)
• Chat, title, action bar, sound and custom console commands
• Great for routing through EssentialsX /broadcast

Display

• BossBar, scoreboard sidebar, floating hologram
• Particle zone border
• MiniMessage support everywhere (gradients, hex colours)
• Legacy & colour codes auto-converted

Stats & Leaderboards

• Tracks wins, captures, points and time held per player
• GUI leaderboard with player heads
• PlaceholderAPI placeholders for external scoreboards

GUI

• Manage everything in-game with /koth gui — no config editing required
• Per-KOTH editor, settings menu, notification toggles and leaderboard

Other

• Up to 10 KOTHs running simultaneously
• PlaceholderAPI expansion included
• Vault / EssentialsX economy integration
• Stored in YAML — no database required
• Public domain (Unlicense) — free to use, modify and redistribute

---

🖥️ Commands

Command	Description
/koth gui	Open the management menu
/koth list	List all KOTHs and their status
/koth create <name>	Create a new KOTH
/koth delete <name>	Delete a KOTH
/koth wand	Get the region selection wand
/koth setregion <name>	Save your wand selection
/koth start <name>	Start a KOTH now
/koth stop <name>	Stop a running KOTH
/koth next	Show the next scheduled auto-start
/koth stats [player]	View player stats
/koth top	View the leaderboard
/koth reload	Reload config and messages

Aliases: /jkoth, /jellokoth

---

🔧 Setup

1. Drop the jar in /plugins
2. Restart your server
3. Run /koth create <name>
4. Run /koth wand, select two corners, then /koth setregion <name>
5. Run /koth start <name> or set a schedule

Everything else can be configured in /koth gui or in the plugin's YAML files.

---

📦 Soft Dependencies

• PlaceholderAPI — team resolution + external placeholders
• Vault — money rewards (works with EssentialsX and most economy plugins)
• AdvancedTeams / UltimateTeams / BetterTeams — team capture support

None of these are required. The plugin works standalone.