# ⚔️ SiveKoth - King of the Hill

**SiveKoth** is a powerful and feature-rich King of the Hill (KOTH) plugin designed for Minecraft 1.21+ servers running Paper/Purpur. Create exciting PvP events where players compete to control a zone and earn rewards!

---

## ✨ Features

### 🎮 Two Game Modes
- **CAPTURE Mode** - Hold the zone for a set amount of time to win
- **SCORE Mode** - Earn points by staying in the zone, highest score wins

### 🖥️ Intuitive GUI Editor
- Easy-to-use graphical interface for arena management
- Create, edit, and delete arenas without commands
- Visual arena status indicators

### ⏰ Automatic Scheduler
- Schedule events using cron expressions
- Configurable timezone support
- Per-arena scheduling options

### 📊 Display Systems
- **BossBar** - Real-time event progress display
- **Scoreboard** - Dynamic event information
- **Holograms** - Using Text Display entities (no dependencies!)
- All displays are fully customizable

### 🎁 Reward System
- Item rewards with custom NBT data
- Command execution support
- Per-placement rewards (1st, 2nd, 3rd)
- Custom enchantments and lore

### 📈 Statistics & Leaderboards
- Track wins, captures, time in zone, and kills
- SQLite and MySQL database support
- Top players hologram display

### 🔌 PlaceholderAPI Integration
- `%sivekoth_wins%` - Player's total wins
- `%sivekoth_captures%` - Player's total captures
- `%sivekoth_time%` - Time spent in zones
- `%sivekoth_kills%` - Kills in zones
- `%sivekoth_top_<position>_name%` - Top players
- `%sivekoth_arena_<name>_status%` - Arena status
- And more!

### ⚔️ Combat Features
- **Knockout System** - Timer resets when attacked
- Configurable knockout duration
- Fair PvP mechanics

### 🎨 MiniMessage Support
- Modern MiniMessage formatting
- Gradient colors support
- Fully customizable messages

---

## 📋 Commands

| Command | Description |
|---------|-------------|
| `/koth` | Main command |
| `/koth create <name>` | Create new arena |
| `/koth delete <name>` | Delete arena |
| `/koth start <name>` | Start event |
| `/koth stop <name>` | Stop event |
| `/koth wand` | Get selection wand |
| `/koth gui` | Open arena manager |
| `/koth reload` | Reload configuration |

---

## 🔧 Permissions

| Permission | Description |
|------------|-------------|
| `sivekoth.admin` | Full admin access |
| `sivekoth.use` | Basic usage |
| `sivekoth.create` | Create arenas |
| `sivekoth.delete` | Delete arenas |
| `sivekoth.start` | Start events |
| `sivekoth.stop` | Stop events |
| `sivekoth.gui` | Access GUI |
| `sivekoth.wand` | Use selection wand |

---

## 📥 Requirements

- **Minecraft**: 1.21+
- **Server**: Paper/Purpur
- **Java**: 21+
- **Optional**: PlaceholderAPI

---

## 💡 Quick Start

1. Download and place the plugin in your `plugins` folder
2. Start your server
3. Use `/koth wand` to get a selection wand
4. Select your capture zone (left-click pos1, right-click pos2)
5. Use `/koth create <name>` to create an arena
6. Use `/koth start <name>` to begin the event!

---

## 🌐 Support

- **Discord**: [Join our community](#)
- **Issues**: Report bugs on GitHub

---

*Made with ❤️ by SiveCraft*