mAdmin

<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

* Clean & Optimized: View all online players sorted alphabetically. The list supports unlimited players, thanks to the automatic pagination system. * Clean & Optimized: Click on any player's head to open the Sanction Menu containing actions: * 💛 Clean & Optimized * 🧡 Clean & Optimized * ❤️ Clean & Optimized * 🩶 Clean & Optimized * Clean & Optimized: When selecting a timed punishment (Tempban/Tempmute), mAdmin will safely cancel the admin's chat and ask them to type the Clean & Optimized and the Clean & Optimized. For direct actions (Ban/Kick), it will only ask for the reason. * Clean & Optimized: A final double-check GUI appears before the command is sent, preventing accidental punishments. * Clean & Optimized: Built-in protections prevent administrators from accidentally punishing themselves. * Clean & Optimized: Everything from prefix, error messages, GUI titles, and item names can be edited in the `config.yml` * Clean & Optimized: Fully supports classic Minecraft color codes (`&c`, `&l`, etc.) as well as Modern Clean & Optimized (`&#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[&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ᴛ ᴘᴀɢᴇ"