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:
Documentation
️ Commands & Permissions
Commands:
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.
Documentation
️ Commands & Permissions
Commands:
- /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.
Spoiler: Click to view config.yml
messages:
no-permission : "&c▶ &fУ вас &cнет прав &fдля использования этой команды!"
only-players : "&c▶ &fЭту команду могут использовать только игроки!"
player-not-found : "&c▶ &fИгрок %target% &cне найден &fна сервере!"
reload : "&a▶ &fКонфигурация плагина &aуспешно &fперезагружена!"
usage : "&c▶ &fИспользуйте: /punish [reload/игрок]"
gui:
title : "&fНаказание: &7%target%"
mute-item-name : "&aМут"
ban-item-name : "&cБан"
mutes:
title : "&fМут игрока: &7%target%"
items:
"2.1" : "mute %target% 1h 2.1"
"2.2" : "mute %target% 2h 2.2"
"2.3" : "mute %target% 15m 2.3"
"2.4" : "ban %target% 1d 2.4"
bans:
title : "&fБан игрока: &7%target%"
items:
"4.1" : "ban %target% 3d 4.1"
"4.2" : "ban %target% 7d 4.2"
"4.3.1" : "ipban %target% 30d 4.3.1"
Code (YAML):
messages:
no-permission : "&c▶ &fУ вас &cнет прав &fдля использования этой команды!"
only-players : "&c▶ &fЭту команду могут использовать только игроки!"
player-not-found : "&c▶ &fИгрок %target% &cне найден &fна сервере!"
reload : "&a▶ &fКонфигурация плагина &aуспешно &fперезагружена!"
usage : "&c▶ &fИспользуйте: /punish [reload/игрок]"
gui:
title : "&fНаказание: &7%target%"
mute-item-name : "&aМут"
ban-item-name : "&cБан"
mutes:
title : "&fМут игрока: &7%target%"
items:
"2.1" : "mute %target% 1h 2.1"
"2.2" : "mute %target% 2h 2.2"
"2.3" : "mute %target% 15m 2.3"
"2.4" : "ban %target% 1d 2.4"
bans:
title : "&fБан игрока: &7%target%"
items:
"4.1" : "ban %target% 3d 4.1"
"4.2" : "ban %target% 7d 4.2"
"4.3.1" : "ipban %target% 30d 4.3.1"
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
AdmPunish | Customizable Punishment GUI [1.21+] is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 16 times (via Spigot). Download it and open it directly in the game.