Proxy Setup

MC-Vector supports creating and managing proxy servers — Velocity, Waterfall, and BungeeCord. This guide walks through setting up a Velocity proxy network.

What is a Proxy?

A Minecraft proxy connects multiple backend servers together, allowing players to switch between servers (Lobby → Survival → Minigames) without disconnecting.

Prerequisites

• At least two servers: one proxy (Velocity) and one backend (e.g., Paper).
• Backend servers on different ports (e.g., 25566, 25567).

Step 1: Create the Velocity Server

1. Click + Add Server in MC-Vector.
2. Select Velocity as the software type.
3. Set the port to 25577 (Velocity's default).
4. Click Create.

Step 2: Configure velocity.toml

1. Open the Velocity server in MC-Vector and go to Files.
2. Open velocity.toml.
3. Add your backend servers in the [servers] section:

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

try = ["lobby"]

4. Note the secret in forwarding.secret — you will need it in Step 3.

Step 3: Configure Backend Servers

For each backend server:

1. Go to their Properties tab and set:
   • online-mode = false
   • server-port = the port you defined in velocity.toml
2. For Paper/Purpur backends, open config/paper-global.yml in Files and enable:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "<your forwarding.secret value>"

Step 4: Start the Network

1. Start all backend servers first.
2. Once they are online, start the Velocity proxy.
3. Connect to localhost:25577 in Minecraft (or your server's IP at port 25577).