{"id":165602,"date":"2026-06-09T20:54:21","date_gmt":"2026-06-09T17:54:21","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/"},"modified":"2026-06-09T20:54:21","modified_gmt":"2026-06-09T17:54:21","slug":"velocitynavigator","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/","title":{"rendered":"VelocityNavigator"},"content":{"rendered":"<p>![VelocityNavigator Banner](https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/hero-banner.png)<\/p>\n<p>**VelocityNavigator** is a production-grade Velocity proxy plugin that introduces absolute traffic control over your network through intelligent initial-join load balancing and a highly context-aware `\/lobby` system.<\/p>\n<p>No more funneling all new players into a single hub. No more sending players to offline servers. No more guessing which lobby they ended up on.<\/p>\n<p>![Routing](https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/feature-routing.png)<\/p>\n<p>## Why VelocityNavigator?<\/p>\n<p>### For Players<br \/>\n&#8211; `\/lobby` just works \u2014 fast, reliable, with clear feedback messages.<br \/>\n&#8211; Always routes to a healthy, reachable server.<br \/>\n&#8211; Automatically places them into the best lobby immediately upon joining the network before they even finish authentication.<\/p>\n<p>### For Admins<br \/>\n&#8211; **Initial Join Balancing** \u2014 Bypasses Velocity&#8217;s default static fallback engine to perfectly split initial proxy connection waves.<br \/>\n&#8211; **Three routing algorithms** \u2014 `least_players`, `random`, `round_robin`<br \/>\n&#8211; **Contextual lobby groups** \u2014 different game servers can point to different lobby pools with automatic fallback loops<br \/>\n&#8211; **Real-time health checks** \u2014 async pings with configurable timeout, TTL caching, and ping coalescing to prevent backend storms<br \/>\n&#8211; **Anti-spam protection** \u2014 pre-execution cooldown locks block macro abuse before the routing engine even fires<\/p>\n<p>## How Routing Works<\/p>\n<p>&#8220;`<br \/>\nPlayer runs \/lobby<br \/>\n    \u2193<br \/>\nContextual group resolution (if enabled)<br \/>\n    \u2193<br \/>\nFallback to default lobbies (if contextual group is empty\/offline)<br \/>\n    \u2193<br \/>\nCycle pruning (remove current server if alternatives exist)<br \/>\n    \u2193<br \/>\nAsync health checks (with TTL cache + ping coalescing)<br \/>\n    \u2193<br \/>\nSelection strategy (least_players \/ random \/ round_robin)<br \/>\n    \u2193<br \/>\nPlayer is connected to the best available lobby<br \/>\n&#8220;`<\/p>\n<p>*All server name matching is **case-insensitive** \u2014 `Lobby-1` and `lobby-1` are treated identically.*<\/p>\n<p>## Commands &#038; Diagnostics<\/p>\n<p>| Command | Permission | Description |<br \/>\n|&#8212;&#8212;&#8212;|&#8212;&#8212;&#8212;&#8211;|&#8212;&#8212;&#8212;&#8212;-|<br \/>\n| `\/lobby` | `velocitynavigator.use` | Send to best available lobby |<br \/>\n| `\/vn reload` | `velocitynavigator.admin` | Reload config live |<br \/>\n| `\/vn status` | `velocitynavigator.admin` | Runtime status dashboard |<br \/>\n| `\/vn version` | `velocitynavigator.admin` | Installed + latest version info |<br \/>\n| `\/vn debug player <name>` | `velocitynavigator.admin` | Preview routing for a player |<br \/>\n| `\/vn debug server <name>` | `velocitynavigator.admin` | Inspect server health snapshot |<\/p>\n<p>## Quick Config Example<\/p>\n<p>&#8220;`toml<br \/>\nconfig_version = 3<\/p>\n<p>[commands]<br \/>\nprimary = &#8220;lobby&#8221;<br \/>\naliases = [&#8220;hub&#8221;, &#8220;spawn&#8221;]<\/p>\n<p>[routing]<br \/>\nselection_mode = &#8220;least_players&#8221;<br \/>\nbalance_initial_join = true<br \/>\ncycle_when_possible = true<br \/>\ndefault_lobbies = [&#8220;lobby-1&#8221;, &#8220;lobby-2&#8221;]<\/p>\n<p>[routing.contextual]<br \/>\nenabled = true<br \/>\nfallback_to_default = true<\/p>\n<p>[routing.contextual.groups]<br \/>\nbedwars = [&#8220;bw-lobby-1&#8221;, &#8220;bw-lobby-2&#8221;]<\/p>\n<p>[routing.contextual.sources]<br \/>\n&#8220;bedwars-1&#8221; = &#8220;bedwars&#8221;<\/p>\n<p>[health_checks]<br \/>\nenabled = true<br \/>\ntimeout_ms = 2500<br \/>\ncache_seconds = 60<br \/>\n&#8220;`<\/p>\n<p>## Compatibility<\/p>\n<p>&#8211; **Platform:** Velocity only<br \/>\n&#8211; **Velocity:** `3.x`<br \/>\n&#8211; **Java:** `17+`<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udcd6 Documentation &#038; Links<\/p>\n<p>&#8211; **GitHub Repository**: View Source<br \/>\n&#8211; **Configuration Guide**: Read Here<br \/>\n&#8211; **Routing Algorithms**: Read Here<br \/>\n&#8211; **Initial Join Balancing**: Read Here<\/p>\n<p>&#8212;<\/p>\n<p>Looking for hosting? Check out https:\/\/nexeu.zip\/ &#8211; budget-friendly hosting.<br \/>\n![nexeu-sponsor](https:\/\/whodoesntloveavatars.s3.fra.databucket.eu\/assets\/promo.png)<\/p>\n<p align=\"center\">\n<p>&#8212;<\/p>\n<p>## \ud83d\udcca Telemetry<\/p>\n<p>![bStats](https:\/\/bstats.org\/plugin\/velocity\/Velocity%20Navigator\/28341)<\/p>\n<p>&#8212;<\/p>\n<p align=\"center\">\n  <img decoding=\"async\" src=\"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.png\" alt=\"VelocityNavigator Icon\" width=\"64\"><br \/>\n  <br \/>\n  <strong>Built with \u2764\ufe0f by DemonZ Development<\/strong><br \/>\n  <br \/>\n  <em>Premium Minecraft infrastructure, engineered for scale.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Premium lobby navigation and intelligent load balancing for Velocity proxies.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"velocitynavigator","_minecraft_project_id":"2rbkszFo","_minecraft_author":"demonzdevelopment","_minecraft_license":"Apache-2.0","_minecraft_downloads":335,"_minecraft_follows":11,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocitynavigator.zip","_minecraft_size_bytes":1352918,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T11:26:19.396579Z","_minecraft_date_created":"2025-09-03T21:57:40.120218Z","_minecraft_date_modified":"2026-04-09T23:23:37.818315Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocitynavigator","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T17:54:21+00:00","_minecraft_import_hash":"01c2d9889ba746ab1b0c55e844d4ca09","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,90,867,123,869,92,985],"mod_loader":[986],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-165602","mod","type-mod","status-publish","hentry","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-social","mod_category-technology","mod_category-transportation","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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>VelocityNavigator - 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\/velocitynavigator\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"VelocityNavigator - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Premium lobby navigation and intelligent load balancing for Velocity proxies.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.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=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/\",\"name\":\"VelocityNavigator - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/raw.githubusercontent.com\\\/sdemonzdevelopment-spec\\\/VelocityNavigator\\\/main\\\/assets\\\/plugin-icon.png\",\"datePublished\":\"2026-06-09T17:54:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/#primaryimage\",\"url\":\"https:\\\/\\\/raw.githubusercontent.com\\\/sdemonzdevelopment-spec\\\/VelocityNavigator\\\/main\\\/assets\\\/plugin-icon.png\",\"contentUrl\":\"https:\\\/\\\/raw.githubusercontent.com\\\/sdemonzdevelopment-spec\\\/VelocityNavigator\\\/main\\\/assets\\\/plugin-icon.png\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/velocitynavigator\\\/#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\":\"VelocityNavigator\"}]},{\"@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":"VelocityNavigator - 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\/velocitynavigator\/","og_locale":"en_US","og_type":"article","og_title":"VelocityNavigator - Minecraft","og_description":"Premium lobby navigation and intelligent load balancing for Velocity proxies.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/","name":"VelocityNavigator - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/#primaryimage"},"thumbnailUrl":"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.png","datePublished":"2026-06-09T17:54:21+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/#primaryimage","url":"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.png","contentUrl":"https:\/\/raw.githubusercontent.com\/sdemonzdevelopment-spec\/VelocityNavigator\/main\/assets\/plugin-icon.png"},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/velocitynavigator\/#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":"VelocityNavigator"}]},{"@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\/165602","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:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=165602"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=165602"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=165602"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=165602"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}