GherrixDevPlugins & Resources

Official documentation

NetworkPunishments

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

NetworkPunishments cover

Getting started

Installation

  1. 1

    Stop the Velocity proxy completely.

  2. 2

    Install every required dependency listed below before NetworkPunishments.

  3. 3

    Place NetworkPunishments.jar inside the plugins folder.

  4. 4

    Start the Velocity proxy and review the generated NetworkPunishments configuration folder.

  5. 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

CommandDescriptionPermission
/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

PermissionDefaultDescription
networkpunishments.banAdministratorsAllows banning players.
networkpunishments.unbanAdministratorsAllows removing bans.
networkpunishments.kickAdministratorsAllows kicking players.
networkpunishments.muteAdministratorsAllows muting players.
networkpunishments.unmuteAdministratorsAllows removing mutes.
networkpunishments.banipAdministratorsAllows IP bans.
networkpunishments.unbanipAdministratorsAllows removing IP bans.
networkpunishments.checkAdministratorsAllows 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