Staff++
Search…
Warnings
Staff++ created a new way of warning players.
To setup the warning configuration checkout the quick start

Configuration

1
# Requires "permissions.warn" permission.
2
warnings-module:
3
# Whether or not the plugin will use "/warn" features.
4
enabled: true
5
6
# The sound that is played to the player when warned.
7
# Set to "NONE" to disable.
8
sound: ORB_PICKUP
9
10
11
# Whether or not the player issued the warning will be visible in GUIs.
12
show-issuer: true
13
14
# Enables the ability to notify a user when he has warnings
15
# User will be notified the moment he comes online.
16
user-notifications:
17
enabled: false
18
# Enable this to show the message every time the user comes online.
19
# If Disabled the warnings will be marked as "read" when the player views his warnings
20
# and he will only be notified of new warnings
21
always-notify: false
22
23
actions: []
24
25
severity-levels:
26
- name: MINOR
27
score: 1
28
# After how much time warnings with this severity should expire.
29
# Expired warnings are not counted when doing threshold calculations.
30
expiresAfter: 1 WEEK
31
- name: MAJOR
32
score: 3
33
expiresAfter: 1 MONTH
34
- name: CRITICAL
35
score: 5
36
# Define thresholds for the warning system. Whenever the player reaches a threshold the actions are triggered
37
thresholds:
38
- score: 6
39
actions:
40
- command: "ban %target% &4Met three warnings. Appeal @ &7www.shithcf.net&4."
41
target: target
42
target-run-strategy: DELAY
Copied!

Permissions

Actor
Permission
Description
staff
staff.warn
Authorizes using the /warn command.
staff
staff.warn.bypass
Staff members with this permission can not be warned
staff
staff.warnings.manage.view
Authorizes the usage of the /manage-warnings command
staff
staff.warnings.manage.delete
Authorizes deleting warnings
staff
staff.warnings.manage.expire
Authorizes marking warnings as expired
staff
staff.warnings.notifications
Authorizes staff or players to receive notifications when warnings are being issued
player
staff.warn.view-my-warnings
Authorizes opening the GUI to show your own warnings

Commands

Command
Description
Example
/warn [severity] [player] [reason]
Command to give a player a warning. Severity should be configured inside the configuration file and provided as first argument to the warn command
/warn MAJOR player1 For some reason
/warns [get\|clear] [player]
Command to manage warnings. You can list current warnings or remove all player warnings
/warns clear player1 /warns get player1
/my-warnings
The command for opening the my warnings GUI
/my-warnings
/manage-warnings [player]
Command for opening a GUI showing all the warnings of the give player
/manage-warnings player1

Enable user notifications

You can enable user notifications. This will notify the player that he has warnings. To do so change this part of the warnings-module inside the config file:
1
# Enables the ability to notify a user when he has warnings
2
# User will be notified the moment he comes online.
3
user-notifications:
4
enabled: true
5
# Enable this to show the message every time the user comes online.
6
# If Disabled the warnings will be marked as "read" and he will only be notified of new warnings
7
always-notify: false
Copied!
Whenever a user opens his warning GUI all his warnings are marked as 'read'. If always-notify is disabled, a user will only be notified if he has unread warnings. Keep in mind that to open the warnings GUI the player has to have the following permission: staff.warn.view-my-warnings
Last modified 1mo ago