UDPunishments

Custom punishment plugin for Spigot, Paper, Purpur, and Folia-style servers.

Install

Put target/UDPunishments-1.0.0.jar into your server plugins folder.
Restart the server.
Edit plugins/UDPunishments/config.yml to change broadcasts, presets, warning title text, and punishment messages.
Run /punishreload after config changes.

Commands

/punishban <player> <duration|perm> <preset|reason...>
/punishipban <player|ip> <duration|perm> <preset|reason...>
/punishkick <player> <preset|reason...>
/punishmute <player> <duration|perm> <preset|reason...>
/punishunmute <player>
/punishwarn <player> <preset|reason...>
/punishhistory <player>
/punishreload

Aliases are also included, such as /pban, /pipban, /pkick, /pmute, /pwarn, and /phistory.

Durations

Use perm, permanent, or forever for permanent punishments.

Timed examples:

30m
2h
7d
1d12h30m

Presets

Presets live in config.yml under presets.

Example:

presets:
  cheating:
    reason: "Unfair advantage"
    broadcast: "&8[&cAnti-Cheat&8] &f{player} &7was removed by &f{staff}&7 for &c{reason}&7."
    target-message:
      - "&cYou are banned from this server."
      - "&7Reason: &f{reason}"
      - "&7Staff: &f{staff}"
      - "&7Expires: &f{expires}"

If a preset name is used as the reason argument, the plugin uses that preset. Extra words after the preset override the preset reason.

Example:

/punishban Steve 7d cheating X-Ray mining

Logs

All punishments are recorded in:

plugins/UDPunishments/Log auf Punishments/punishments.yml

Mute records are also stored there so they survive restarts.

Permissions

udpunishments.admin
udpunishments.ban
udpunishments.ipban
udpunishments.kick
udpunishments.mute
udpunishments.warn
udpunishments.history
udpunishments.reload

Compatibility

The plugin is compiled with Java 8 bytecode so it can run on Java 21 servers while staying compatible with many older Bukkit-family versions. It avoids Paper-only APIs and declares folia-supported: true; it does not use schedulers or async entity access.

Very old servers running outdated Java or heavily modified ban APIs may still need version-specific testing.