NetworkGuardPaper
OptionalStrongly recommended to enforce authentication on every backend.
Official documentation
Network
A free Velocity authentication system for mixed-mode networks with secure password storage, premium verification and backend state signing.
Getting started
Installation
- 1
Stop the Velocity proxy completely.
- 2
Install every required dependency listed below before NetworkGuard.
- 3
Place NetworkGuard.jar inside the plugins folder.
- 4
Start the Velocity proxy and review the generated NetworkGuard configuration folder.
- 5
Test the plugin on a staging server before enabling it for all players.
Supported environments
Compatibility
1.0.0Plugin version
Velocity networksMinecraft
VelocityServer software
Java 17 or newerRuntime
Integrations
Dependencies
Reference
Commands
Player commands
| Command | Description | Permission |
|---|---|---|
/register <password> <password> | Registers a new offline-mode account. | None |
/login <password> | Authenticates a registered account. | None |
/logout | Ends the current authenticated session. | None |
/premium | Starts premium-account verification. | None |
Access control
Permissions
This plugin does not define public permission nodes.
Server setup
Configuration notes
- Configure primary-hub, hub-servers, forwarding and the generated backend shared secret in config.properties.
Important notes
- Expose only the Velocity port publicly and firewall every backend port.
- Use modern Velocity forwarding with the same forwarding secret on every backend.
Visual guide
Images