{"id":127026,"date":"2026-06-07T14:20:13","date_gmt":"2026-06-07T11:20:13","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/"},"modified":"2026-06-07T14:20:13","modified_gmt":"2026-06-07T11:20:13","slug":"pvpindex-battle","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/","title":{"rendered":"PvPIndex Battle"},"content":{"rendered":"<p>**PvPIndex Battles** is a competitive PvP plugin for Paper, Folia, Purpur, Spigot, BungeeCord, and Velocity servers. It adds a full **1v1 duel and ranked matchmaking system** with per-mode **ELO ratings**, persistent global leaderboards, battle replays, and a moderation suite &#8211; all synced to pvpindex.com so your players&#8217; rankings persist across the entire network.<\/p>\n<p>> **Supported game modes:** Crystal PvP \u00b7 Sword PvP \u00b7 Pot PvP \u00b7 NoDebuff \u00b7 Soup PvP \u00b7 Axe PvP \u00b7 Mace PvP \u00b7 Boxing \u00b7 Sumo \u00b7 UHC<\/p>\n<p>&#8212;<\/p>\n<p>## Features<\/p>\n<p>&#8211; **10 ranked game modes** &#8211; Crystal, Sword, Pot, NoDebuff, Soup, Axe, Mace, Boxing, Sumo, UHC &#8211; each with independent ELO ladders and separate leaderboards<br \/>\n&#8211; **1v1 matchmaking queue** &#8211; fully configurable 54-slot GUI with per-mode ELO, countdowns, and automatic arena teleportation<br \/>\n&#8211; **Cross-server duels** &#8211; `\/battle challenge <player> [mode]` works standalone or routes through a Velocity or BungeeCord proxy<br \/>\n&#8211; **Network-wide tab completion** &#8211; proxy broadcasts all online players so `\/battle challenge <TAB>` shows names from every backend server<br \/>\n&#8211; **Battle replay system** &#8211; frame-by-frame recording, reviewable in-game with `\/pvpmod replay <id>`<br \/>\n&#8211; **Arena pool** &#8211; procedural, schematic, and world-copy generation strategies; four bundled schematics included<br \/>\n&#8211; **Moderation suite** &#8211; player reports, local bans, federated network-wide bans, real-time spectating<br \/>\n&#8211; **PlaceholderAPI integration** &#8211; ELO, rank, win\/loss, queue state, and active mode placeholders for scoreboards and tab lists<br \/>\n&#8211; **Fully configurable messages** via `messages.yml`<br \/>\n&#8211; **HMAC-signed payloads** &#8211; battles are cryptographically signed before submission; the API rejects anything tampered with<br \/>\n&#8211; **Open ELO formula** &#8211; K=32 trust-weighted implementation published under MIT at github.com\/PVP-Index\/battle-validator<br \/>\n&#8211; **Folia compatible** &#8211; runs on Folia, Paper, Purpur, Spigot, and Bukkit (1.21+)<\/p>\n<p>&#8212;<\/p>\n<p>## Requirements<\/p>\n<p>| Requirement | Version |<br \/>\n|&#8212;|&#8212;|<br \/>\n| Java | 21+ (25+ for Paper API 26.1.x) |<br \/>\n| Paper \/ Folia \/ Purpur \/ Spigot | 1.21.x or 1.21.4+ (API 26.1.x) |<br \/>\n| Velocity or BungeeCord *(optional)* | Velocity 3.x \/ BungeeCord 1.21+ |<br \/>\n| PlaceholderAPI *(optional)* | 2.11+ |<br \/>\n| PvPIndex API key | Free at pvpindex.com |<\/p>\n<p>&#8212;<\/p>\n<p>## Installation<\/p>\n<p>### Paper \/ Folia \/ Purpur \/ Spigot<\/p>\n<p>1. Drop `PvPIndexBattles-<version>.jar` into `plugins\/`.<br \/>\n2. Start the server, configs are generated automatically.<br \/>\n3. Stop the server, then add your API key to `plugins\/PvPIndexBattles\/config.yml`:<\/p>\n<p>&#8220;`yaml<br \/>\napi:<br \/>\n  api_key: &#8220;your-api-key-here&#8221;<\/p>\n<p>server:<br \/>\n  id: &#8220;my-server&#8221;<br \/>\n&#8220;`<\/p>\n<p>4. Restart and run `\/pvpindex` to confirm everything loaded correctly.<\/p>\n<p>### Velocity \/ BungeeCord *(optional)*<\/p>\n<p>Drop `PvPIndexBattles-velocity-<version>.jar` into your proxy `plugins\/` folder and configure `plugins\/pvpindex-battles\/config.properties` with the same API key and shared secret as your backend servers.<\/p>\n<p>\u2192 Full proxy setup guide: docs.pvpindex.com\/server_owner\/proxy-setup<\/p>\n<p>&#8212;<\/p>\n<p>## Commands<\/p>\n<p>### `\/battle`  Players<\/p>\n<p>| Command | Description |<br \/>\n|&#8212;|&#8212;|<br \/>\n| `\/battle` | Open the matchmaking mode selection GUI |<br \/>\n| `\/battle challenge <player> [mode]` | Send a duel challenge |<br \/>\n| `\/battle accept <id>` | Accept a challenge |<br \/>\n| `\/battle decline <id>` | Decline a challenge |<br \/>\n| `\/battle leave` | Leave the queue or forfeit an active battle |<\/p>\n<p>### `\/pvpindex` Admins<\/p>\n<p>| Command | Permission | Description |<br \/>\n|&#8212;|&#8212;|&#8212;|<br \/>\n| `\/pvpindex reload` | `pvpindex.reload` | Reload plugin config |<br \/>\n| `\/pvpindex submissions` | `pvpindex.admin` | View pending battle submissions |<br \/>\n| `\/pvpindex sync` | `pvpindex.admin` | Retry unsubmitted battles |<br \/>\n| `\/pvpindex retryfailed` | `pvpindex.admin` | Retry failed API submissions |<\/p>\n<p>### `\/pvpmod`  Moderation<\/p>\n<p>| Command | Permission | Description |<br \/>\n|&#8212;|&#8212;|&#8212;|<br \/>\n| `\/pvpmod watch <player>` | `pvpindex.mod` | Spectate a live battle |<br \/>\n| `\/pvpmod replay <id>` | `pvpindex.mod` | Play back a recorded battle |<br \/>\n| `\/pvpmod report <player> <reason>` | `pvpindex.mod.report` | Report a player |<br \/>\n| `\/pvpmod ban <player> <duration> <reason>` | `pvpindex.mod.ban` | Ban a player from battles |<br \/>\n| `\/pvpmod unban <player>` | `pvpindex.mod.ban` | Unban a player |<\/p>\n<p>&#8212;<\/p>\n<p>## PlaceholderAPI<\/p>\n<p>| Placeholder | Returns |<br \/>\n|&#8212;|&#8212;|<br \/>\n| `%pvpindex_elo%` | Overall ELO rating |<br \/>\n| `%pvpindex_elo_<mode>%` | ELO for a specific mode |<br \/>\n| `%pvpindex_rank%` | Global ladder position |<br \/>\n| `%pvpindex_wins%` | Session wins |<br \/>\n| `%pvpindex_losses%` | Session losses |<br \/>\n| `%pvpindex_kd%` | Win\/loss ratio |<br \/>\n| `%pvpindex_in_battle%` | `true` \/ `false` |<br \/>\n| `%pvpindex_queued%` | `true` \/ `false` |<br \/>\n| `%pvpindex_queued_mode%` | Current queue mode or `none` |<br \/>\n| `%pvpindex_battle_type%` | Display name of the active mode |<\/p>\n<p>&#8212;<\/p>\n<p>## Configuration<\/p>\n<p>&#8220;`yaml<br \/>\n# plugins\/PvPIndexBattles\/config.yml<br \/>\napi:<br \/>\n  api_key: &#8220;&#8221;<br \/>\n  base_url: &#8220;https:\/\/api.pvpindex.com\/api&#8221;<\/p>\n<p>server:<br \/>\n  id: &#8220;my-server&#8221;<br \/>\n  require_signature: false   # Recommended: set to true in production<br \/>\n  debug: false<\/p>\n<p>arena:<br \/>\n  world_prefix: &#8220;pvpindex_arena&#8221;<br \/>\n  cleanup_delay_ticks: 100<\/p>\n<p>queue:<br \/>\n  max_wait_seconds: 120<br \/>\n&#8220;`<\/p>\n<p>\u2192 Full reference: docs.pvpindex.com\/server_owner\/configuration<\/p>\n<p>&#8212;<\/p>\n<p>## Links<\/p>\n<p>&#8211; **Website &#038; leaderboards** &#8211; pvpindex.com<br \/>\n&#8211; **Documentation** &#8211; docs.pvpindex.com<br \/>\n&#8211; **Source (plugin)** &#8211; github.com\/PVP-Index\/pvpindex-battles<br \/>\n&#8211; **Source (ELO formula \/ anti-cheat)** &#8211; github.com\/PVP-Index\/battle-validator<br \/>\n&#8211; **Issue tracker** &#8211; github.com\/PVP-Index\/pvpindex-battles\/issues<\/p>\n<p>&#8212;<\/p>\n<p>## License<\/p>\n<p>The ELO validator is published under MIT. See LICENSE for the plugin itself.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Official open free ELO platform with advanced battle system. Includes Sword PvP, Crystal PvP, Sumo and much more<\/p>\n","protected":false},"featured_media":127027,"template":"","meta":{"_minecraft_slug":"pvpindex-battle","_minecraft_project_id":"wOZtwr2V","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":19,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pvpindex-battle.zip","_minecraft_size_bytes":29391534,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T22:48:46.631103Z","_minecraft_date_created":"2026-05-08T00:02:00.955526Z","_minecraft_date_modified":"2026-05-06T13:19:08.219130Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pvpindex-battle","_minecraft_icon_attachment_id":127027,"_minecraft_imported_at":"2026-06-07T11:20:14+00:00","_minecraft_import_hash":"1c068abadb7efbe8fc82f48242d4bd8c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,127,128,129,985,992],"mod_loader":[130,895,131,132,133,134,986,993],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-127026","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>PvPIndex Battle - 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\/pvpindex-battle\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PvPIndex Battle - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Official open free ELO platform with advanced battle system. Includes Sword PvP, Crystal PvP, Sumo and much more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\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=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/\",\"name\":\"PvPIndex Battle - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif\",\"datePublished\":\"2026-06-07T11:20:13+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pvpindex-battle\\\/#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\":\"PvPIndex Battle\"}]},{\"@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":"PvPIndex Battle - 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\/pvpindex-battle\/","og_locale":"en_US","og_type":"article","og_title":"PvPIndex Battle - Minecraft","og_description":"Official open free ELO platform with advanced battle system. Includes Sword PvP, Crystal PvP, Sumo and much more","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/","name":"PvPIndex Battle - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif","datePublished":"2026-06-07T11:20:13+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pvpindex-battle-icon-f77b9f5791dfa236d42258dbfb08cad64e8a8a8c.gif","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pvpindex-battle\/#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":"PvPIndex Battle"}]},{"@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\/127026","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\/127027"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=127026"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=127026"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=127026"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=127026"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}