LitePunishUI is a clean, lightweight punishment UI that integrates with LiteBans.
Run a single command and punish faster with a professional, configurable GUI.
Requirements

• LiteBans (required)
• Paper/Spigot 1.20+ (works on 1.21)

/punish command
Usage: /punish <player>

• Opens the main GUI: Ban, Kick, Mute, Warn
• Includes Unban / Unmute / Unwarn
• Shows the 3 most recent punishments for the target player
• “Full history” button opens LiteBans history
• Silent toggle included (red = silent ON, green = silent OFF)

/punishmode command
Usage: /punishmode

• Toggles shift-click mode
• While enabled: sneak + left/right click a player to open their Punish GUI
• Actionbar indicator while active
• Audible chime when toggled

/litepunishui command
Usage: /litepunishui <reload|status>

• reload Reloads config and clears runtime caches
• status Shows LiteBans connection status with a color legend

Permissions

• litepunishui.use - Open and use /punish
• litepunishui.ban - Use ban actions in the GUI
• litepunishui.kick - Use kick actions in the GUI
• litepunishui.mute - Use mute actions in the GUI
• litepunishui.warn - Use warn actions in the GUI
• litepunishui.unpunish - Use unban / unmute / unwarn buttons
• litepunishui.history - Use “Full history” button
• litepunishui.silent - Toggle silent punishments
• litepunishui.other - Use custom “Other” reason (chat input)
• litepunishui.mode - Use /punishmode + shift-click open
• litepunishui.status - Use /litepunishui status
• litepunishui.reload - Use /litepunishui reload
• litepunishui.admin - Full access to everything above

Sounds

• GUI chime when opening menus
• Chime on /punishmode toggle
• Optional punishment chime played to the punished player (if online)

Config paths

• config.yml (primary)
• config.json (optional overrides)

Configuration
Everything can be customized in the UI through config.yml.
You can also optionally create config.json to override values (useful for panel deployments).
Important settings

• litebans.history-cache-seconds - Recent history cache (prevents DB spam)
• sounds.chime - GUI/menu chime
• sounds.punishment-chime - Chime for punished players

Status legend
&cRed = Error
&6Loading/unsure
&aGood = Connected

Notes

• This plugin does not add its own punishment messages; LiteBans handles output.
• If LiteBans is not installed, the GUI will not function.
• Recent punishments use caching to avoid LiteBans database pool exhaustion.
• Tested on litebans version 2.19.0