<div align="center"> <h1>mAdmin</h1> <p>A lightweight, powerful, and fully customizable moderation GUI for your Minecraft server.</p> </div> --- ## 🌟 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: <details> <summary>Click to view default config.yml</summary> ```yaml prefix: "&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ᴛ ᴘᴀɢᴇ"