Official documentation
Network
A free Velocity security plugin that records client fingerprints, risk signals and profile history for network moderation.
Getting started
Installation
- 1
Stop the Velocity proxy completely.
- 2
Install every required dependency listed below before NetworkClientGuard.
- 3
Place NetworkClientGuard.jar inside the plugins folder.
- 4
Start the Velocity proxy and review the generated NetworkClientGuard 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
No external dependencies are required.
Reference
Commands
Administration commands
| Command | Description | Permission |
|---|---|---|
/clientguard status | Shows service status. | networkclientguard.admin |
/clientguard check <player> | Inspects a player's current profile. | networkclientguard.admin |
/clientguard history <player> | Shows stored profile history. | networkclientguard.admin |
/clientguard list | Lists monitored profiles. | networkclientguard.admin |
/clientguard reload | Reloads configuration. | networkclientguard.admin |
Access control
Permissions
| Permission | Default | Description |
|---|---|---|
networkclientguard.admin | Administrators | Allows client profile administration. |
networkclientguard.alerts | Administrators | Receives client risk alerts. |
Server setup
Configuration notes
- Configure scoring, blocked brands and alert behavior in config.properties.
Important notes
- Install NetworkClientGuardPaper on backends that need access to the Velocity client profile.
Visual guide
Images