How to Add Sub-Servers to a Velocity Network

Expanding Your Velocity Network

A Velocity network starts with a proxy and at least one backend server, usually a lobby. As your community grows, you will want to add sub servers velocity minecraft players can move between: a survival world, a creative plot server, minigames, and more. Each sub-server is an independent Minecraft server process that Velocity routes players to.

Registering a New Sub-Server

Step 1: Set Up the Backend

Install your new server (Paper, Purpur, or similar) in its own directory. Give it a unique port in server.properties:

server-port=25567
online-mode=false

Configure Velocity modern forwarding on the new backend by pasting the forwarding secret into config/paper-global.yml.

Step 2: Register in velocity.toml

Open velocity.toml and find the [servers] section. Add your new server:

[servers]
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
creative = "127.0.0.1:25568"

try = ["lobby"]

The try list defines which servers Velocity attempts to connect players to when they first join. Usually this is your lobby. When you add sub servers velocity minecraft networks gain more routing flexibility through this configuration.

Step 3: Forced Hosts (Optional)

If you want players to connect directly to a specific sub-server using a subdomain, configure forced hosts:

[forced-hosts]
"survival.example.com" = ["survival"]
"creative.example.com" = ["creative"]

Set up the corresponding DNS records (A or CNAME) pointing to your proxy's IP. Players connecting via survival.example.com land directly in survival.

Player Movement Between Servers

Players move between sub-servers using the /server command built into Velocity, or through plugins that provide GUIs, NPCs, or portal-based navigation. Popular options include:

• Velocity's built-in /server command: Works out of the box for staff, can be permission-gated for regular players.
• Server selector plugins: Provide a compass or menu item that lists available servers.
• Portal plugins: Walk into a region to transfer to another server.

For building a polished hub with server selectors, see how to make a server hub.

Fallback Configuration

If a sub-server crashes, Velocity can send players back to a fallback server instead of kicking them. The try list acts as the fallback chain. Put your most stable server (usually lobby) first.

Scaling Tips

• Run each sub-server on its own port. Avoid port conflicts.
• If you run servers on different machines, update the IP in velocity.toml and ensure firewall rules allow the proxy to reach each backend.
• Monitor memory per server. Each sub-server needs its own JVM allocation.

To add sub servers velocity minecraft setups need proper forwarding, unique ports, and registration in the proxy config. Once that is in place, you can scale to as many servers as your hardware supports.

Need a proxy-ready network? Astroworld Hosting supports Velocity, BungeeCord, and multi-server setups on every plan.