Official documentation
Network Punishments
A free network punishment system for Velocity with temporary and permanent bans, IP bans, kicks, mutes and stored records.

Getting started
Installation
- 1
Stop the Velocity proxy completely.
- 2
Install every required dependency listed below before NetworkPunishments.
- 3
Place NetworkPunishments.jar inside the plugins folder.
- 4
Start the Velocity proxy and review the generated NetworkPunishments 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
Staff commands
| Command | Description | Permission |
|---|---|---|
/ban <player> [duration] [reason] | Bans a player. | networkpunishments.ban |
/unban <player> | Removes a player ban. | networkpunishments.unban |
/kick <player> [reason] | Kicks a player. | networkpunishments.kick |
/mute <player> [duration] [reason] | Mutes a player. | networkpunishments.mute |
/unmute <player> | Removes a mute. | networkpunishments.unmute |
/banip <ip|online-player> [duration] [reason] | Bans an IP address. | networkpunishments.banip |
/unbanip <ip> | Removes an IP ban. | networkpunishments.unbanip |
/punishcheck <player> | Shows stored punishments. | networkpunishments.check |
Access control
Permissions
| Permission | Default | Description |
|---|---|---|
networkpunishments.ban | Administrators | Allows banning players. |
networkpunishments.unban | Administrators | Allows removing bans. |
networkpunishments.kick | Administrators | Allows kicking players. |
networkpunishments.mute | Administrators | Allows muting players. |
networkpunishments.unmute | Administrators | Allows removing mutes. |
networkpunishments.banip | Administrators | Allows IP bans. |
networkpunishments.unbanip | Administrators | Allows removing IP bans. |
networkpunishments.check | Administrators | Allows punishment lookup. |
Server setup
Configuration notes
- Punishments are stored in plugins/networkpunishments/punishments.properties.
Important notes
- Durations support values such as 30s, 10m, 2h, 7d and perm.
Visual guide
Images
