{"id":165502,"date":"2026-06-09T20:48:19","date_gmt":"2026-06-09T17:48:19","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/"},"modified":"2026-06-09T20:48:19","modified_gmt":"2026-06-09T17:48:19","slug":"velkoth","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/","title":{"rendered":"VelKoth"},"content":{"rendered":"
\n

\"VelKoth<\/p>\n

# VelKoth<\/p>\n

A modern, high-performance **King of the Hill (KoTH)** plugin built for PaperMC 1.21+ utilizing Java 21 features. <\/p>\n

VelKoth supports multiple capture modes (`CAPTURE` and `SCORE`), O(1) mathematical region boundary checks for supreme performance, an automated integrated scheduler, and a robust configurable database-backed reward and statistics system.\n<\/p><\/div>\n

## \ud83d\ude80 Features<\/p>\n

– **Modern Architecture**: Compiled against Paper 1.21+ using Java 21, **Folia-supported Regional\/Entity Schedulers**, and the Incendo Cloud V2 native Brigadier command framework.
\n– **Multiple Capture Modes**:
\n – `CAPTURE`: Traditional KoTH where one player must hold the hill uninterrupted for the duration.
\n – `SCORE`: Point-based KoTH where players accumulate capture seconds until they reach the target score.
\n– **High Performance Regions**: Both Cuboid and Cylinder regions utilise O(1) containment algorithms removing loop-based block checks for zero server TPS impact.
\n– **Team Plugin Integrations**: Fully supports team and faction capturing! Players in the same team, faction, or party can capture hills together without contesting. Supports 12+ plugins natively.
\n– **Advanced Display Visuals**: Leverages modern Paper Adventure API to push ActionBars, custom BossBars, on-screen Titles, Particle effects, and Sounds. Includes **FastBoard-powered Scoreboards** (with smart-overrides for plugins like TAB and SimpleScore) and native **Paper TextDisplay Holograms** that are fully chunk-safe.
\n– **Robust Storage System**: Fully asynchronous SQLite\/MySQL HikariCP connection pooling storing player total wins, daily wins, and weekly wins.
\n– **bStats Metrics Integration**: Uses anonymous metrics tracking to keep developers informed on adoption rates and usage.
\n– **Scheduler Integration**: Define exactly when specific arenas should run via Cron-like syntax or simple time formats. Now supports **Dynamic Scheduling** via in-game commands.
\n– **Dynamic Configuration**: Built on Okaeri Configs for instant YAML hot-reloading. Every system message, GUI layout, and internal setting can be modified.
\n– **Comprehensive Rewards**: Execute commands, distribute ItemStacks (with overflow drop handling), or give Vault Economy money to the winners.
\n– **Enhanced PlaceholderAPI**: Comprehensive support for multi-arena events, absolute\/specific next event countdowns, and human-readable time formatting.
\n– **Developer API**: Features a full suite of Bukkit Events (`KothStartEvent`, `KothWinEvent`, `KothCaptureStartEvent`, etc.) and a static `VelKothAPI` state accessor for developers.<\/p>\n

—<\/p>\n

## \u2699\ufe0f Dependencies<\/p>\n

– **PaperMC** 1.21.x+
\n– **Java 21**
\n– Vault *(Optional – Required for Economy rewards)*
\n– PlaceholderAPI *(Optional – Exposes extensive placeholders)*
\n – `%koth_arena[_]%`, `%koth_time[_formatted][_]%`
\n – `%koth_owner[_]%`, `%koth_players[_]%`
\n – `%koth_next_arena[_]%`, `%koth_next_time[_formatted][_]%`
\n– **Supported Team Plugins** *(Optional – Allows team members to capture together)*
\n – BetterTeams, Factions (UUID\/Saber), GangsPlus, Guilds, KingdomsX
\n – SuperiorSkyblock2, Towny Advanced, UltimateClans, Parties, AxParties
\n – LandClaimPlugin (Custom hook)<\/p>\n

—<\/p>\n

## \ud83d\udee0\ufe0f Usage & Setup<\/p>\n

### Creating an Arena<\/p>\n

1. Grab the KoTH Wand by typing `\/koth wand`.
\n2. Left-Click one corner of your hill, and Right-Click the opposite corner.
\n3. Type `\/koth create ` to save the region.
\n4. Modify specific rules, timers, and rewards for this arena in the generated `plugins\/VelKoth\/arenas.yml` configuration!<\/p>\n

### Administering Events<\/p>\n

– Start an event manually: `\/koth start `
\n– Pause an ongoing event (maintaining times\/scores): `\/koth pause `
\n– Stop an event completely: `\/koth stop `
\n– Configure automatic daily\/weekly events in `plugins\/VelKoth\/config.yml`.<\/p>\n

—<\/p>\n

## \ud83e\udea7 Commands<\/p>\n

VelKoth features a robust, auto-completing Brigadier command hierarchy.<\/p>\n

| Command | Permission | Description |
\n| :— | :— | :— |
\n| `\/koth help` | `velkoth.use` | View available commands |
\n| `\/koth stats` | `velkoth.use` | View your personal KoTH wins (Daily\/Weekly\/All-time) |
\n| `\/koth next ` | `velkoth.use` | See when is the next Koth gonna start |
\n| `\/koth list` | `velkoth.admin` | View all arenas and their current status |
\n| `\/koth wand` | `velkoth.admin` | Receive the region selection wand |
\n| `\/koth create ` | `velkoth.admin` | Create a new arena from your wand selection |
\n| `\/koth delete ` | `velkoth.admin` | Permanently delete an arena |
\n| `\/koth start ` | `velkoth.admin` | Force start an arena immediately |
\n| `\/koth pause ` | `velkoth.admin` | Pause an active capture session |
\n| `\/koth resume ` | `velkoth.admin` | Resume a paused capture session |
\n| `\/koth stop ` | `velkoth.admin` | Stop an active arena prematurely |
\n| `\/koth schedule add

—<\/p>\n

## \ud83c\udf81 Rewards<\/p>\n

VelKoth supports a powerful reward system that can be managed entirely in-game or via `arenas.yml`. Rewards are granted to the winning player (or all online members of a team\/faction if team hooks are active).<\/p>\n

### Supported Reward Types<\/p>\n

| Type | Format | Example |
\n| :— | :— | :— |
\n| **Command** | `COMMAND:` or `` | `COMMAND:give %player% netherite_ingot 1` |
\n| **Economy** | `ECONOMY:` | `ECONOMY:1000` (Requires Vault) |
\n| **Item** | `ITEM:[:]` | `ITEM:GOLD_BLOCK:3` |<\/p>\n

### Reward Placeholders
\n* `%player%`: Name of the winner.
\n* `%arena%`: ID of the arena.<\/p>\n

### Viewing Rewards
\nYou can see exactly what rewards are configured for an arena using:
\n` \/koth reward list `
\nThis will display a numbered list of rewards with human-readable descriptions (e.g., *Command: give diamond 1*).<\/p>\n

—<\/p>\n

## \ud83d\udcdc Permissions<\/p>\n

– **`velkoth.use`**: Default permission granted to all players allowing them to view help and check their personal statistics.
\n– **`velkoth.admin`**: Default OP permission granting full administrative access to edit arenas, bypass timers, and trigger events.<\/p>\n

—<\/p>\n

## \ud83d\udce6 Building from Source<\/p>\n

To compile the standalone shadow JAR natively (including the Cloud command libraries and Okaeri configs):<\/p>\n

“`bash
\ngit clone https:\/\/github.com\/YourName\/VelKoth.git
\ncd VelKoth
\n.\/gradlew clean shadowJar
\n“`<\/p>\n

Your compiled plugin will be deposited in `\/build\/libs\/`.<\/p>\n","protected":false},"excerpt":{"rendered":"

A modern, high-performance King of the Hill (KoTH)<\/p>\n","protected":false},"featured_media":165503,"template":"","meta":{"_minecraft_slug":"velkoth","_minecraft_project_id":"KMV1Htbs","_minecraft_author":"AyoSynk","_minecraft_license":"MIT","_minecraft_downloads":193,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velkoth.zip","_minecraft_size_bytes":10125975,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T12:37:56.186776Z","_minecraft_date_created":"2026-03-11T03:18:11.160795Z","_minecraft_date_modified":"2026-05-11T14:13:33.288345Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velkoth","_minecraft_icon_attachment_id":165503,"_minecraft_imported_at":"2026-06-09T17:48:19+00:00","_minecraft_import_hash":"bc68b81ff42712ed7b66a73898a2d849","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,89,866,127,128],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-165502","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nVelKoth - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"VelKoth - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A modern, high-performance King of the Hill (KoTH)\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/cdn.modrinth.com\/data\/cached_images\/ba430db68081def59233aa3afc473eaa3464d8c9.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/\",\"name\":\"VelKoth - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp\",\"datePublished\":\"2026-06-09T17:48:19+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velkoth\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"VelKoth\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"VelKoth - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/","og_locale":"en_US","og_type":"article","og_title":"VelKoth - Minecraft","og_description":"A modern, high-performance King of the Hill (KoTH)","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/cdn.modrinth.com\/data\/cached_images\/ba430db68081def59233aa3afc473eaa3464d8c9.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/","name":"VelKoth - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp","datePublished":"2026-06-09T17:48:19+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/velkoth-icon-cb14b31b43035a4d2abe90aefb868e2a88a3825a_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velkoth\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"VelKoth"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/165502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/165503"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=165502"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=165502"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=165502"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=165502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}