🏔️ 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.