Hero image

Knowledge Base

How To Setup And Install A Velocity Proxy

Proxy servers like Velocity aren’t available on the free plan.

What is Velocity?

Velocity is a Minecraft proxy designed to seamlessly connect multiple servers, allowing players to navigate between them without leaving the game.

Creating and Configuring the Proxy

  1. Log in to the Dashboard.

  2. Choose a server from your server list.

  3. Go to the Versions page, select and install Velocity.

  4. Launch your server.

  5. Click Stop, then click Kill.

  6. Navigate to the File Manager.

  7. Open velocity.toml.

  8. Find bind and change the value after : to your server’s port. You can find your server’s port on the Network page.

  9. Find player-info-forwarding-mode and change it to:

    modern if all your servers are on version 1.13 or above;

    legacy if you have servers below version 1.13;

    none if you don’t want to forward player info;

    You can read more about player-info-forwarding-mode here.

  10. Find the [servers] section.

  11. Enter the server’s address in the following format: server-name = "IP:port"

    Change server-name to the fallback server name (case-sensitive).

    Change IP:port to the IP and port of the fallback server. You can find it on the Network page of your fallback server.

    If you have multiple fallback servers, duplicate the above template and paste it under your first server.

  12. Find try = [] and enter the server-name of the server you want your players to join when they connect.

  13. Scroll down to the [forced-hosts] section.

    Forced Hosts is a way to have multiple subdomains automatically redirect to another server, overriding the default server we set in the previous step.

    If you are interested in using this feature, please follow this guide from Paper.

    If you aren’t using this feature, delete all example values before the [advanced] section.

    You can create multiple .falixsrv.me subdomains on the Subdomains page.

  14. Save the file and go back to the File Manager.

  15. Open the forwarding.secret file.

  16. Copy the contents of the file and save them for later. This is the password your proxies will use for communicating with each other.

  17. Go back to the Console and restart your proxy server.

Preparing a fallback server

    1. Navigate to the File Manager.

    2. Open the config folder and open the paper-global.yml file.

    3. Go to the velocity section.

    4. Set enabled to true.

    5. Insert the key from forwarding.secret between '' in the secret: parameter.

      You can find the key in the forwarding.secret file on your Velocity proxy server.

    6. Save the file and return to the File Manager.

    7. Go back to the root directory and open the server.properties file.

    8. Change online-mode to false.

    9. Save the file and restart the server.

    1. Install the fabricproxy-lite mod on the server like explained in our adding mods guide.

    2. Start the server to generate the config file.

    3. Navigate to the File Manager.

    4. Open the config folder and open the FabricProxy-Lite.toml file.

    5. Insert the key from forwarding.secret between "" in the secret = parameter.

      You will have to enable hackEarlySend if LuckPerms is installed.

    6. Save the file and return to the File Manager.

    7. Go back to the root directory and open the server.properties file.

    8. Change online-mode to false.

    9. Save the file and restart the server.

    1. Install the proxy-compatible-forge mod on the server like explained in our adding mods guide.

    2. Start the server to generate the config file.

    3. Navigate to the File Manager.

    4. Open the config folder and open the pcf-common.toml file.

    5. Insert the key from forwarding.secret between "" in the forwardingSecret = parameter.

    6. Save the file and return to the File Manager.

    7. Go back to the root directory and open the server.properties file.

    8. Change online-mode to false.

    9. Save the file and restart the server.

Velocity Commands

These are the most often used Velocity commands:

Command Description Permission Group
/server <target> Moves you to the desired server. velocity.command.server everyone
/glist Lists all players on the network. velocity.command.glist admin-only
/send <player> <target> Sends the specified player to the specified server. velocity.command.send admin-only
/velocity reload Reloads the Velocity configuration. velocity.command.reload admin-only
/velocity plugins Shows a list of all active velocity plugins. velocity.command.plugins admin-only
/shutdown Stops the velocity server gracefully. console-only console

A full list of Velocity commands can be found here.