How to Set Up a Velocity Minecraft Server

7 min. readlast update: 11.05.2024

⚡WHAT IS VELOCITY?

Velocity is a high-performance Minecraft proxy server designed to connect multiple Minecraft servers into a single network. It enhances server performance and reliability, providing a seamless player experience. Velocity is a preferred and more secure option compared to Bungeecord networks

To use Velocity, you will first need two external servers of any RAM size that accomodates your ideal server set up. RAM packages & prices can be found HERE. If you are unsure of how much RAM you will need for your external servers, take a look at our RAM Calculator!

🚧 PRE-INSTALLATION

PROXY PRE-INSTALLATION STEPS

1. Accessing the Proxy Server

  • After purchasing your proxy server, you will receive an email confirming the creation of your account. This process is similar to purchasing a non-proxy server. The proxy server will also appear in your game panel account Simple Game Hosting Panel.

2. Turn Off the Proxy Server

  • Once you access your Proxy server, navigate to the "Console" tab to turn the server off. This is crucial to prevent any issues during the setup process.

3. Delete Existing Files on Proxy Server

  • Navigate to the file manager.
  • Delete all existing files. You can do this by:
    • Selecting each file individually, or Using the checkbox at the top left corner to select all files at once.
    • Ensure all files are deleted. Double-check that the server is turned off before making any changes.

EXTERNAL SERVER PRE-INSTALLATION STEPS

1. Turn off External Servers:

  • To locate your External Servers, navigate to the home page of the Game Panel. Open each External Server, go to the Console tab, and turn them offline.

2. Delete Existing Files:

  • Navigate to the File Manager. 
  • Select and delete all files except the ".eula.txt" file. You can select files individually or use the checkbox at the top left to select all files at once (see image below step 1).

3. Install Game Version:

  • Go to the Versions tab. 
  • Use the dropdown to find the desired game version, then click "Install."
  • Once the installation is complete, go to the Console tab

4. Restart Extenal Servers:

  • Turn the server on and wait for it to load fully.
  • Turn the server off again
  • Note your server address at the top right of the console; you will need this to configure Velocity.

🔨 INSTALLING & CONFIGURING VELOCITY ON YOUR PROXY

1. Installing Velocity:

💡 There are two ways to install Velocity, we'll be focusing on using the Version Installer through the Game Panel.  If you have the Velocity .jar file you want to use, you can simply upload it to your. File Manager and rename the file "server.jar". Once that's complete, head over to the Console and turn the server online and proceed to Step 2 below.

  • Once all the files have been deleted from the File Manager, navigate to the Versions tab on you Control Panel and use the drop down to select Velocity. Once that's chosen, you will see a few different Velocity options, select the most recent version you see which is Velocity 3.3.0-SNAPSHOT. Click Install and let the installer run.
  • After setting up the server with the correct version of Velocity, go to the console tab in your control panel and turn the server on.
  • Wait for the server to load fully, then turn it back off.

2. Editing velocity.toml File:

  • Navigate to the file manager and open the velocity.toml file by clicking on it.

  • On Line 5: Change the port to your proxy server's port (found at the top right of the console tab in the Control Panel). 

  • On Line 37: Change player-info-forwarding-mode from "NORMAL" to "modern". 

💡 Modern forwarding is a Velocity-native format. It forwards all player information in an efficient binary format and employs a MAC code to make it much more difficult to trick the server into impersonating your Velocity proxy. However, it is only available for Minecraft 1.13 or higher. It is highly recommend this is setup to secure your network. 

  • On Line 75-77: Name your lobbies. These can be anything you want but it's best to keep them short, simple, and easy to remember. Replace the green text with your external server addresses including the port, ordering them by priority when what world for players to spawn in when connecting to the proxy. 
  • On Line 80: Match the green text to the lobby names you set on Line 75.
  • On Lines 84-93: Delete everything on these lines.

  • Save your changes by clicking the purple "Save Content" button at the top right.

3. Edit forwarding.secret File:

  • Open the "forwarding.secret" file. This is the passphrase for secure communication between your proxy and external servers.
  • Copy the existing passphrase or create a new one. Save any changes

4. Restart Proxy Server:

  • Turn the proxy server back on, wait for it to load, and then turn it off again.

🔨 SETTING UP YOUR EXTERNAL SERVERS

1. Install Game Version:

  • Install the necessary game version from the Versions tab in the control panel. 
  • Turn the server off once the installation is complete.

2. Edit server.properties File:

  • Open the 'server.properties file' in the File Manager.
  • Line 24 and Set 'online-mode' to 'false'.
  • Save your changes using the Save Content button at the top right of the file.

3. Edit paper-global,yml File:

  • In your File Manager, find the 'config' file commonly found towards the top of your File Manager and click to open it.

  • Open the 'paper-global.yml' file.

  • Line 89: Find the 'proxies' section.
  • Line 93: Under Velocity, set 'enabled' to 'true'
  • Line: 96: Enter your secret (passphrase) between the green apostrophes.
  • Save your changes using the Save Content button at the top right.

3. Repeat Set Up on External Servers

  • Repeat steps 1-3 listed above on all of your External Servers.

🏁FINAL STEPS

1. Turning on Servers:

  • Open up your Proxy Server and navigate to the Console tab, turn the Proxy server on and wait for it to load. 
  • Navigate to your External servers and repeat the same process of turning them on. 

2. Connect to Your Network:

  • Copy your proxy server address from the top right of the console tab and use it to connect through Minecraft's multiplayer. If everything is configured correctly, you should be connected to your server. 🥳Congratulations🥳
  • Players will use the Proxy server to connect to the Server as well. Follow this guide on Joining Your Minecraft Server

🚨TROUBLESHOOTING TIPS

⚠️Connection Issues:

  • Ensure all server addresses and ports are correctly entered
  • Double-check that 'online-mode' is set to 'false' in all external servers.

⚠️Proxy Server Not Starting:

  • Verify that the 'velocity.toml' and 'forwarding.secret files' are correctly configured and saved.

⚠️Authentication Problems:

  • Confirm the secret passphrase is identical in both the 'forwarding.secret' file and the 'paper-global.yml' files on all external servers.

⚠️Game Version Errors:

  • Ensure the game version installed on your external servers matches the version required for your setup

🚨 If you continue to experience issues, visit the Velocity Website for additional troubleshooting tips and configuration information. If problems persist after following the troubleshooting steps and re-configuring your servers, please contact our support team through a Support Ticket or contact us directly on LiveChat.

Create a Support Ticket Here

Contact us on LiveChat Here

🔗EXTERNAL LINKS

Velocity Getting Started Guide

Velocity How-to Guides

Velocity Reference Guide

Was this article helpful?