🛡️ 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

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

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

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

🎮 Commands

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

🔑 Permissions

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

💬 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