VelocityGuard is a port of the amazing plugin BungeeGuard and functions the same way. VelocityGuard is a pair of plugins that uses the GameProfile of a player to verify whether a player is connected from a trusted Velocity instance or not.
- On Velocity, VelocityGuard inserts a special authentication token into GameProfile data which, when sent to a backend server will be verified when a player attempts to connect.
- On the backend instance, VelocityGuard listens for players logging in and retrieves GameProfile data and verifies the token is not only present but is on the list of authorized tokens allowed to connect.
What all of this does is it allows absolutely no one to join (even through a proxy server) without knowing a correct, authorized token.
-
Please don't confuse VelocityGuard with Velocity's built in modern forwarding, VelocityGuard is meant to solve a completely different problem
-
The best way to have VelocityGuard set up is to have your Velocity instance have it's forwarding mode set to
legacy
and have your backend server'sbungeecord
mode enabled. -
If you're using PaperSpigot please do NOT use the
paper.yml
velocity-support
configuration entry as it's not the same thing as VelocityGuard.
Download the latest release of VelocityGuard through the releases tab in GitHub!
-
Copy the
velocityguard-proxy.jar
file to the Velocityplugins
folder and then proceed to restart the proxy. -
Inside the
plugins
folder there should be a new folder calledvelocityguard
. Open the file calledtoken.json
inside thevelocityguard
folder and copy down the value oftoken
(Your token should be 64 characters long).
-
Copy the
velocityguard-backend.jar
file into yourplugins
folder and restart the server. -
Inside the
plugins
folder (or the config directory for the Sponge users) there should be a new folder calledvelocityguard
. Open the fileconfig.yml
inside thevelocityguard
folder. -
Add the token(s) generated by your proxy(-ies) to the
allowed-tokens
list.e.g.
# Put the allowed authentication tokens in the list below allowed-tokens: - "gpZCEOe9u0p4KKV8Tgf1TxDrE5ZzcOCfs3JunDi82CvRuHQgeCoxKUladkYDTyBb"
-
Restart the server.
Please don’t ask the Velocity Discord for help, this is not an official velocity-made plugin so they cannot offer the same level of support