AdmPunish | Customizable Punishment GUI [1.21+]

Description


AdmPunish is a lightweight, efficient, and highly customizable punishment GUI plugin designed for modern Spigot/Paper 1.21+ servers. It completely eliminates the need for messy, over-complicated configuration files. Instead of forcing you to configure materials, custom lore, and inventory slots for every single rule, AdmPunish dynamically builds the entire user interface directly from your list of rules and punishment commands.

Whether you run an anarchy, grief, or classic survival server, this plugin allows your staff team to issue mutes, bans, and IP-bans strictly according to your official rulebook in just two clicks.


✨ Features:

• Dynamic Grid Layout: Automatically calculates the optimal inventory size (9 to 54 slots) based on how many rules you add.
• Hierarchical Rule Support: Smart parsing perfectly handles rule numbers containing dots (like 2.1 or 4.3.1).
• Staff Security Guard: Built-in security automatically restricts lower-tier moderators from executing ban commands, even if those commands are placed inside the mute menu.
• Pure Performance: Zero bloatware, ultra-lightweight codebase, and lag-free inventory handling.

• /punish <player> — Opens the primary punishment selection interface for the target player.
• /punish reload — Reloads the configuration file instantly without restarting the server.

• punish.admin or punish.* — Full administrative access. Required to reload the plugin, open the Ban Menu, and execute any ban/ipban commands.
• Standard Staff (No Admin Permission) — Grants access to /punish <player> to open the main menu and use the Mute Menu. If a moderator without this permission clicks a ban-related item, the action is blocked.