Kothar

!(https://imgur.com/ntJ7Oja.png) !(https://img.shields.io/badge/version-1.0.4-brightgreen) !(https://img.shields.io/badge/java-17+-orange) !(https://img.shields.io/badge/platform-Paper%2FSpigot-brightgreen) (https://img.shields.io/discord/1272993679581384786?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/bEXHGn7vVq) # ⚠️ Requirement **This plugin requires (https://modrinth.com/plugin/lunar-client-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 (https://modrinth.com/plugin/lunar-client-apollo) 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 ` | 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 (https://modrinth.com/plugin/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> ``` ### 📖 (https://github.com/joumoederx17/KotharAPI) <div align="center"> ### Need help? (https://discord.gg/bEXHGn7vVq) Found a bug or need help? Join our Discord — we usually respond within minutes! </div>