Velocity is designed to be easy to configure and set up. Every Velocity file is stored in
velocity.toml, located in the directory where you started the proxy. Velocity uses the the TOML file format, as it is easy to understand and avoids pitfalls of YAML and other configuration formats common in the community.
An up-to-date version of the default configuration can be found on GitHub.
There are a few "special" data types in the Velocity configuration.
Chat messages may be provided in legacy color code format or in JSON format.
RGB support (using the
&#rrggbb format) is available and JSON messages are deserialized for Minecraft 1.16.
An address is a pairing of an IP address or hostname, and a port, separated by a colon (
:). For instance,
server01.example.com:25565 are valid addresses.
These settings mostly cover the basic, most essential settings of the proxy.
|String||This is the current config version used by Velocity. You should not alter this setting.|
|Address||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.|
|Chat||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.|
|Integer||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.|
|String||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.|
|Boolean||This setting determines whether Velocity should present itself as a Forge/FML-compatible server. By default, this is disabled.|
|Boolean||Allows restoring the vanilla behavior of kicking users on the proxy if they try to reconnect (e.g. lost internet connection briefly).|
|String||Allows forwarding nothing (the default), the |
|A server name||Address||This makes the proxy aware of a server that it can connect to.|
|Array||This specifies what servers Velocity should try to connect to upon player login and when a player is kicked from a server.|
|A host name||Hostname||This configures the proxy to create a forced host for the specified hostname. An array of servers to try for the specified hostname is the value.|
|Integer||This is the minimum size (in bytes) that a packet must be before the proxy compresses it. Minecraft uses 256 bytes by default.|
|Integer||This setting indicates what |
|Integer||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 |
|Integer||This setting determines how long the proxy will wait to connect to a server before timing out.|
|Integer||This setting determines how long the proxy will wait to receive data from the server before timing out.|
|Boolean||This setting determines whether or not Velocity should receive HAProxy PROXY messages. If you don't use HAProxy, leave this setting off.|
|Boolean||This setting allows you to enable TCP Fast Open support in Velocity. Your proxy must run on Linux for this setting to apply.|
|Boolean||This setting allows you to enable or disable support for the BungeeCord plugin messaging channel.|
|Boolean||This setting allows you to log ping requests sent by clients to the proxy.|
|Boolean||This setting allows you to enable or disable explicitly sending proxy commands to the client (for Minecraft 1.13+ tab completion).|
|Boolean||This setting allows you to determine if the proxy should failover or disconnect the user in the event of an unclean disconnect.|
|Boolean||Determines whether or not the proxy should log all commands run by the user.|
|Boolean||Whether or not Velocity should reply to Minecraft query protocol requests. You can usually leave this false.|
|Number||Specifies which port that Velocity should listen on for GameSpy 4 (Minecraft query protocol) requests.|
|String||Specifies the map name to be shown to clients.|
|Boolean||Whether or not Velocity plugins are included in the query responses.|
|Boolean||Whether or not Velocity should send metrics to bStats.|
|UUID||A randomly generated UUID that uniquely identifies your Velocity server. Do not alter this setting.|
|Boolean||Whether or not Velocity should log whenever it fails to connect to bStats.|