⚠️ 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

• 🎮 Multiple Modes: TIME, POINTS and OVERLOAD
• 🖥️ Full GUI Management
• 📊 Scoreboard + Bossbar Displays
• 🗺️ Waypoints via Apollo (Required)
• 👥 Team/Clan Support + Placeholders
• 💬 Discord Integration: Automatic notifications via Webhooks
• 🛡️ Anti-Randy: Integrated playtime protection
• 🌐 Fully Editable Messages + Multi-Language
• 🗄️ Database Support: MySQL, SQLite, H2 and MongoDB
• ⚙️ Highly Configurable 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)

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

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

Maven

<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