VelocityNavigator
Managing a complex Minecraft network requires more than just a simple proxy; it demands an intelligent traffic manager that can adapt to real-world conditions. VelocityNavigator stands out as a high-performance routing solution designed specifically for modern Velocity networks. It eliminates the guesswork from proxy load balancing by continuously evaluating backend health, server capacity, and geographic latency before routing a single player. Whether you are running a small community with two lobbies or a massive enterprise network with dozens of regional backends, this tool delivers resilient and explainable routing that scales effortlessly.
Intelligent Lobby Routing and Balancing
Traditional round-robin routing often fails in production environments where disconnections, player grouping, and varied hardware capabilities create severe load imbalances. VelocityNavigator addresses these issues with nine specialized routing strategies tailored for real-world architectures.
Advanced Routing Strategies
The plugin offers a variety of methods to ensure optimal player distribution. The Power of Two Choices strategy is the modern industry standard, selecting two candidate lobbies at random and routing to the one with lower load, which mathematically eliminates herd behavior. For networks needing simple distribution, the Least Players strategy directs new connections to the lobby with the fewest online users. Weighted Round Robin allows you to distribute traffic proportionally based on server weights, perfect for mixed hardware deployments where a 64GB dedicated node can handle three times the traffic of an 8GB VPS.
Other powerful options include Consistent Hashing for deterministic routing that smoothly re-distributes keys when servers are added, and Latency-Aware Ping Routing which actively evaluates round-trip times to assign players to the lowest-latency node. Geo-Location Routing automatically sends international players to regional clusters based on their country codes, supporting MaxMind GeoLite2 and IP-API integrations. For those preferring strict distribution, there are Sequential Round Robin and Uniform Random options.
Sticky Sessions and Player Affinity
Returning players often dislike being thrown into a random lobby every time they switch worlds. VelocityNavigator provides configurable player affinity to remember a player's previous lobby within a set time window. This affinity is fully persistent across proxy restarts using atomic on-disk storage. If the preferred lobby is full, draining, or in maintenance, the system instantly bypasses the affinity to find an available spot.
Resilient Self-Healing and Circuit Breakers
When a backend crashes or suffers severe TPS drops, standard proxies often leave players stuck on timeout screens. VelocityNavigator acts as a self-healing traffic manager with enterprise-grade defensive systems. It utilizes a Three-State Circuit Breaker that monitors connection failures and ping timeouts. When thresholds are exceeded, the circuit trips to an OPEN state, instantly cutting off player routing to that server. After a cool-down, it enters a HALF-OPEN state to test server health with canary connections before resuming full traffic.
The plugin also employs Exponential Backoff with Jitter to prevent the "thundering herd" effect when disconnected backends recover. Continuous multi-vector health checks include active ping checks, TCP socket verification, and MOTD query checks to ensure only healthy servers receive traffic.
Enterprise Security and Observability
Protecting your network is paramount, and VelocityNavigator includes a robust authentication engine featuring Argon2id password hashing and brute-force rate limiting. Unauthenticated players are isolated in a holding lobby where movement and chat are restricted until they log in. Bedrock players via Floodgate receive native modal dialogs for registration instead of typing passwords into open chat.
For operations teams, the embedded HTML dashboard provides real-time visibility into lobby status, player counts, and circuit health. Native Prometheus metrics allow for direct integration with Grafana for 24/7 network monitoring. Additionally, the plugin supports dynamic MiniMessage MOTD rotation, allowing you to display real-time player counts and maintenance status directly in the server list.
Installation and Configuration
Getting started with VelocityNavigator is straightforward. To download VelocityNavigator, simply obtain the latest single-JAR file and place it into your Velocity proxy's plugins directory. You can also find VelocityNavigator for Minecraft on various community platforms, but ensure you grab the official release for security.
Once installed, start the proxy to generate default configuration files. The universal single-JAR architecture means you can install the exact same file on your Velocity proxy and on any Paper, Spigot, or Folia backend where you want NPCs, YAML menus, or inventory selectors. There are no separate bridge plugins required. For those looking to streamline their workflow, the foxygame.net launcher offers an impressive one-click install feature that automatically detects and places VelocityNavigator into your server files, ensuring you never miss a configuration step. Furthermore, the launcher's add-on catalog keeps VelocityNavigator updated with the latest features and fixes, maintaining perfect version compatibility across your entire network without manual intervention.
How to Install and Configure
After placing the JAR file, stop the proxy and edit the navigator.toml configuration file. Here you will define your routing strategies and list your lobby servers. The configuration is self-documenting, and you can use the /vn config validate command to audit your settings for syntax errors or typos. Once validated, restart the proxy and test the routing by typing /lobby in-game.
If you wish to add backend features like inventory selectors or menus, copy the same JAR into the plugins folder of your backend servers. The plugin supports multiple storage engines including JSON, SQLite, MySQL, and PostgreSQL, allowing you to choose the backend that matches your infrastructure.
Conclusion
VelocityNavigator transforms the way Minecraft networks handle traffic. By combining intelligent routing, self-healing mechanisms, and enterprise-grade security, it provides a robust foundation for any scale of server network. Whether you need advanced geo-routing or simple load balancing, VelocityNavigator delivers the performance and reliability modern server owners demand.