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

📸 In-Game Staff Control Center

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           54-SLOT MODERATION MATRIX                             │
├──────────────────┬──────────────────┬──────────────────┬────────────────────────┤
│ 📖 Slot 4: History│ 🟥 Slot 11: Ban   │ 🟪 Slot 13: Kick │ 🟧 Slot 15: Mute       │
│ 🧊 Slot 20: Freeze│ 🟦 Slot 22: Warn  │ ✍️ Slot 24: Chat │ 🟩 Slot 29: Unban      │
│ 🩵 Slot 31: Warned│ 🟨 Slot 33: Unmute│ 📦 Slot 38: InvSee│ 📑 Slot 40: Reports    │
│ 📝 Slot 42: Notes │ 🚨 Slot 47: Maint │ 👁️ Slot 49: Vanish│ 🏷️ Slot 51: Tickets    │
└──────────────────┴──────────────────┴──────────────────┴────────────────────────┘

🌟 What Makes ModerationGUI 3.0 Special?

Traditional server moderation is fragmented across multiple slow plugins. ModerationGUI 3.0 consolidates every administrative workflow into an ultra-fast, zero-lag ecosystem.

💎 Core Architectural Highlights:

• ⚡ Zero Main-Thread Lag: Asynchronous audit logging, file saving, and cache indexing keep tick rates at a steady 20.0 TPS.
• 🔒 Visual RBAC Security: If a staff member lacks permission for any button, it dynamically renders as a locked Barrier icon.
• 💬 Interactive Chat Input: No clunky anvil inputs; durations and reasons are typed directly in chat with automatic timeout protection.
• 🌐 True Ghost Vanish: Complete silence, vanished player list status, hidden join/leave messages, and silent container opening.

✨ Feature Breakdown

⚡ 1. Reason-Based Auto-Duration Punishments

Never remember ban durations again. Simply type the player and the cheat name:

• Example: /mod ban Steve killaura
  • Instantly resolves killaura (or aliases aura, ka, forcefield).
  • Automatically applies the configured duration: 14 Days.
  • Formats display reason: KillAura / Unfair Combat.
• Append Custom Notes: /mod ban Steve killaura with fast hits -> applies 14d ban with formatted reason and suffix notes.
• Manual Override: /mod ban Steve 3d killaura -> manual duration overrides preset duration while keeping clean reason styling.
• Preset Mutes: /mod mute Steve spam (30m), /mod mute Steve toxicity (2h), /mod mute Steve advertising (7d).

🪤 2. Researched 25+ Hack Categories

Preset configurations researched from premier anticheats (Vulcan, GrimAC, Matrix, Polar):

• Combat: killaura (14d), reach (14d), hitbox (14d), velocity (14d), autoclicker (7d), criticals (7d).
• Movement: fly (14d), speed (14d), jesus (7d), nofall (7d), timer (14d), step (7d).
• World & Exploits: xray (30d), lagmachine (30d), scaffold (14d), nuker (14d), fastbreak (7d), baritone (14d), dupe (permanent).
• Chat Violations: spam (30m), toxicity (2h), advertising (7d), hate (14d).

🎯 3. In-Game Cheat & Lag Testing Suite

• 🪤 /test aura <player>: Spawns an invisible bait entity behind the suspect to detect automated rotation locks and KillAura hacks.
• 🛡️ /test totem <player>: Audits offhand totem equip frequency in milliseconds to detect automated AutoTotem swap macros.
• 🚨 /test lag / /test lagmachine: Real-time redstone clock monitor. Audits TPS, counts redstone ticks and piston loops per chunk, and flags entity clumping clusters.

🧊 4. Freeze & Screenshare (SS) System

• Total Suspect Lockdown (/freeze <player> / /ss <player>):
  • Applies blindness and locks player location, jumps, attacks, and block interactions.
  • Broadcasts persistent screen titles and chat instructions.
  • Combat Logout Guard: If a frozen suspect disconnects, they are automatically banned for 14 days for screenshare evasion.

📦 5. Live Inventory & Ender Chest Inspector

• /invsee <player>: Live-view target armor, offhand item, and full inventory contents in real time.
• /enderchest <player> / /ec <player>: Open and view any online player's Ender Chest on demand.

💬 6. Complete Chat Management & Staff Channel

• /chat clear: Instantly wipe chat history to clear slurs or advertisement links.
• /chat mute: Silence global chat during server events or announcements.
• /chat slow <seconds>: Enforce cooldowns between player messages.
• /staffchat <message> / /sc: Dedicated private staff channel with persistent chat toggle.

🚨 7. Server Maintenance Mode

• /maintenance [on|off|toggle|status] / /maint:
  • Locks server access exclusively to operators and staff with moderation.maintenance.bypass.
  • Non-staff players receive a custom kick screen and title explaining the ongoing maintenance.

👥 8. Alt Account Tracker & Staff Notes

• /alts <player>: Tracks IP addresses across joins and alerts staff if a connecting player shares an IP with banned accounts.
• /notes <player> add|remove|list: Permanent private notebook attached to each player profile for staff communication.

🎮 Master Command Reference

Supported Duration Formats: 30s 15m 2h 1d 7d 14d 30d permanent

🔑 Permissions & LuckPerms Matrix

📋 Ready-to-Paste LuckPerms Setup

# 1. Moderator Role Setup
/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.freeze true
/lp group mod permission set moderation.invsee true
/lp group mod permission set moderation.enderchest true
/lp group mod permission set moderation.notes true
/lp group mod permission set moderation.staffchat true

# 2. Administrator Role Setup
/lp group admin permission set moderation.* true

💡 Smart Dynamic Locking: Players with any permission (e.g. moderation.kick) can open /mod. Any actions they lack permissions for will be visually locked with a Barrier item.

📝 Configuration Preview (config.yml)

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

# Punishment presets
presets:
  default-ban-duration: "30d"
  default-mute-duration: "1d"
  killaura:
    duration: "14d"
    reason: "KillAura / Unfair Combat"
    aliases:
      - "aura"
      - "ka"
      - "forcefield"
  fly:
    duration: "14d"
    reason: "Flight / Movement Cheat"
    aliases:
      - "flight"
  xray:
    duration: "30d"
    reason: "X-Ray / Illegal Mining"
  spam:
    type: "mute"
    duration: "30m"
    reason: "Spam / Chat Flood"

# Lag machine detector
lag-detector:
  enabled: true
  redstone-threshold: 250
  piston-threshold: 60
  entity-threshold: 80
  alert-cooldown-seconds: 10

# Maintenance mode
maintenance:
  enabled: false
  kick-message: "&cServer is currently under maintenance!\n&ePlease check back later."

⚙️ Requirements & Installation

Installation Steps:

1. Download ModerationGUI-3.0.jar.
2. Drop the jar file into your server's plugins/ folder.
3. Restart your server (never use /reload).
4. Configure roles and permissions with LuckPerms.
5. Type /mod in-game and enjoy effortless server management!