# VelocityRouter<\/p>\n
> Route players across your Minecraft network dynamically based on their permissions and the hostname they connect to.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
**VelocityRouter** is a powerful routing plugin for Velocity proxy servers that directs players to specific backend servers based on:<\/p>\n
* The hostname they joined with,
\n* Their permissions,
\n* And fallback default servers when no permissions match or servers are offline.<\/p>\n
This allows you to create complex routing rules for different player groups like VIPs, staff, or general users with ease.<\/p>\n
—<\/p>\n
## Features<\/p>\n
* **Permission-Based Routing**
\n Direct players to different servers depending on their assigned permissions.<\/p>\n
* **Hostname-Based Routing**
\n Configure routing rules specific to the hostname or domain players connect with.<\/p>\n
* **Fallback Servers**
\n Specify default servers for each hostname if no permission route matches or if the target server is offline.<\/p>\n
* **Custom Deny Messages**
\n Display personalized messages to players who lack permission to access certain servers.<\/p>\n
* **Wildcard Support**
\n Use a wildcard (`*`) hostname to define global fallback routing rules.<\/p>\n
—<\/p>\n
## Example Configuration<\/p>\n
“`yaml
\nroutes:
\n # Route 1: Default general access
\n – hostname: “play.example.com”
\n defaultServer: “lobby”
\n permissionRoutes: [] # No special permission routing for this hostname<\/p>\n
# Route 2: VIP access # Route 3: Staff access # Route 4: Global fallback (wildcard hostname) —<\/p>\n ## How It Works<\/p>\n 1. When a player connects, **VelocityRouter** checks the hostname they used. Route players across your Minecraft network dynamically based on their permissions and the hostname they connect to.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"velocityrouter","_minecraft_project_id":"jAWr5mpK","_minecraft_author":"InvalidJoker","_minecraft_license":"MIT","_minecraft_downloads":90,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocityrouter.zip","_minecraft_size_bytes":10077,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:54:36.100637Z","_minecraft_date_created":"2025-06-08T06:47:23.376327Z","_minecraft_date_modified":"2025-05-30T22:06:26.523987Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocityrouter","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T17:54:59+00:00","_minecraft_import_hash":"57cc596b890be5f7e8a20485a72efadf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,123,92,985],"mod_loader":[986],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-165618","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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":"\n
\n – hostname: “vip.example.com”
\n defaultServer: “vip_lobby” # Fallback if no permission matches or VIP server is offline
\n permissionRoutes:
\n – permission: “velocity.vip.access”
\n targetServer: “vip_server”
\n denyMessage: “
\n – hostname: “staff.example.com”
\n defaultServer: “admin_lobby” # Fallback if no permission matches
\n permissionRoutes:
\n – permission: “velocity.staff.access”
\n targetServer: “staff_server”
\n denyMessage: “
\n – hostname: “*” # Matches any hostname not explicitly configured above
\n defaultServer: “lobby”
\n permissionRoutes: []
\n“`<\/p>\n
\n2. It looks for a matching route configuration.
\n3. Within that route, it checks for any permission-based routes the player qualifies for.
\n4. If a matching permission route is found and the target server is online, the player is forwarded there.
\n5. If no permission matches or the server is offline, the player is sent to the route’s `defaultServer`.
\n6. If the player lacks permission for a matched permission route, the configured `denyMessage` is shown.<\/p>\n","protected":false},"excerpt":{"rendered":"