☠️ BetterPunish

BetterPunish is a clean and powerful moderation plugin for Minecraft servers running Spigot or Paper.

It gives your staff team everything they need to handle punishments, reports, toxic chat, suspicious players, freeze checks, notes, alt accounts, and player history in one place. No messy command setup. No confusing workflow. Just fast moderation tools that are easy to use in-game.

If you want your server to feel safer, cleaner, and more professional, BetterPunish is built for that.

---

Why Server Owners Like It

• Fast punishments with bans, tempbans, mutes, tempmutes, shadowmutes, warns, and kicks.
• Progressive offense system that automatically escalates repeated rule breaks.
• Modern in-game GUIs for reports, punishments, chat review, and Vulcan suspects.
• Smart chat protection against spam, toxic messages, bypass attempts, and mute bypasses.
• Player freeze system for investigations, with automatic freeze-log punishment.
• Staff notes and player profiles so your team always has the full context.
• Alt-account detection to help spot repeat offenders.
• Supabase cloud sync support for servers that want remote storage.

---

Main Features

Punishments That Are Easy To Manage

BetterPunish supports the moderation actions most servers need every day:

• Permanent bans and temporary bans
• Permanent mutes and temporary mutes
• Shadowmutes, where the player thinks they are talking but nobody else sees it
• Warns and kicks
• Offline punishments
• Silent punishments with -s or --silent
• Multiple proof links or notes per punishment using /proof
• Full punishment history with /history

Progressive Offenses

Use /offend to punish players based on rule categories such as cheating, spam, toxicity, advertising, hate speech, and more.

The plugin tracks each player's offense count and can automatically move from warning to temporary ban to permanent ban. This helps staff stay consistent and prevents arguments about unfair punishments.

Chat Protection

BetterPunish helps keep chat readable and safe:

• Blocks spam and repeated messages
• Detects common bypass tricks like leetspeak and unicode abuse
• Sends blocked messages to a staff review queue
• Lets staff clear chat, mute global chat, or enable slowmode
• Stops muted players from bypassing mutes through commands, books, signs, or renamed items

Reports And Staff Tools

Players can report rule breakers with /report, and staff can manage reports through a simple GUI.

Staff also get useful tools for investigation and teamwork:

• /note for internal staff notes
• /pinfo or /check for a full player moderation profile
• /freeze and /unfreeze for screen checks or live investigations
• /livecmds and /livemsgs for live command and private-message monitoring

Freeze System

The freeze system locks suspicious players in place and shows clear instructions on their screen. You can also send them a clickable Discord support link.

If a frozen player leaves the server, BetterPunish can automatically issue a configurable freeze-log ban and alert staff instantly.

Vulcan AntiCheat Support

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

---

Installation

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

---

Commands & Permissions

Command	Description	Permission
/ban <player> <reason>	Ban a player.	betterpunish.ban
/tempban <player> <duration> <reason>	Temporarily ban a player.	betterpunish.tempban
/unban <player|id>	Remove an active ban and reset offenses.	betterpunish.unban
/mute <player> <reason>	Mute a player.	betterpunish.mute
/tempmute <player> <duration> <reason>	Temporarily mute a player.	betterpunish.tempmute
/shadowmute <player> <reason>	Shadowmute a player.	betterpunish.shadowmute
/unmute <player|id>	Remove a mute and reset offenses.	betterpunish.unmute
/offend <player> <reason> [-s]	Apply a progressive offense.	tggpunish.offend
/warn <player> <reason>	Warn a player, including offline players.	betterpunish.warn
/kick <player> <reason>	Kick a player.	betterpunish.kick
/check <player|id> or /pinfo	View player status, notes, freeze state, and alts.	betterpunish.checkban
/note <add|list|remove|clear> <player>	Manage staff notes.	betterpunish.note
/clearchat [all] [reason]	Clear global chat.	betterpunish.clearchat
/mutechat [reason]	Toggle global chat mute.	betterpunish.mutechat
/slowmode <seconds|off>	Set or disable chat slowmode.	betterpunish.slowmode
/freeze <player> [reason]	Freeze a player for investigation.	betterpunish.freeze
/unfreeze <player>	Unfreeze a player.	betterpunish.freeze
/history <player>	Show punishment history.	betterpunish.history
/punishgui	Open the active punishments GUI.	betterpunish.gui
/chatreview	Open the chat review GUI.	betterpunish.chatreview
/report <player> <reason>	Report a player.	betterpunish.report
/reports	Open the reports GUI.	betterpunish.reports
/proof <add|remove|list> <id> [url]	Manage proof links.	betterpunish.proof
/sus or /suspects	Open the Vulcan suspect GUI.	betterpunish.sus
/punishcleardb	Clear local and remote punishment databases.	betterpunish.cleardb
/punishmigrate	Migrate local storage to Supabase.	betterpunish.migrate
/punishpull	Pull cloud storage into local files.	betterpunish.pull

---

Best For

BetterPunish is a good fit for survival servers, SMPs, PvP servers, minigame networks, and any community that wants clear rules with consistent enforcement.

Install it, configure your punishments, and give your staff a faster way to keep the server clean.