🚀 UltraServers Relaunch We're thrilled to announce the relaunch of our service with a brand-new, streamlined panel designed to enhance your gaming experience. Join our Discord for more information, lifetime discounts and to take part in our $175 raffle to win Steam gift cards.
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 theplayer-info-forwarding-mode
tomodern
.
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
andonline-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