mAdmin
An admin plugin with a configurable GUI-based moderation panel for your server! It simplifies bans, kicks, and mutes with a fast, zero-impact GUI and smart chat capture, completely replacing complicated commands.
71
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
mAdmin
mAdmin
A lightweight, powerful, and fully customizable moderation GUI for your Minecraft server.
---
🌟 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:
Click to view default config.yml
```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ᴛ ᴘᴀɢᴇ"
