Official documentation
Network
A free Velocity security aggregator that combines login, client, movement, combat, punishment and report signals into player risk profiles.
Getting started
Installation
- 1
Stop the Velocity proxy completely.
- 2
Install every required dependency listed below before NetworkSecurityScore.
- 3
Place NetworkSecurityScore.jar inside the plugins folder.
- 4
Start the Velocity proxy and review the generated NetworkSecurityScore 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 |
|---|---|---|
/securityscore <player> | Shows a player's score. | networksecurityscore.admin |
/securityscore inspect <player> | Shows the full security profile. | networksecurityscore.admin |
/securityscore top | Lists the highest-risk profiles. | networksecurityscore.admin |
/securityscore history|ip <player> | Shows profile history or IP information. | networksecurityscore.admin |
/securityscore trust <player> [amount] | Changes trust score. | networksecurityscore.admin |
/securityscore event <player> <delta> <detail> | Adds a manual security event. | networksecurityscore.admin |
/securityscore reset <player> | Resets a profile. | networksecurityscore.admin |
/securityscore actions | Shows automatic action settings. | networksecurityscore.admin |
/securityscore reload | Reloads configuration. | networksecurityscore.admin |
Access control
Permissions
| Permission | Default | Description |
|---|---|---|
networksecurityscore.admin | Administrators | Allows security profile administration. |
networksecurityscore.alerts | Administrators | Receives configured score alerts. |
Server setup
Configuration notes
- Tune category weights, score limits, trust gains and automatic actions in config.properties.
Important notes
- Profiles and event history are stored locally by the proxy plugin.
Visual guide
Images