Quick Navigation

KothWars@v1.11.0:~$ CONNECTING...

KothWars v1.11.0

Complete Documentation

The ultimate KOTH plugin for Minecraft servers. Advanced GUI, web API, real-time tracking, rewards system, scheduling, and stunning visual effects.

Web API Integration
Smart Alert System
9 Reward Slots
bStats Analytics

Admin GUI

Permissions

Main: kothwars.admin includes:
• kothwars.reload - Reload config
• kothwars.start - Start KOTHs
• kothwars.stop - Stop KOTHs
• kothwars.remove - Remove KOTHs
• kothwars.headcache - Manage head cache

Main Menu Items

Capture Time
Seconds to capture
Schedule
Auto-start times
Rewards
9 configurable slots
Outline
Glow colors
Start/Stop
Toggle event
Auto Suspend
Inactivity timer
1

Access

Command: /koth opens the main admin GUI

API Developer

DEV

KothWars Public API

Extend and integrate KothWars with your own plugins using our complete API system.

KothWars API Repository

Access the complete API source code, documentation, and examples

Maven
<repository>
  <id>jitpack.io</id>
  <url>https://jitpack.io</url>
</repository>

<dependency>
  <groupId>com.github.zcrys</groupId>
  <artifactId>KothWars-Api</artifactId>
  <version>1.0.1</version>
</dependency>
Gradle
repositories {
  maven { url 'https://jitpack.io' }
}

dependencies {
  implementation 'com.github.zcrys:KothWars-Api:1.0.1'
}

Features

  • Complete KothAPI interface
  • Event-driven architecture
  • KothListener system
  • Real-time KOTH data access
  • Capture progress tracking
  • Player interaction events
  • Reward system integration
  • Schedule management
  • Glow effect control
  • Zone detection API
Access API Repository

Quick Example

public class MyKothListener implements KothListener {
    @Override
    public void onCaptureComplete(Koth koth, Player player, int rewardsCount) {
        Bukkit.broadcastMessage(player.getName() + " captured " + koth.getName());
        // Your custom logic here
    }
}
// Register your listener
KothAPI api = (KothAPI) Bukkit.getServicesManager().getRegistration(KothAPI.class).getProvider();
api.registerListener(new MyKothListener());

Reward System

9 SLOTS

9 Configurable Reward Slots

Each KOTH has 9 independent reward slots that can be individually configured.

1
Slot 20
2
Slot 21
3
Slot 22
1

Adding Rewards

In the rewards menu, click on any slot to configure:

  • Left Click: Change display item material
  • Right Click: Add a new command
  • Shift + Right Click: Remove last command
  • Middle Click: Toggle slot active/inactive
    • 2

    Command Format

    Commands are executed from console. Use %player% for the winner:

    give %player% diamond 64
    eco give %player% 1000
    lp user %player% parent add vip
    3

    Execution Modes

    Two modes available via the menu:

  • Execute All: Runs commands from ALL active slots
  • Specific: Only runs from manually selected slots
  • Order: Sequential (slots 1-9) or Random shuffle

    • Configuration

    Database

    Supports SQLite (default) and MySQL for multi-server networks.

    1

    Banned Items

    Prevent players from entering KOTH zones with specific items. Useful for competitive balance. 

    # Items prohibidos en zonas KOTH
# Los jugadores serán expulsados si tienen estos items
banned-items:
  - ELYTRA      # No flying in KOTH
  - ENDER_PEARL  # No teleporting
  - CHORUS_FRUIT # No random teleports
  - SHIELD       # Optional: disable shields

    Players caught with banned items are ejected with particle effects, sounds, and a warning message.

    2

    Alert Sounds

    Configure the dramatic sounds when a capture is imminent: 

    sounds:
  sound1: ENTITY_ENDER_DRAGON_AMBIENT
  sound2: ENTITY_EVOKER_PREPARE_ATTACK
  sound3: ITEM_FIRECHARGE_USE
  volume: 0.5
  pitch: 1.0
    3

    Default Timezone

    Set the default timezone for all new KOTHs: 

    default-timezone: 'America/El_Salvador'
# Examples: America/New_York, Europe/London, Asia/Tokyo

    Placeholder System

    PlaceholderAPI Required

    All placeholders require PlaceholderAPI to be installed.

    KOTH Information

    Replace NAME with your KOTH name

    %kothwars_capturer_NAME%
    %kothwars_capturing_NAME%
    %kothwars_progress_NAME%
    %kothwars_active_NAME%
    %kothwars_time_NAME%

    Glow System

    Player's current glow color

    %kothwarsglow_color%
    %kothwarsglow_hex%
    %kothwarsglow_hex_no_hash%

    Auto Suspension

    How it Works

    Automatically stops a KOTH after configured seconds of inactivity. Prevents wasted server resources on empty events.

    1

    Configuration

    In the KOTH menu, find the funnel icon. Default: 300 seconds (5 minutes). Minimum: 30 seconds, Maximum: 1800 seconds (30 minutes).

  • Left click: +30 seconds
  • Right click: -30 seconds
    • 2

    Reactivation

    Suspended KOTHs can be restarted:

  • Manually via /koth start
  • From GUI (Start button)
  • Automatically by schedule