Set up Velocity

When you want to connect multiple individual servers together, you need to use a “proxy server”. Out of all the currently available options such as BungeeCord and Waterfall, Velocity is largely recommended as it has the most users and hence most available support. This guide will go through how to set up Velocity together with the most popular paper based servers such as Paper, Pufferfish and Purpur.

Prerequisites

• An UltraServers account and resource plan.

Create the Minecraft server(s) you want to link together

• Create the servers that you want to link together. You can find a detailed guide on how to do so here.

Create the Velocity server

• Create a new server and select Minecraft > Velocity as the type. This will be our proxy server.

Start the server

• After the installation is completed, start the server for the first time to generate the necessary default configuration files.
• After the server has been started, wait for it to complete generating the configuration files which will be indicated by the Server marked as running message.

Open the configuration file

• In the File Manager, open the velocity.toml configuration file.
• Scroll down to the sections [servers] and [forced-hosts].
• These are the sections that need to be modified in the next step for the proxy to work properly.

Configure the proxy

• In this example, I will be linking together two servers in the following configuration:

• The servers are linked using the Server UUID, which can be found in the 1 Overview tab of the server in question.
• Click the 2 Server UUID to copy it to your clipboard.

┌──────────────┐
│ Proxy Server │
└┬─────────────┘
 │  Server 1
 ├─►12683dec-f45e-4e5c-99ff-7e7215303e6d:20417
 │
 │  Server 2
 └─►39483feb-3fd9-fo49-43h1-2h8918473b6d:24531

• The server will be configured as follows:
• Server 1 will be called lobby.
• Server 2 will be called bedwars.
• When connecting to the proxy server, the player should be sent to the lobby server by default, at which point the player will be able to be teleported to the other servers through teleportation gates (provided by plugins) or the /server [server name] command.
• Access to this command can be limited through permission plugins like Luckperms.
• The final configuration to replicate this behavior will look like this:

Player data information forwarding

• When players connect to a server behind a proxy, it must be set to offline mode, which means information such as the UUID and player skin will not work.
• This problem can be fixed through the forwarding options offered by velocity.
• In the configuration file velocity.toml, modify the player-info-forwarding-mode to modern.

player-info-forwarding-mode = "modern"

• Note: If you are running a server below version 1.13 or a non-paper based server (such as fabric servers for modded gameplay), “modern” information forwarding will not work. Please refer to the alternative player forwarding methods that can be seen in velocity’s information forwarding configuration page.

Write down your forwarding secret

• Open the forwarding.secret file.
• Take note of the forwarding secret present inside the file, it will be necessary when configuring the Minecraft servers that are being linked, do not share it with anyone.

Configure the server(s)

• Open the Minecraft server(s) File Manager(s).
• Open the server.properties file.
• Set online-mode to false and save the changes.
• Open the config folder.
• Inside the folder, open the paper-global.yml file.
• Under proxies>velocity, set both enabled and online-mode to true, then paste the forwarding secret from the previous step into the secret field.
• Save the changes.

Start the servers

• Start the proxy server by clicking on the start button.
• Start the minecraft servers by clicking on the start button.

If you require further assistance, you can open a support ticket here!

Feedback and suggestions regarding this article are welcome on our Discord server

• Set up Velocity
• Prerequisites
• Create the Minecraft server(s) you want to link together
• Create the Velocity server
• Start the server
• Open the configuration file
• Configure the proxy
• Player data information forwarding
• Write down your forwarding secret
• Configure the server(s)
• Start the servers