BetterPunish

BetterPunish

A clean moderation suite for Paper servers.

BetterPunish helps your staff team handle punishments, reports, toxic chat, suspicious players, freeze checks, staff notes, alt accounts, and player history from one plugin.

It is built for servers that want moderation to feel fast, clear, and consistent without forcing staff through a messy workflow.

Why use BetterPunish?

• Fast punishments for bans, tempbans, mutes, tempmutes, shadowmutes, warns, and kicks.
• Progressive offenses to keep repeated rule breaks fair and consistent.
• Chat protection against spam, toxic messages, bypass attempts, and mute bypasses.
• Staff tools for reports, notes, player profiles, and live investigations.
• Freeze checks with clear player instructions and freeze-log protection.
• Alt detection to help identify repeat offenders.
• Vulcan support for suspect tracking when Vulcan AntiCheat is installed.

Main features

Punishments

BetterPunish includes the punishment tools most public servers need every day:

• Permanent bans and temporary bans
• Permanent mutes and temporary mutes
• Shadowmutes
• Warns and kicks
• Offline punishments
• Silent punishments with -s or --silent
• Proof links and notes for punishment evidence
• Punishment history lookup

Progressive offense system

The /offend command lets staff punish by rule category instead of manually choosing a punishment every time.

Examples include cheating, spam, toxicity, advertising, hate speech, and other configured categories.

BetterPunish tracks repeated offenses and can automatically escalate from warning to temporary ban to permanent ban. This helps staff stay consistent and reduces arguments about unfair punishment decisions.

Chat protection

BetterPunish helps keep chat clean and readable:

• Blocks repeated spam messages
• Detects common bypass tricks such as leetspeak and unicode abuse
• Sends blocked messages to a staff review queue
• Supports global chat clear, mutechat, and slowmode
• Prevents muted players from bypassing punishments through commands, signs, books, or renamed items

Reports and staff workflow

Players can report rule breakers with /report, while staff can manage reports through an in-game GUI.

Staff also get useful tools for teamwork and investigation:

• /note for internal staff notes
• /pinfo and /check for a complete player moderation profile
• /freeze and /unfreeze for live investigations
• /livecmds and /livemsgs for real-time command and private-message monitoring

Freeze system

The freeze system is made for investigations and screen checks.

When a player is frozen, BetterPunish can:

• Lock the player in place
• Block movement, combat, inventory actions, and restricted commands
• Show clear title, subtitle, actionbar, and chat instructions
• Send a clickable Discord support link
• Alert staff if the player disconnects
• Apply a configurable freeze-log punishment

Vulcan AntiCheat integration

If Vulcan is installed, BetterPunish can track suspicious players, calculate suspect scores, and show staff a suspect dashboard with /sus or /suspects.

Installation

1. Download the latest BetterPunish jar.
2. Put it into your server's plugins folder.
3. Start or restart the server.
4. Edit config.yml to match your rules and style.
5. Give your staff the permissions they need.

Commands

• /ban - Ban a player
• /tempban - Temporarily ban a player
• /unban - Remove an active ban
• /mute - Mute a player
• /tempmute - Temporarily mute a player
• /shadowmute - Shadowmute a player
• /unmute - Remove an active mute
• /offend - Apply a progressive offense
• /warn - Warn a player
• /kick - Kick a player
• /history - View punishment history
• /check or /pinfo - View a player moderation profile
• /note - Manage staff notes
• /clearchat - Clear global chat
• /mutechat - Toggle global chat mute
• /slowmode - Set chat slowmode
• /freeze and /unfreeze - Manage player freezes
• /report and /reports - Submit and manage reports
• /chatreview - Review blocked chat messages
• /punishgui - Open the punishment dashboard
• /proof - Manage proof links
• /sus or /suspects - Open the Vulcan suspect GUI

Best for

BetterPunish is a good fit for survival servers, SMP communities, PvP servers, minigame servers, and networks that want stronger staff tools without making moderation complicated.

Use it to keep chat cleaner, make punishments more consistent, and give your staff a faster way to protect the server.