How to build a hub server Velocity

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

1. Use the Version Changer in your panel to select 'Velocity' as your server type.
2. Once installed, use the File Manager to edit the velocity.toml file directly in your browser.
3. Restart your server via the panel to apply changes.

On other hosts / manually

1. Download the latest Velocity .jar from the official website.
2. Create a startup script or command to run the jar file.
3. 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: We automatically optimise your startup flags for Velocity. If you require more memory, simply upgrade your plan in the client area; the Xmx values will update automatically without manual config.
• On other hosts: You will need to manually edit your startup command to include -Xmx flags. If you experience lag or connection drops, contact your host's support team to review your JVM garbage collection settings.