Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
192 lines (159 sloc) 12.3 KB

Configuring Velocity

Velocity has been designed to be simple and unambigous to configure.

The configuration file

Velocity is largely configured from the velocity.toml file. This file is created in the directory where you started the proxy.

The configuration format

Before we continue, it is useful to take a step back and note that Velocity uses the TOML format for its configuration. TOML was designed to be easy to understand, so you should not have difficulty understanding Velocity's configuration file.

Root section

These settings mostly cover the basic, most essential settings of the proxy.

Setting name Type Default Description
bind Address 0.0.0.0:25577 This tells the proxy to accept connections on a specific IP. By default, Velocity will listen for connections on all IP addresses on the computer on port 25577.
motd Chat &3A Velocity Server This allows you to change the message shown to players when they add your server to their server list. You can use legacy Minecraft color codes or JSON chat.
show-max-players Integer 500 This allows you to customize the number of "maximum" players in the player's server list. Note that Velocity doesn't have a maximum number of players it supports.
player-info-forwarding Mode modern This allows you to customize how player information such as IPs and UUIDs are forwarded to your server. See the "Player info forwarding" section for more information.
player-info-forwarding-secret String 5up3r53cr3t This setting is used as a secret to ensure that player info forwarded by Velocity comes from your proxy and not from someone pretending to run Velocity. See the "Player info forwarding" section for more info.
announce-forge Boolean false This setting determines whether or Velocity should present itself as a Forge/FML-compatible server. By default, this is disabled.

server section

Setting name Type Default Description
A server name Address See the default configuration below. This makes the proxy aware of a server that it can connect to.
try Array ["lobby"] This specifies what servers (in order Velocity should try to connect to upon player login and when a player is kicked from a server.

advanced section

Setting name Type Default Description
compression-threshold Integer 1024 This is the minimum size (in bytes) that a packet has to be before the proxy compresses it. Minecraft uses 256 bytes by default. Velocity uses a higher value for efficiency.
compression-level Integer -1 This setting indicates what zlib compression level the proxy should use to compress packets. The default value uses the default zlib level, which is dependent on the zlib version. This number goes from 0 to 9, where 0 means no compression and 9 indicates maximum compression.
login-ratelimit Integer 3000 This setting determines the minimum amount of time (in milliseconds) that must pass before a connection from the same IP address will be accepted by the proxy. A value of 0 disables the rate limit.

query section

Setting name Type Default Description
enabled Boolean false Whether or not Velocity should reply to GameSpy 4 (Minecraft query protocol) requests. You can usually leave this false.
port Number 25577 Specifies which port that Velocity should listen on for GameSpy 4 (Minecraft query protocol) requests.

The default configuration

Below is the default configuration file for Velocity, velocity.toml.