EasyPunish

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 <ID>.
• Interactive Staff GUIs: Open /punish <player> 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 <player>): 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 <player|id> [type] [reason]	Issue a punishment or open GUI	easypunish.punish.chat / ban / voicechat
/unpunish	/unpunish <player|id> [type]	Remove a punishment or pause ID	easypunish.unpunish.chat / ban
/warn	/warn <player> <type> <reason>	Issue a warning	easypunish.warn.chat / ban / voicechat
/unwarn	/unwarn <player> <type> <reason>	Remove a warning	easypunish.warn.chat / ban / voicechat
/kick	/kick <player> [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 <player>	View a player's punishment history	easypunish.history
/check	/check <player>	Check active punishments in chat	easypunish.admin
/alts	/alts <player>	Check alt accounts linked to IP	easypunish.alts
/appeal	/appeal <id> <reason>	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.