Kothar

Discord

⚠️ Requirement

This plugin requires Apollo (Lunar Client API) to function.

Overview

A modern, professional KOTH system with competitive modes, full GUI management, advanced displays, and deep customization. Built for performance and ready for integrations.

⭐ Features

- 🎮 Developer API TIME, POINTS and OVERLOAD - 🖥️ Developer API - 📊 Developer API - 🗺️ Developer API via Apollo (Required) - 👥 Developer API + Placeholders - 💬 Developer API Automatic notifications via Webhooks - 🛡️ Developer API Integrated playtime protection - 🌐 Developer API + Multi-Language - 🗄️ Developer API MySQL, SQLite, H2 and MongoDB - ⚙️ Developer API Rewards & Settings - 🧩 Developer API

📋 Requirements

- ☕ Java 17+ - 🟩 Spigot/Paper 1.20+ (latest Paper recommended) - 🚀 Apollo-Bukkit (Required)

📥 Installation

1. Drop the JAR into `/plugins/` 2. Install Apollo-Bukkit 3. Start the server to generate files 4. Configure `config.yml` and `messages.yml` 5. Restart the server

💻 Commands

| Command | Description | |---------|-------------| | `/kothar help` | Shows the help menu | | `/kothar info <name>` | Displays detailed info about a KOTH | | `/kothar list` | Lists all KOTHs and their status | | `/kothar top` | Shows top players by wins | | `/kothar playtime [player]` | Checks playtime (anti-randy) | | `/kothar create <name>` | Creates a new KOTH | | `/kothar delete <name>` | Deletes a KOTH | | `/kothar start <name>` | Starts a KOTH | | `/kothar stop <name>` | Stops a KOTH | | `/kothar reload` | Reloads the plugin configuration | | `/kothar gui` | Opens the main GUI | | `/kothar select <name>` | Enables zone selection for a KOTH | | `/kothar setzone <name> <color>` | Sets an OVERLOAD zone color | | `/kothar debug <name>` | Shows debug visuals for the KOTH zone(s) |

🔑 Permissions

| Permission | Description | |------------|-------------| | `kothar.admin` | Full admin access | | `kothar.admin.create` | Create KOTHs | | `kothar.admin.delete` | Delete KOTHs | | `kothar.admin.start` | Start KOTHs | | `kothar.admin.stop` | Stop KOTHs | | `kothar.admin.select` | Select zones for a KOTH | | `kothar.admin.reload` | Reload plugin config | | `kothar.admin.gui` | Open the admin GUI | | `kothar.admin.list` | List all KOTHs | | `kothar.admin.setzone` | Set OVERLOAD zones by color | | `kothar.top` | View top players list | | `kothar.info` | View KOTH info | | `kothar.bypass.antirandys` | Bypass anti-randys checks |

📌 Placeholders

Requires PlaceholderAPI (Optional).

| Placeholder | Description | |-------------|-------------| | `%kothar_active%` | Name of the active KOTH | | `%kothar_capturer%` | Current capturer name | | `%kothar_time%` | Remaining time of the active KOTH | | `%kothar_progress%` | Progress (%) of the active KOTH | | `%kothar_location%` | Location of the active KOTH | | `%kothar_wins%` | Player wins | | `%kothar_captures%` | Player captures | | `%kothar_top_<pos>%` | Top entry format by wins at position | | `%kothar_top_<pos>_name%` | Player name at top position | | `%kothar_top_<pos>_wins%` | Wins at top position | | `%kothar_top_<pos>_captures%` | Captures at top position | | `%kothar_next%` | Next scheduled KOTH name | | `%kothar_next_time%` | Time remaining for next scheduled KOTH |

🛠️ Developer API

Gradle (Kotlin DSL)

```kotlin repositories { maven { url = uri("https://jitpack.io") } }

dependencies { compileOnly("com.github.jou-dev:KotharAPI:1.0.0-ALPHA") } ```

Maven

```xml <repository> <id>jitpack.io</id> <url>https://jitpack.io</url> </repository> <dependency> <groupId>com.github.jou-dev</groupId> <artifactId>KotharAPI</artifactId> <version>1.0.0-ALPHA</version> <scope>provided</scope> </dependency> ```

📖 View full API documentation