Join our Discord and be part of our community!

Set up Velocity Minecraft

In this guide, we will show you how to connect with Velocity Minecraft. The guide will cover a whole Velocity server setup. By following this guide, you will know how to setup velocity.

When connecting multiple individual Minecraft servers, you need to use a proxy server. Of all the currently available options, such as BungeeCord and Waterfall, Velocity is recommended mainly because it has the most users and, hence, the most available support.

Prerequisites

• Two Minecraft servers you want users to play on.
• A proxy server.

Create Minecraft Servers

• Create the servers that you want to link together.

Install Velocity

• If you do not have a proxy server setup, head to the 1 Change Version tab.
• 2 Select Velocity and install the latest version.

Start the Server

• After the installation, start the server for the first time to generate the necessary default configuration files.
• After the server has been started, please wait for it to complete generating the configuration files indicated by the Server marked as running output in the console, as shown below.

Navigate to Files

• Go to the 1 Files tab.
• Open the 2 velocity.toml configuration file.
• Scroll down to the sections [servers] and [forced-hosts].
• These sections must be modified in the next step for the proxy to work correctly.

Configure the Proxy

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

• The servers are linked using the IP:Port, which is found in the list of servers.
• Click the server address to copy to the clipboard.

┌──────────────┐
│ Proxy Server │
└┬─────────────┘
 │  Server 1
 ├─►149.40.59.139:20780
 │
 │  Server 2
 └─►149.40.59.139:20012

• The server will be configured as follows:
• Server 1 will be called the 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 that point, the player can 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:

Forward Player Data

• 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 run 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 in Velocity’s information forwarding configuration page.

Note Forwarding Secret

• Open the forwarding.secret file.
• Note the forwarding secret inside the file. You will need to configure the Minecraft servers being linked. Do not share it with anyone.

Configure the Server(s)

• Click on the Minecraft server(s) Files tab.
• Open the server.properties file.
• Set online-mode to false and save the changes.
• Open the config/paper-global.yml file.
• Under the proxies>velocity section, 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 and Minecraft servers by clicking on the Start button.

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

Feedback and suggestions can be submitted here or further discussed on our Discord server.

• Set up Velocity Minecraft
• Prerequisites
• Create Minecraft Servers
• Install Velocity
• Start the Server
• Navigate to Files
• Configure the Proxy
• Forward Player Data
• Note Forwarding Secret
• Configure the Server(s)
• Start the Servers