Skip to content

Warnings & Auto-Escalation

NookureStaff+ features an advanced warning system equipped with automated escalation ladders, warning decay, and smart sanction rollbacks when warnings are revoked.


Staff issue warnings using:

Terminal window
/warn <player> [category] [reason] [-s]

To revoke a warning:

Terminal window
/unwarn <player|warningId> [reason]

Warnings are categorized (e.g. flood, spam, toxicity, cheating, general).

  • Active warnings expire and decay after a configurable duration (default: decay-duration: 30d).
  • Historical records remain in the database for auditing via /history <player>.

In plugins/NookureStaff/punishment/config.yml, server owners can configure automated escalation ladders per warning category. When a player accumulates active warnings within that category, the configured actions are executed automatically:

plugins/NookureStaff/punishment/config.yml
warn:
# Default warning category when none is specified.
default-category: general
# Default duration before warnings expire / decay (e.g. 30d). Old warnings won't count towards category thresholds.
decay-duration: 30d
categories:
toxicity:
# Human-friendly display name of the category.
display-name: Toxic Behavior
# Material icon used in the template selector GUI.
material: POISONOUS_POTATO
# Default reason for warnings issued under this category.
reason: Inappropriate behavior, disrespect or toxicity
# Map of warn count (e.g. 1, 2, 3...) to a list of sanctions to apply when reaching that count.
actions:
'1':
- tempmute 2h Toxic behavior
'2':
- tempmute 1d Toxic behavior
'3':
- tempban 3d Severe toxicity
'4':
- tempban 14d Severe toxicity
'5':
- ban Persistent toxicity

Looking for mandatory evidence deadlines, /evidence commands, or S3 presigned uploads? See the dedicated Evidence & S3 Uploads guide.