Punishments
Punishments
Voxy provides a full punishment suite with bans, mutes, blacklists, warns, and kicks. All punishments are stored in MongoDB and synced across your network via Redis.
Punishment Types
| Type |
Effect |
| Ban |
Blocks player from joining the network |
| Mute |
Blocks player from sending chat messages |
| Blacklist |
Like a ban, but also applies to detected alt accounts |
| Warn |
Issues a warning, tracked in history |
| Kick |
Removes player from the server immediately |
Issuing Punishments
All punishment commands accept these common flags:
| Flag |
Description |
-t <duration> |
Duration (e.g. 7d, 2h). Omit for permanent. |
-s |
Silent - broadcasts the punishment only to staff (voxy.staff); omit it and the punishment is announced publicly |
--extend |
Extend an existing active punishment |
| Command |
Permission |
Description |
/ban <player> [-t] [-s] [--extend] <reason> |
voxy.ban |
Ban a player |
/mute <player> [-t] [-s] [--extend] <reason> |
voxy.mute |
Mute a player |
/blacklist <player> [-t] [-s] [--extend] <reason> |
voxy.blacklist |
Blacklist a player |
/warn <player> [-s] <reason> |
voxy.warn |
Issue a warning |
/kick <player> [-s] <reason> |
voxy.kick |
Kick a player |
Removing Punishments
| Command |
Permission |
Description |
/unban <player> |
voxy.unban |
Remove a ban |
/unmute <player> |
voxy.unmute |
Remove a mute |
/unblacklist <player> |
voxy.unblacklist |
Remove a blacklist |
/unwarn <player> |
voxy.unwarn |
Remove the most recent warning |
Punishment Ladders
Ladders define a progression of escalating punishments. When a player is punished on a ladder, they automatically advance to the next step.
Configure ladders in ladders.yml (proxy) or manage them via the /ladders GUI.
| Command |
Permission |
Description |
/punish <player> <ladder> [-s] <reason> |
voxy.punish |
Apply the next step of a ladder |
/ladders |
voxy.admin |
Open ladder management GUI |
Staff Rollback
| Command |
Permission |
Description |
/staffrollback <staff> [-t <duration>=1h] |
voxy.staffrollback |
Revert all punishments issued by a staff member in the given window |
Viewing History
| Command |
Permission |
Description |
/history [player] |
voxy.history |
Punishment history for a player — click any entry to edit its reason |
/staffhistory <staff> [-t <duration>] |
voxy.staffhistory |
All punishments issued by a staff member |
/chatlogs <player> <duration> [page] [--upload] |
voxy.chatlogs |
Recent chat messages. --upload posts the full log to a paste URL instead of paging in chat. |
/commandlogs <player> <duration> [page] [--upload] |
voxy.commandlogs |
Recent command usage. --upload posts the full log to a paste URL instead of paging in chat. |
/clearviolations [player] |
voxy.clearviolations |
Clear all punishments and ladder progress |
The history menu shows each punishment's type, reason, duration, revoke status, and date. Click any punishment entry to open a chat prompt and edit its reason — type the new reason or cancel to abort.
PunishmentGuard
Voxy enforces rank-based restrictions on who can punish whom. A staff member cannot punish a player whose rank has a higher priority than their own. Enforced automatically — no extra configuration needed.