Do I need to keep online-mode enabled on my backend servers?

No, you must set online-mode to false on all backend servers. Velocity handles the authentication process securely, so your backend servers must trust the proxy.

Can I run Velocity on the same server as my game world?

It is highly recommended to run Velocity on its own dedicated instance to ensure network stability and security for your entire network.

How do I change the amount of RAM allocated to my proxy?

On AwakeNode, simply upgrade your plan and the memory allocation will update automatically. On other hosts, you must manually edit the -Xmx flag in your startup script.

Is Velocity compatible with BungeeCord plugins?

No, Velocity uses its own unique API. You must use plugins specifically designed for the Velocity platform.

How to Setup a Velocity Proxy for Minecraft Hubs

Introduction to Velocity

Velocity is a high-performance Minecraft proxy designed to connect multiple server instances into a single network. It is the modern standard for hub-based networks, offering superior scalability and security compared to older alternatives like BungeeCord.

Prerequisites

To run a Velocity proxy, you will need:

A dedicated server instance for the proxy (do not run this on the same instance as your backend servers).
Java 17 or higher installed on your proxy instance.
A set of backend servers (Paper, Purpur, or Spigot) configured in 'online-mode=false'.

Configuring the Proxy

On AwakeNode

Download the latest Velocity .jar and upload it in the Files tab. In the Startup tab, choose a custom server jar and point it at that file.
Once installed, use the File Manager to edit the velocity.toml file directly in your browser.
Restart your server via the panel to apply changes.

On other hosts / manually

Download the latest Velocity .jar from the official website.
Create a startup script or command to run the jar file.
Edit the velocity.toml file via SFTP or your host's file editor to define your backend servers under the [servers] section.

Connecting Backend Servers

For your backend servers to accept connections from Velocity, you must modify the server.properties file:

Set online-mode=false (Velocity handles authentication).
Set network-compression-threshold=256.
Ensure server-port matches the port defined in your velocity.toml.

Important: Memory and Startup Flags

Velocity is lightweight, but performance depends on your network traffic.

On AwakeNode: To add your own JVM flags, set a custom startup command in your server's Startup tab. If you require more memory, simply upgrade your plan (choose Upgrade on your server's page); the Xmx values will update automatically without manual config.

How to build a hub server Velocity