UltraKOTH++

UltraKOTHPlusPlus
An advanced King of the Hill (KOTH) plugin for Minecraft Spigot/Paper servers with extensive features including WorldGuard integration, PlaceholderAPI support, boss bars, rewards, and much more.

Features

Core Features

• Multiple KOTH Regions: Configure multiple KOTH locations with different settings
• Automatic Scheduling: Set up automatic KOTH events at regular intervals
• Boss Bar Integration: Real-time progress display with customizable boss bars
• Reward System: Configurable rewards for KOTH winners
• Player Statistics: Track wins and statistics for all players
• Sound & Particle Effects: Immersive audio and visual feedback

Integrations

• WorldGuard Support: Use WorldGuard regions for precise area control
• PlaceholderAPI Support: Extensive placeholders for other plugins
• Vault Support: Economy rewards integration

Advanced Features

• Tab Completion: Full tab completion for all commands
• Permission System: Granular permission control
• Configurable Capture Time: Set custom capture durations per event
• Debug Logging: Comprehensive logging for troubleshooting
• Data Persistence: Player statistics saved automatically

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/UltraKOTHPlusPlus/config.yml
5. Set up KOTH regions in the configuration
6. Reload the plugin or restart your server

Configuration

koth:
  capture-time-seconds: 300
  bossbar:
    enabled: true
    title: "&eKOTH being captured by &a{player}"
    color: "BLUE"
    style: "SOLID"
    countdown: true
  broadcast:
    start: "&6KOTH has started at &b{location}!"
    capture: "&a{player} &eis capturing the KOTH!"
    win: "&b{player} &ahas won the KOTH at &e{location}!"
  rewards:
    - "give {player} diamond 5"
    - "eco give {player} 1000"
  schedule:
    enabled: true
    interval-minutes: 60
koth-locations:
  example:
    world: "world"
    x: 100
    y: 65
    z: 100
    radius: 10
    region: "koth_example"

Commands

Player Commands

• /koth help – Show help message
• /koth status – Show current KOTH status
• /koth list – List all KOTH regions
• /koth wins [player] – Show KOTH wins for yourself or another player

Admin Commands

• /koth start [region] – Start a KOTH event (random if none specified)
• /koth stop – Stop the current KOTH event
• /koth reload – Reload plugin configuration

Permissions

Player Permissions

• ultrakoth.player
• ultrakoth.player.participate
• ultrakoth.player.stats

Admin Permissions

• ultrakoth.admin
• ultrakoth.admin.start
• ultrakoth.admin.stop
• ultrakoth.admin.reload
• ultrakoth.*

PlaceholderAPI Placeholders

%ultrakoth_wins% – Player's total KOTH wins
%ultrakoth_last_win% – Timestamp of player's last win
%ultrakoth_is_capturing% – True if player is currently capturing
%ultrakoth_rank% – Player's rank by wins
%ultrakoth_active% – Current active KOTH name
%ultrakoth_is_active% – True if any KOTH is active
%ultrakoth_capturing_player% – Name of player currently capturing
%ultrakoth_progress% – Current capture progress (seconds)
%ultrakoth_progress_percentage% – Capture progress as percentage
%ultrakoth_time_left% – Remaining capture time
%ultrakoth_total_time% – Total capture time required
%ultrakoth_total_players% – Total players with recorded wins
%ultrakoth_total_wins% – Total wins across all players
%ultrakoth_time_until_next% – Time until next KOTH starts
%ultrakoth_next_koth_time% – Formatted countdown to next event
%ultrakoth_top_1_name% – Name of #1 player
%ultrakoth_top_1_wins% – Wins of #1 player
%ultrakoth_top_2_name% – Name of #2 player
%ultrakoth_top_2_wins% – Wins of #2 player

How It Works

1. KOTH Start – A KOTH event begins at a configured location
2. Player Entry – Players enter the KOTH region
3. Capture Process – Player must stay in the region for the configured capture time
4. Progress Tracking – Boss bar shows progress and player info
5. Interruption – If player leaves region, capture resets
6. Victory – Player wins after full capture time and receives rewards
7. Statistics – Win recorded in player data

Troubleshooting

Common Issues

• Plugin not responding – Check logs, dependencies, syntax
• KOTH not starting – Verify world, coordinates, regions, permissions
• Boss bar not showing – Ensure enabled, correct permissions, valid capture time

Debug Mode
Enable it in config.yml:

settings:
  debug: true

Support

• Website: https://github.com/SansCraft-Network/UltraKOTHPlusPlus
• GitHub: Create an issue in the repository

License
MIT License – see LICENSE file for details.

Credits

• Author: TheOne_Player
• Organization: sanscraft.top
• Version: 1.0.0

Built with love for the Minecraft community!