## EasyPunish A punishment management plugin built for Paper, Purpur, and Folia 1.21+ servers. --- ## About EasyPunish EasyPunish is a moderation plugin built to make server moderation fast and organized. Instead of dealing with messy commands and lost punishment times, EasyPunish gives every punishment a unique 6-digit ID, includes full GUI menus for staff, integrates directly with LuckPerms for voice-chat mutes, and lets players appeal their punishments directly in-game. --- ## Features - **6-Digit Punishment IDs**: Every ban, mute, warn, and voice mute gets a unique 6-digit ID. If you unpunish someone early, the remaining time is saved, and you can resume it later using `/punish `. - **Interactive Staff GUIs**: Open `/punish ` to pick reasons, categories (Chat, Ban, VoiceChat), and durations directly from a menu without typing long commands. - **LuckPerms VoiceChat Mutes**: Hooks into LuckPerms temporary permissions to mute players in Simple Voice Chat smoothly. - **Warning Thresholds**: Set how many warnings a player can get for specific reasons before the plugin automatically escalates it to a mute or ban. - **In-Game Appeals (`/appeal` & `/appeals`)**: Punished players can submit an appeal with their punishment ID. Staff can open the appeals GUI to review, approve, or deny them on the spot. - **Alt Account Detector (`/alts `)**: Automatically links accounts joining from the same IP address and shows their current punishment status. - **Custom GUI Sounds & Colors**: Includes clean sound effects on menu clicks and full hex color support across all messages. --- ## Commands and Permissions | Command | Usage | Description | Permission | |---|---|---|---| | `/punish` | `/punish [type] [reason]` | Issue a punishment or open GUI | `easypunish.punish.chat / ban / voicechat` | | `/unpunish` | `/unpunish [type]` | Remove a punishment or pause ID | `easypunish.unpunish.chat / ban` | | `/warn` | `/warn ` | Issue a warning | `easypunish.warn.chat / ban / voicechat` | | `/unwarn` | `/unwarn ` | Remove a warning | `easypunish.warn.chat / ban / voicechat` | | `/kick` | `/kick [reason]` | Kick a player | `easypunish.kick` | | `/banlist` | `/banlist [player]` | Open active bans menu | `easypunish.banlist` | | `/mutelist` | `/mutelist [player]` | Open active mutes menu | `easypunish.mutelist` | | `/warnlist` | `/warnlist [player]` | Open active warnings menu | `easypunish.warnlist` | | `/voicelist` | `/voicelist [player]` | Open active voice-mutes menu | `easypunish.voicelist` | | `/history` | `/history ` | View a player's punishment history | `easypunish.history` | | `/check` | `/check ` | Check active punishments in chat | `easypunish.admin` | | `/alts` | `/alts ` | Check alt accounts linked to IP | `easypunish.alts` | | `/appeal` | `/appeal ` | Submit a punishment appeal | `easypunish.appeal` | | `/appeals` | `/appeals [id] [type]` | Open staff appeals menu | `easypunish.appeallist` | --- ## Configuration Files - `config.yml` - Plugin messages and formatting. - `permissions.yml` - Custom LuckPerms permission nodes. - `punishments.yml` - Durations, punishment reasons, and warning thresholds. - `gui.yml` - Menu titles, item layouts, and sounds. - `data.yml` - Active punishments. - `history.yml` - Punishment history logs. - `appeals.yml` - Appeals database. - `alts.yml` - Linked player IPs.

EasyPunish

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details