Skip to main content
To set up a Velocity proxy on FREAKHOSTING, install Velocity on one server with Version Changer, set player-info-forwarding-mode = "modern" and list your backend servers in velocity.toml. Then, on every Paper backend, switch on Allow cracked players and enable Velocity in config/paper-global.yml with the secret from forwarding.secret. Players join with the proxy’s address and move between servers with /server.

​
How does a proxy network work?

Each part is its own FREAKHOSTING Minecraft server. For a lobby and a survival world you need three servers. The proxy itself needs little memory.
BungeeCord and Waterfall are also in Version Changer, but Waterfall is marked DEPRECATED and BungeeCord’s forwarding is less secure. Use Velocity for new networks. If you must use BungeeCord, set ip_forward: true in its config.yml and settings.bungeecord: true in each backend’s spigot.yml.

​
Step 1: Install Velocity on the proxy server

1

Open Version Changer

On the server you want as the proxy, click Version Changer, then Velocity.
2

Install

Pick the newest version and click Change Version. Switch on Delete Server Files if this server had a game world on it before.
3

Start once

Start the server so Velocity creates velocity.toml and forwarding.secret, then stop it.

​
Step 2: Configure velocity.toml

Open velocity.toml in Files on the proxy server.
1

Check the bind port

Make sure bind uses the port of this server as shown on its Console page (the Copy address card), for example bind = "0.0.0.0:25565".
2

Turn on modern forwarding

Modern forwarding passes each player’s real name, UUID and skin to the backends. Velocity keeps the shared secret in forwarding.secret.
3

List your backends

In [servers], add each backend with its address from the panel, and set the order players try them:
Delete the example servers Velocity adds by default, and remove or edit the [forced-hosts] entries that point to them.
4

Copy the secret

Open forwarding.secret and copy its content. You need it on every backend.
Treat forwarding.secret like a password. Anyone who has it can pretend to be any player on your backends.

​
Step 3: Set up each Paper backend

1

Turn off online mode

Click Server Properties, switch on Allow cracked players and click Save. The proxy checks accounts, so the backend mustn’t check them again.
2

Enable Velocity support

Stop the server. In Files, open config/paper-global.yml and set:
online-mode here must match online-mode in velocity.toml.
3

Check spigot.yml

In spigot.yml, make sure settings.bungeecord is false. That setting is only for BungeeCord.
4

Start everything

Start each backend, then start the proxy.
With modern forwarding on, a backend refuses players who try to connect directly. Players always use the proxy’s address.

​
Step 4: Join and switch servers

Velocity runs its own plugins. On the proxy server, filter the Plugins page by the Velocity loader.

​
Which address and port goes where?

​
Frequently asked questions

​
Velocity or BungeeCord: which should I use?

Velocity. It is actively developed and its modern forwarding is secure. BungeeCord still works but uses older forwarding, and Waterfall is deprecated.

​
Why do players get “Unable to connect you to lobby”?

The proxy can’t reach the backend. Check the address and port in [servers], that the backend is running, and that the backend name is in try.

​
What does “Unable to verify player details” mean?

The secret in paper-global.yml doesn’t match forwarding.secret, or proxies.velocity.enabled is off. Copy the secret again and restart the backend.

​
Does modern forwarding work with old Minecraft versions?

No. Modern forwarding needs Minecraft 1.13 or newer on the backends. Older backends need legacy (BungeeCord-style) forwarding.

​
Can I run Fabric backends behind Velocity?

Yes, with a mod that adds Velocity forwarding on the backend. Paper backends are the simplest setup.

Minecraft server guide

Every Minecraft guide in one place.

Change your server version

How Version Changer works.

Allow cracked players

What online mode does.

ViaVersion

Let several game versions join the network.

spigot.yml settings

Where the bungeecord setting lives.
Checked against the official Velocity documentation on 29 October 2026, and the Version Changer steps tested on our Game Panel (Minecraft 26.1, Paper and Fabric). Steps may differ slightly if Velocity or Paper change.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!
Last Updated: October 2026