---

🌟 Overview

mAdmin is an intuitive GUI-based moderation panel for Minecraft servers (1.21.1+). Built natively for Paper, it brings an easy-to-use menu directly to your administrators, letting them apply punishments without constantly rewriting long, complicated commands.

Need to drop a quick ban, a timed mute, or just a simple kick? mAdmin handles all of this seamlessly through interactive Inventory Menus and an intelligent chat capturing system.

It acts as a front-end wrapper for your existing moderation plugins (like LiteBans, AdvancedBan, or Vanilla), simply dispatching standard punishment commands (/ban, /tempban, etc.) from the server console.

✨ Features

• Live Online Players GUI: View all online players sorted alphabetically. The list supports unlimited players, thanks to the automatic pagination system.
• Smart Player Actions: Click on any player's head to open the Sanction Menu containing actions:
  • 💛 Tempban
  • 🧡 Tempmute
  • ❤️ Ban
  • 🩶 Kick
• Chat Input Capture: When selecting a timed punishment (Tempban/Tempmute), mAdmin will safely cancel the admin's chat and ask them to type the Duration and the Reason. For direct actions (Ban/Kick), it will only ask for the reason.
• Confirmation Screen: A final double-check GUI appears before the command is sent, preventing accidental punishments.
• Admin Safety: Built-in protections prevent administrators from accidentally punishing themselves.
• 100% Customizable: Everything from prefix, error messages, GUI titles, and item names can be edited in the config.yml
• Full Color Support: Fully supports classic Minecraft color codes (&c, &l, etc.) as well as Modern HEX Colors (&#RRGGBB).
• Clean & Optimized: Incredibly lightweight (compiled for Java 21+ and Paper 1.21.11), zero TPS impact.

📥 Installation

1. Download the mAdmin.jar file and place it into your server's plugins folder.
2. Make sure you have a compatible moderation plugin installed to handle punishments (like LiteBans, AdvancedBan) or simply rely on the Vanilla system.
3. Restart your server.
4. Customize permissions, messages, and colors in the generated config.yml file.

⚙️ Configuration

The configuration file generates automatically on your first boot and is fully straightforward:

Click to view default config.yml

prefix: "&8[&cmAdmin&8]&r "

messages:
  no-permission: "&cYou don't have permission to perform this command."
  only-players: "&cThis command is for players only."
  player-offline: "&cPlayer is no longer online."
  enter-time: "&bType the TIME in chat (e.g. 1h, 1d):"
  enter-reason: "&bType the REASON in chat:"
  time-set: "&bTime set to: %time%. Now type the reason."
  reason-set: "&bReason set: %reason%"
  action-cancelled: "&cAction cancelled."
  sanction-success: "&aSanction executed successfully."
  sanction-failed: "&cUnable to execute sanction. Moderation plugin not found."
  cannot-punish-self: "&cYou cannot punish yourself."

gui:
  main-title: "&4Admin Panel - Players"
  actions-title: "&cActions - "
  confirm-title: "&4Confirm: "
  items:
    tempban: "&eᴛᴇᴍᴘʙᴀɴ"
    tempmute: "&6ᴛᴇᴍᴘᴍᴜᴛᴇ"
    ban: "&cʙᴀɴ"
    kick: "&7ᴋɪᴄᴋ"
    confirm: "&aᴄᴏɴғɪʀᴍ"
    cancel: "&cᴄᴀɴᴄᴇʟ"
    previous-page: "&eᴘʀᴇᴠɪᴏᴜs ᴘᴀɢᴇ"
    next-page: "&eɴᴇxᴛ ᴘᴀɢᴇ"