Перейти к содержимому
Mineforgian

Kothar

The next-generation King of The Hill plugin.

Загрузки
230
Подписчики
4
Обновлён
18 марта 2026 г.
Лицензия
MIT

Опубликован 16 февраля 2026 г.

kothar-banner Version Java Platform 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

  • 🎮 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

Need help? Join Discord

Found a bug or need help? Join our Discord — we usually respond within minutes!

Ченджлог

v1.0.8Релиз1.21.9, 1.21.10, 1.21.11 · 18 марта 2026 г.

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
v1.0.7Релиз1.21.9, 1.21.10, 1.21.11 · 13 марта 2026 г.

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
v1.0.6Релиз1.21.9, 1.21.10, 1.21.11 · 13 марта 2026 г.

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 (after both corners are selected)
  • Next KOTH hologram positioning is now correctly centered for odd-sized selections (e.g. 3x3)
1.0.5Релиз1.21.9, 1.21.10, 1.21.11 · 11 марта 2026 г.

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>
  • 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

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
1.0.4Релиз1.21.9, 1.21.10, 1.21.11 · 2 марта 2026 г.

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
v1.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 28 февраля 2026 г.

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

1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 21 февраля 2026 г.

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.

v1.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 18 февраля 2026 г.

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.

Комментарии

Загружаем…