Tools
velocity.toml generator for a server network
List your network's servers and where players land on join to get the velocity.toml keys and sections: port, MOTD, account verification, the player info forwarding mode, [servers] with the try order and [forced-hosts] for subdomains.
velocity.toml
velocity.toml
bind = "0.0.0.0:25565" motd = "<green>My server network" show-max-players = 500 online-mode = true player-info-forwarding-mode = "modern" forwarding-secret-file = "forwarding.secret" [servers] lobby = "127.0.0.1:30066" survival = "127.0.0.1:30067" try = ["lobby"] [forced-hosts]
On every Paper server behind the proxy: online-mode=false in server.properties, settings.bungeecord=false in spigot.yml, and in config/paper-global.yml proxies.velocity.enabled: true with the same secret as forwarding.secret. The password and secret generator makes the secret.
How to set up Velocity
Velocity is a proxy: players connect to it and it hands them to the servers in [servers]. The try list is where players land on join and where they go if a server kicks them. [forced-hosts] sends a player to a server by the address they joined with: survival.example.com straight to survival.
Player info forwarding isn't optional: without it the servers behind the proxy see everyone with the proxy's IP and an offline UUID. Velocity's documentation recommends modern for clients 1.13 and newer: the data is signed with the secret from forwarding.secret. legacy is for compatibility with old servers; bungeeguard is legacy with a secret.
The generator gives only the keys people usually change: Velocity creates the full velocity.toml itself on first start, config-version included, and that one shouldn't be touched. Firewall the servers behind the proxy so nobody can join them directly — more in our Velocity setup guide.
DGuard works behind Velocity and BungeeCord: it goes on each Paper server of the network. DGuard, the best anticheat for a modern Minecraft server, is free up to 30 players online per server.
Read in the knowledge base
FAQ
How do I configure velocity.toml?
Start Velocity once so it creates the file, then replace the keys and sections from the generator: port, MOTD, forwarding mode, [servers] and try. Restart the proxy afterwards.
Which forwarding mode should I use?
modern if every server runs 1.13 or newer — Velocity's documentation recommends it. legacy only for compatibility with old versions.
What is try in Velocity?
The order of servers the proxy sends a player to on join, and to if a server kicks them. The lobby usually comes first.
What are forced hosts?
An "address → server" rule: a player joining through survival.example.com lands straight on survival, skipping the lobby.
The tools are free. So is anti-cheat protection
DGuard — the best anticheat for a modern Minecraft server — catches all 47 cheat types in our comparison; the nearest rival, Intave, catches 27. Free up to 30 players online, with the same protection as on paid plans.