# ☠️ BetterPunish

[![Platform](https://img.shields.io/badge/Platform-Spigot%20%7C%20Paper-E03C31?style=for-the-badge&logo=minecraft&logoColor=white)](https://papermc.io) [![Java](https://img.shields.io/badge/Java-21%2B-F8981D?style=for-the-badge&logo=openjdk&logoColor=white)](https://www.oracle.com/java/) [![Version](https://img.shields.io/badge/Version-1.3.0-2EA44F?style=for-the-badge&logo=modrinth&logoColor=white)](https://modrinth.com)

**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 ` | Ban a player. | `betterpunish.ban` | | `/tempban ` | Temporarily ban a player. | `betterpunish.tempban` | | `/unban ` | Remove an active ban and reset offenses. | `betterpunish.unban` | | `/mute ` | Mute a player. | `betterpunish.mute` | | `/tempmute ` | Temporarily mute a player. | `betterpunish.tempmute` | | `/shadowmute ` | Shadowmute a player. | `betterpunish.shadowmute` | | `/unmute ` | Remove a mute and reset offenses. | `betterpunish.unmute` | | `/offend [-s]` | Apply a progressive offense. | `tggpunish.offend` | | `/warn ` | Warn a player, including offline players. | `betterpunish.warn` | | `/kick ` | Kick a player. | `betterpunish.kick` | | `/check ` or `/pinfo` | View player status, notes, freeze state, and alts. | `betterpunish.checkban` | | `/note ` | Manage staff notes. | `betterpunish.note` | | `/clearchat [all] [reason]` | Clear global chat. | `betterpunish.clearchat` | | `/mutechat [reason]` | Toggle global chat mute. | `betterpunish.mutechat` | | `/slowmode ` | Set or disable chat slowmode. | `betterpunish.slowmode` | | `/freeze [reason]` | Freeze a player for investigation. | `betterpunish.freeze` | | `/unfreeze ` | Unfreeze a player. | `betterpunish.freeze` | | `/history ` | Show punishment history. | `betterpunish.history` | | `/punishgui` | Open the active punishments GUI. | `betterpunish.gui` | | `/chatreview` | Open the chat review GUI. | `betterpunish.chatreview` | | `/report ` | Report a player. | `betterpunish.report` | | `/reports` | Open the reports GUI. | `betterpunish.reports` | | `/proof [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.

BetterPunish

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Ban Reasons

Punish Menu

Punishment History

Ban Screen