Moderation & Punishments Framework
NookureStaff+ provides a full-featured moderation engine supporting temporary and permanent bans, IP sanctions, mutes, warnings, and kicks.
Sanction Commands & Syntax
Section titled “Sanction Commands & Syntax”| Sanction Type | Command Syntax | Description |
|---|---|---|
| Permanent Ban | /ban <player> [reason] [-s] |
Bans player account indefinitely. |
| Temporary Ban | /tempban <player> <duration> [reason] [-s] |
Bans player account for a specific duration (e.g., 7d, 12h). |
| IP Ban | /ipban <player|ip> [duration] [reason] [-s] |
Bans the target’s IP address. If target is online, bans their active IP. |
| Unban | /unban <player|ip> [reason] |
Pardons active ban or IP-ban. |
| Mute | /mute <player> [reason] [-s] |
Prevents player from sending chat messages. |
| Temporary Mute | /tempmute <player> <duration> [reason] [-s] |
Mutes player for specified duration. |
| IP Mute | /ipmute <player|ip> [duration] [reason] [-s] |
Mutes all accounts connecting from the target IP. |
| Unmute | /unmute <player|ip> [reason] |
Pardons active mute. |
| Kick | /kick <player> [reason] [-s] |
Disconnects player from the server or proxy. |
| History | /history <player> [page] |
Opens paginated sanction audit log for the player. |
| Punish GUI | /punish [player] [type] |
Opens the interactive punishment selector and confirmation GUI (alias: /sanction). |
Interactive Punish GUI (/punish)
Section titled “Interactive Punish GUI (/punish)”Staff can issue sanctions visually without memorizing durations or template keys:
/punish [player] [type]Alias: /sanction (requires nookure.staff plus the permission for the selected sanction type).
- Player Selector: Running
/punishwith no arguments opens a player selector GUI. - Type & Template Selector: Selecting a player (or running
/punish <player>) opens the sanction type menu (ban,tempban,ipban,mute,tempmute,ipmute,warn,kick) followed by configured templates with custommaterialicons. - Confirmation Dialog: Before applying a template sanction, a confirmation GUI displays the target, reason, and duration to prevent accidental punishments.
Shortcodes & Templates
Section titled “Shortcodes & Templates”Instead of typing long reasons and durations manually, staff members can use configured shortcodes defined in plugins/NookureStaff/punishment/config.yml.
Example Usages:
Section titled “Example Usages:”# Applies predefined cheating reason and default duration/ban Notch cheating
# Applies template #1/ban Notch 1
# Overrides template duration while keeping the template reason/ban Notch 14d cheatingTemplate Configuration:
Section titled “Template Configuration:”templates: ban: cheating: id: 1 duration: "30d" reason: "Unfair Advantage / Cheating" toxic: id: 2 duration: "7d" reason: "Harassment and Toxicity"Silent Punishments (-s)
Section titled “Silent Punishments (-s)”Appending -s, --silent, or -silent to any punishment command suppresses public broadcasts.
- Regular players will not see a broadcast.
- Only staff members with
nookure.staff.punishments.see.silentwill receive the punishment notification.
/ban Spammer -s Advertising another serverLogin & Chat Interceptors
Section titled “Login & Chat Interceptors”- Ban Screen: When a banned player attempts to connect, NookureStaff intercepts the connection and presents a customizable MiniMessage screen displaying:
- Sanction ID
- Reason
- Punishing staff member
- Expiration timestamp
- Appeal website URL
- Mute Interceptor: When a muted player types in chat, their message is blocked and an actionbar/chat notice informs them of their remaining mute duration.