VelocityNavigator

Premium lobby navigation and intelligent load balancing for Velocity proxies.

335

Quick challenge

How far can you run before the mobs catch you?

VelocityNavigator

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.

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.

Routing

Why VelocityNavigator?

For Players

- `/lobby` just works — fast, reliable, with clear feedback messages. - Always routes to a healthy, reachable server. - Automatically places them into the best lobby immediately upon joining the network before they even finish authentication.

For Admins

- Anti-spam protection — Bypasses Velocity's default static fallback engine to perfectly split initial proxy connection waves. - Anti-spam protection — `least_players`, `random`, `round_robin` - Anti-spam protection — different game servers can point to different lobby pools with automatic fallback loops - Anti-spam protection — async pings with configurable timeout, TTL caching, and ping coalescing to prevent backend storms - Anti-spam protection — pre-execution cooldown locks block macro abuse before the routing engine even fires

How Routing Works

``` Player runs /lobby ↓ Contextual group resolution (if enabled) ↓ Fallback to default lobbies (if contextual group is empty/offline) ↓ Cycle pruning (remove current server if alternatives exist) ↓ Async health checks (with TTL cache + ping coalescing) ↓ Selection strategy (least_players / random / round_robin) ↓ Player is connected to the best available lobby ```

*All server name matching is case-insensitive — `Lobby-1` and `lobby-1` are treated identically.*

Commands & Diagnostics

| Command | Permission | Description | |---------|-----------|-------------| | `/lobby` | `velocitynavigator.use` | Send to best available lobby | | `/vn reload` | `velocitynavigator.admin` | Reload config live | | `/vn status` | `velocitynavigator.admin` | Runtime status dashboard | | `/vn version` | `velocitynavigator.admin` | Installed + latest version info | | `/vn debug player <name>` | `velocitynavigator.admin` | Preview routing for a player | | `/vn debug server <name>` | `velocitynavigator.admin` | Inspect server health snapshot |

Quick Config Example

```toml config_version = 3

[commands] primary = "lobby" aliases = ["hub", "spawn"]

[routing] selection_mode = "least_players" balance_initial_join = true cycle_when_possible = true default_lobbies = ["lobby-1", "lobby-2"]

[routing.contextual] enabled = true fallback_to_default = true

[routing.contextual.groups] bedwars = ["bw-lobby-1", "bw-lobby-2"]

[routing.contextual.sources] "bedwars-1" = "bedwars"

[health_checks] enabled = true timeout_ms = 2500 cache_seconds = 60 ```

Compatibility

- Java: Velocity only - Java: `3.x` - Java: `17+`

---

📖 Documentation & Links

- Initial Join Balancing: Initial Join Balancing - Initial Join Balancing: %%MD1%% - Initial Join Balancing: %%MD2%% - Initial Join Balancing: %%MD3%%

---

Looking for hosting? Check out https://nexeu.zip/ - budget-friendly hosting.

nexeu-sponsor