🛡️ ModerationGUI — The All-in-One Staff Management Plugin

A powerful, GUI-based moderation plugin built for Paper/Purpur servers. Manage your players effortlessly with a clean interactive menu, ghost stealth vanish, live report tickets, private staff chat, full LuckPerms support, and a complete punishment system.

---

✨ Features

• 🖥️ Interactive GUI Menu — A beautiful in-game inventory UI to manage all moderation actions with a single command
• 🔨 Ban — Permanently or temporarily ban players (online & offline) with custom durations and reasons
• 🔇 Mute — Silence players for a specified duration; muted players cannot chat
• 👢 Kick — Instantly remove a player from the server with a reason
• ⚠️ Warn — Issue warnings to players with full tracking
• ✅ Unban / Unmute / Unwarn — Easily reverse any punishment directly through the GUI
• 🫥 True Silent Vanish — Total stealth mode; hidden from tab list, mob target, item pickup, collisions, with self-ghost translucency and custom fake quit/join messages
• 📖 In-Game Report Panel (/mod reports) — 54-slot visual ticket system: Left-click to TP, Right-click to clear, Shift-click to vanish & spectate
• 💬 Private Staff Chat (/sc) — Toggleable staff chat channel or quick direct messages for team communication
• 📢 Punishment Broadcasts — Public chat announcements when punishments are issued or pardoned
• 📜 Async Chat & Command Logger — Zero lag; logs all chat messages and command executions to logs/chat_and_commands.log
• 🔎 Anvil Player Search — Search and filter online & offline players by name in the GUI
• 🌐 Discord Appeal Screen — Custom disconnect screen with direct Discord appeal links
• 📋 Paginated Player Lists — Browse online, offline, or punished players across multiple pages
• 🔒 LuckPerms Compatible — Full per-action permission support; grant only what each staff member needs
• 💬 Chat Input System — Duration and reason inputs are taken directly in chat for a smooth experience
• 📦 Fully Configurable — All messages, menu titles, item names, lore, and broadcasts are customizable via config.yml
• 🧹 Auto Cleanup — Expired punishments and old reports (48h) are automatically cleaned up

---

📸 Screenshots

Main Menu — Open with /mod or /moderation

!Moderation Menu

Command Suggestion — Start typing /mod and the command appears automatically

!Command Suggestion

Tab Completion — Press Tab after /mod to see all available actions

!Tab Completion

Chat Input Flow — Type the duration and reason directly in chat, then done!

!Chat Input

---

🎮 Commands

Command	Aliases	Description
/mod or /moderation	—	Open the moderation GUI menu
/mod ban <player> <duration> <reason>	—	Ban an online or offline player
/mod unban <player>	—	Unban a player
/mod mute <player> <duration> <reason>	—	Mute a player from chatting
/mod unmute <player>	—	Unmute a player
/mod kick <player> <reason>	—	Kick an active player
/mod warn <player> <reason>	—	Warn a player
/mod unwarn <player>	—	Remove a player's warning
/mod reports	—	Open the visual Report Panel
/vanish	/v	Toggle True Silent Vanish mode
/staffchat [message]	/sc	Toggle staff chat or send a staff message
/report <player> <reason>	—	Report a rule breaker

Duration Format Examples: 30s 15m 2h 12h 1d 7d 30d permanent

---

🔑 Permissions

Permission Node	Description	Default
moderation.use	Open the moderation menu	OP
moderation.ban	Permission to ban players	OP
moderation.unban	Permission to unban players	OP
moderation.mute	Permission to mute players	OP
moderation.unmute	Permission to unmute players	OP
moderation.kick	Permission to kick players	OP
moderation.warn	Permission to warn players	OP
moderation.unwarn	Permission to remove warnings	OP
moderation.vanish	Permission to use vanish mode	OP
moderation.seereports	Permission to view /mod reports menu	OP
moderation.reports.notify	Receive live in-chat alerts when someone is reported	OP
moderation.staffchat	Permission to use staff chat	OP
moderation.*	Grants all moderation permissions	OP

LuckPerms Example

# Give a staff member moderation, reports, vanish, and staffchat permissions
/lp group mod permission set moderation.use true
/lp group mod permission set moderation.kick true
/lp group mod permission set moderation.mute true
/lp group mod permission set moderation.unmute true
/lp group mod permission set moderation.warn true
/lp group mod permission set moderation.vanish true
/lp group mod permission set moderation.seereports true
/lp group mod permission set moderation.reports.notify true
/lp group mod permission set moderation.staffchat true

# Give full moderation access to administrators
/lp group admin permission set moderation.* true

💡 Players with any permission (e.g. moderation.kick) automatically gain access to open the /mod menu. Buttons they don't have permission for will appear locked with a barrier icon.

---

⚙️ Installation

1. Download the latest ModerationGUI-2.0.jar
2. Drop it into your server's plugins folder
3. Restart your server (do not use /reload)
4. Configure permissions using LuckPerms or your preferred permission plugin
5. Type /mod in-game to open the menu!

---

📋 Requirements

Requirement	Version
Server Software	Paper or Purpur
Minecraft Version	1.21.x (1.21 to 1.21.11)
Java	21+
Permission Plugin	LuckPerms (recommended)

---

💬 Support & Community

Have a bug to report or a feature to suggest? Add me on Discord! Medrax01

---

📝 Config Preview

# ============================================================
# ModerationGUI 2.0 - Main Configuration File
# ============================================================

prefix: "&c&lModeration &8» &7"

# Public punishment announcements
broadcast:
  enabled: true
  ban: "&c&l[BAN] &f{player} &7has been banned by &f{admin}&7. &eReason: &f{reason} &7| &eDuration: &f{duration}"
  mute: "&6&l[MUTE] &f{player} &7has been muted by &f{admin}&7. &eReason: &f{reason} &7| &eDuration: &f{duration}"

# Vanish settings
vanish:
  fake-quit: "&e{player} left the game" # Leave as "" for total silence
  fake-join: "&e{player} joined the game"
  enabled-message: "&7You are now &cinvisible&7."
  disabled-message: "&7You are now &avisible&7."

# Report ticket system
reports:
  auto-cleanup-hours: 48
  staff-notify: "&8[&c&lREPORT&8] &f{reporter} &7reported &f{reported}&7: &e{reason}"

# Private staff chat channel
staffchat:
  format: "&8[&b&lSTAFF&8] &f{player}&8: &7{message}"

messages:
  discord-link: "https://discord.gg/YOUR_INVITE_HERE"
  ban-screen: "&c&lYou have been banned!\n\n&fReason: &e{reason}\n&fDuration: &e{duration}\n&fExpires: &e{expires}\n\n&7Banned by: &f{admin}\n\n&eYou can appeal this ban on Discord:\n&b{discord}"

---

Made ❤️ by MDR Studios