
Kothar
The next-generation King of The Hill plugin.
5274обновлён 18 мар. 2026 г.
Механики игрыУправлениеМини-игры
Описание
⚠️ 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
- Drop the JAR into
/plugins/ - Install Apollo-Bukkit
- Start the server to generate files
- Configure
config.ymlandmessages.yml - 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
Need help? Join Discord
Found a bug or need help? Join our Discord — we usually respond within minutes!
Последние версии
Все версии →release
Changelog v1.0.8
v1.0.818 мар. 2026 г.326Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**Performance**
- Hardcoded display update interval to 20 ticks (1 second) for consistent performance, removed display-update-ticks from config.yml
**Removals**
- Complete removal of economy system including commands: /kothar shop, /kothar rank, /kothar coins, /kothar eco, /kothar balance, /kothar pay
- Removed economy reward/loss logic from kills, deaths, captures, and wins
- Removed economy-related language entries from English, Spanish, French, Portuguese, and Russian translations
- Removed text-based leaderboard output
- Removed Top Coins category from leaderboard GUI
- Removed kothar.admin.eco permission
- Removed kothar.admin.list from admin permission children
**New Features**
- /kothar list now displays center X and Z coordinates of each KOTH zone
- Added {coords} placeholder to list format
- /kothar help now filters displayed commands based on user permissions (admins see all, users see only permitted commands)
**Improvements**
- /kothar top now always opens GUI menu instead of text output
- Changed /kothar list permission from kothar.admin.list to kothar.list (default: true, all players)
- Added kothar.playtime permission (default: true, all players)
- kothar.top permission remains default true
**Fixes**
- Fixed "no player data" display issue in leaderboard GUI
release
Changelog v1.0.7
v1.0.713 мар. 2026 г.22Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**Performance**
- Reduced zone selection particle load (slower update task + lower particle density) to help FPS during zone editing/near KOTH
- Reduced server load by optimizing scoreboard and bossbar update frequency
**Improvements**
- Added FastStats metrics support
- Added a configurable display update speed option to improve performance
**Fixes**
- Fixed /kothar start showing the wrong “Next KOTH” countdown
- Fixed “Next KOTH” hologram not being removed when deleting a KOTH
- Fixed players being able to take items from the /kothar shop GUI
- Fixed Shift+Left/Shift+Right click not working in the KOTH editor GUI
- Fixed /kothar update download issues and improved cleanup of older plugin jars
release
Changelog v1.0.6
v1.0.613 мар. 2026 г.25Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**Gameplay / Performance**
- Reduced KOTH hologram update frequency to once per second to lower FPS drops near the KOTH.
**Visual**
- Fixed black background showing on holograms for:
- KOTH hologram
- Next KOTH hologram
**Improvements**
- Next KOTH hologram now spawns only after confirming the selection with /kothar select <koth> (after both corners are selected)
- Next KOTH hologram positioning is now correctly centered for odd-sized selections (e.g. 3x3)
release
v1.0.5 — Economy Overhaul, Admin Tools, and more...
1.0.511 мар. 2026 г.24Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**New Features**
- Economies loaded from /economies/*.yml (includes default coins and xp)
- Persistent balances stored in the database via economy_balances (uuid, economy, balance)
- Admin economy management: /kothar eco <give|take|set|balance> <player><economy>
- Cancellable economy balance change event (for plugins/hooks to react to or block changes)
- Kill/death/win/capture-tick rewards can target any configurable economyId
- Configurable Top GUI for wins, captures, coins, and XP
- Reward commands now accept both %player% and {player} placeholders
- Configurable per-KOTH setting capture.disable-player-glow-in-zone to force remove glow from players while inside the KOTH zone during active games
- Auto-refreshing countdown hologram that updates every second without requiring /kothar reload
- Visual countdown display for manual starts: shows 60 second timer on Next KOTH hologram even while a KOTH is active after using /kothar start <koth>
**Improvements**
- Chat messages auto-apply the Kothar prefix while GUI messages remain unprefixed
- Paper 1.21+ compatibility updates for chat events, displays, and scoreboard objectives
- Safer offline player resolution in admin commands
- KOTH cleanup no longer globally disables glow for all online players, preventing interference with other plugins that use glow effects
- "You gained/lost" messages are now dynamic based on the configured economy (name/symbol)
- Clarified help text across all languages (EN/ES/FR/PT/RU): /kothar balance now described as player economy view, /kothar coins as admin coin management, /kothar eco as admin management for any economy
- Corrected wand hint message in all languages: changed incorrect /koth claim {koth} reference to proper /kothar select {koth} command
- Streamlined Next KOTH hologram display: removed redundant label line to show only countdown, adjusted vertical positioning (+0.8 offset) to reduce visual overlap
- Improved hologram task lifecycle: Next KOTH countdown tasks now properly start and stop on plugin enable, disable, and reload events
- Fixed scoreboard title color processing: color codes like &c&lKothar now render correctly instead of displaying raw codes
- Enhanced scoreboard number hiding with dual fallback strategy: primary method uses NumberFormat.blank() with RenderType.HEARTS as fallback when unavailable
**Bug Fixes**
- Null-safe inventory click handling across menus
- Give command no longer fails due to unreplaced placeholders
- Fixed collateral effects where ending a KOTH would remove glow from players who had it from other mechanics/plugins
- Eliminated runtime "Missing key" errors for next-koth hologram by correcting message path references to gui.hologram.next-koth.* format
- Resolved scoreboard persistence issue: ensures complete removal and restoration for all players when a KOTH ends instead of sticking indefinitely
- Strengthened inventory protection across all GUI menus: prevents item manipulation via shift-clicks, number keys, double-clicks, hotbar swaps, and drop actions for OP and regular players alike
- Fixed duplicate hologram spawning: zone configuration now defers main hologram creation and maintains Next KOTH as the active display to prevent immediate double hologram appearance
release
v1.0.4 — Capture Effects Update & Stability Fixes
1.0.42 мар. 2026 г.23Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**New Features**
- Added support for capper potion effect durations using EFFECT:LEVEL:DURATION_SECONDS in capture.capper-effects.effects.
- Effects without duration specified continue to apply indefinitely while capturing (backwards compatible)
**Improvements**
- Optimized capper effects parsing by caching parsed potion effect definitions to avoid repeated string splitting and lookups on every capture tick
- Improved update checker URL construction for GitHub API requests
**Bug Fixes**
- Improved capper effects parsing robustness (safe integer parsing for level/duration, ignoring invalid entries instead of failing).
- Fixed "Failed to check for updates. GitHub API returned 404" error when running /kothar update caused by duplicated /releases/latest in the API URL
release
v1.0.3 — Economy, Progression & Visual Overhaul
v1.0.328 февр. 2026 г.24Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
**New Features**
- Added Koth Coins economy system with /kothar pay for player trading
- Implemented Rank progression system based on XP earned from KOTHs
- Added Leaderboards for top XP and top Coins via /kothar top
- Added /kothar update command to automatically download and update the plugin from GitHub
- Added automatic update checker for GitHub releases
- Added support for Badlion and Feather Client waypoints
- Added KOTH arena linking system with team score sharing for OVERLOAD mode
**Improvements**
- KOTH barriers now use Red Stained Glass blocks for clearer visibility
- Improved GUI menus with toggle buttons and multi-page support
- All messages now support full RGB colors
- Added detailed configuration comments to help server owners
- Added immediate UI refresh triggers for scoreboard, bossbar, hologram, and actionbar
**Bug Fixes**
- Fixed capture progress resetting incorrectly when rival teams enter the zone
- Fixed holograms, scoreboards, and boss bars not spawning/updating correctly
- Fixed players remaining glowing after a KOTH finishes
- Fixed /kothar rank and /kothar coins give commands failing silently
- Fixed GUI items being movable in the shop menu
**Full Changelog:** [View on GitHub](https://github.com/marwannull/Kothar/releases/tag/v1.0.3)
release
v1.0.2 - Stability & Compatibility Update
1.0.221 февр. 2026 г.37Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
This update focuses on fixing compatibility issues with combat plugins and standardizing message configuration.
✨ **New Features**
🏆 Added MVP announcement message ( kothar.mvp-won ) for KOTH winners.
🛠️ **Improvements**
⚡ Optimized actionbar handling to prevent conflicts.
🔧 **Patches**
✅ Fixed Actionbar glitch when using DeluxeCombat (Kothar bar now pauses during combat).
✅ Fixed missing message key errors in game end logic.
release
v1.0.1 - Multi‑Language Update
v1.0.118 февр. 2026 г.18Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
A focused release to organize and expand plugin messaging with multi‑language support.
### ✨ **New Features**
- Multi‑language messages: EN/ES/RU/PT/FR packs included.
- Language selector: quick switch via config.yml.
### 🛠️ **Improvements**
- Message files reorganized into langs/ folder.
### 🔧 **Patches**
- Broadcast messages now include the prefix consistently.
alpha
Kothar 1.0.0-ALPHA
1.0.0-ALPHA16 февр. 2026 г.28Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## 🎉 First Release
### Features
- TIME, POINTS and OVERLOAD game modes
- Full GUI management system
- Scoreboard + Bossbar displays
- Apollo waypoints integration
- Discord webhook notifications
- Anti-Randy protection system
- Database support: MySQL, SQLite, H2, MongoDB
- Developer API available
### Notes
- Requires Apollo (Lunar Client API)
- PlaceholderAPI optional for placeholders