Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for ResourcePackAI

Warn, mute, kick and ban from a real Minecraft menu, with reasons, lengths and history.

Report DE-Punishments?

The punishment panel in Minecraft, picking a reason

Spigot or Paper 1.21.7 and newer · The panel needs Dialog Engine (free) and 1.21.6+ players

Docs · Discord · Dialog Engine

What is it?

A punishment plugin whose staff tools are a real Minecraft menu. /punish Steve opens a screen with Steve's head, whether he is online, what he is serving now and how many warnings count against him. Pick a reason and a length, flip Silent, and press Warn, Mute, Kick, Temp-ban or Ban. Bans ask first, and take typed details.

Every button runs an ordinary command as the staff member who pressed it, so the commands are never second best: they work from console, from other plugins, for players on older clients, and without Dialog Engine installed at all.

The panel

  • ✔ Reasons with lengths: pick "Hacking" and a mute or temp-ban gets the length you set for hacking, unless you choose another.
  • ✔ Remembers your picks: each staff member's reason, length and Silent stay where they left them.
  • ✔ Unmute and Unban appear only when they apply.
  • ✔ Ban confirmation, with a box for details and Back to the panel.
  • ✔ History, with a Revoke button on each entry.
  • ✔ A player picker: /punish on its own lists who is online, and takes a typed name for anybody offline.
  • ✔ A warning popup the warned player has to acknowledge, on the spot or the next time they join.
  • ✔ Every button checks permissions when pressed: a helper without ban permission cannot ban from the panel.

Punishments

  • ✔ Warn, mute, kick, temp-ban and ban, online or offline (except kick).
  • ✔ IP bans with -ip, and silent punishments with -s that only staff hear about.
  • ✔ Escalation: three warnings and a one hour mute, five and a day's ban, or whatever you write.
  • ✔ Caps per rank: helpers may mute for a day and temp-ban for three, moderators more, only some may ban for good.
  • ✔ Mutes cover chat, private messages and signs, with the list of blocked commands yours to edit.
  • ✔ Ban screens that say why, who, until when, and the ban number to appeal with.

Commands

Command What it does Permission
/punish [player] The panel punishments.punish
/warn <player> [-s] [reason] Warn punishments.warn
/unwarn <player> Remove the newest warning punishments.unwarn
/mute <player> [length] [-s] [reason] Mute punishments.mute
/unmute <player> Unmute punishments.unmute
/kick <player> [-s] [reason] Kick punishments.kick
/tempban <player> <length> [-s] [-ip] [reason] Temp-ban punishments.tempban
/ban <player> [length] [-s] [-ip] [reason] Ban punishments.ban
/unban <player> Unban punishments.unban
/history <player> Their record punishments.history
/punishments reload, /punishments revoke <id> Reload, lift one by number punishments.admin, punishments.revoke

Lengths: 30m, 2h, 7d, 2w, 1mo, 1y, or perm. A reason starting with # is a preset: /tempban Steve #hacking flying at spawn. punishments.staff gives the lot; punishments.exempt cannot be punished.

Make it yours

  • Every command's name and aliases, and whether it exists at all.
  • Every word, in MiniMessage, including the kick and ban screens and everything written on the panels.
  • The screens themselves: /de edit punishments:panel opens the panel in Dialog Engine's browser editor. Your edits are kept when Punishments updates.
  • Reasons, lengths, caps, escalation, who hears what.
  • SQLite out of the box, MySQL or MariaDB to share one record across a network.

Installing

  1. Install Dialog Engine (free) for the panel. Punishments installs its screens into it on first start.
  2. Drop Punishments.jar into plugins/ and start the server.
  3. Edit plugins/Punishments/config.yml and messages.yml, then /punishments reload.

What it connects to

  • SpigotMC, to see whether a newer version is out. update-check: false in config.yml turns it off.
  • Nothing else. The panel's resource pack is served by Dialog Engine, from your own server.

For developers

PunishmentPreEvent (cancellable, and the reason can be changed), PunishmentEvent and PunishmentRevokeEvent.

Support

Ask on Discord. Please don't post bugs in the reviews; we can't reply there, and we would rather fix it.

Made by ResourcePack AI

Punishments is built on Dialog Engine's public API, the same one any plugin can use. Both come from resourcepack.ai, a web editor for resource packs.

Information

Category
Admin Tools
Published
October 12, 2026
License
Unspecified
0Downloads
0Stars
Addon

Pinned Versions

Members

1