ModerationGUI

🛡️ 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, 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 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 through the GUI
• 📋 Paginated Player Lists — Browse online 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 and lore are customizable via config.yml
• 🧹 Auto Cleanup — Expired punishments are automatically removed on startup

📸 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: 30m 2h 12h 1d 7d 30d permanent

🔑 Permissions

LuckPerms Example

# Give a staff member only kick and mute permissions
/lp group mod permission set moderation.kick true
/lp group mod permission set moderation.mute true

# Give full moderation access
/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 Moderation.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! Discord Medrax01

📝 Config Preview

# Moderation Plugin - Settings
prefix: "&c&lModeration &8» &7"

menu:
  main-title: "&c&lModeration Menu"
  kick-name: "&5&lKick"
  ban-name: "&c&lBan"
  mute-name: "&6&lMute"
  warn-name: "&1&lWarn"
  # ... and much more!

messages:
  ban-success: "&a{player} &7has been banned! &eDuration: &f{duration}"
  kick-success: "&a{player} &7has been kicked successfully!"
  # All messages are fully customizable!

Made ❤️ by MDR Studios