Staff++
latest
latest
  • Staff++
  • General information
    • Quick start
    • Reload Configuration
    • Multi Server Setup
    • General Configuration
    • Other
      • Text parsing
      • Styling the GUIs
        • Gui structure
        • Selectors
      • Configuring command hooks
  • Permissions & Commands
    • Commands
    • Permissions
      • Legacy permissions
  • Features
    • Alerts
      • X-Ray
    • Alt account detection
    • Authentication
    • Banning
      • IP Banning
        • Messages
      • Fixed Ban Reason
      • Templates
    • Blacklist
    • Broadcasting
    • Chat module
    • Chest/Inventory Interaction
    • Command detection
    • Examine players
    • Freezing
      • Command hooks
      • Luckperms integration
      • Chat channels
    • Infractions
    • Investigate
      • Command hooks
    • Join messages
    • Player IPs
    • Kicking
    • Muting
      • Appealing
    • Protection
    • Player information
    • Player notes
    • Reporting
      • Command hooks
      • Messages
      • Finding reports
      • Report types & Reasons
      • Chat channels
    • Staff Chat
    • Staff Mode
      • Multiple modes
      • Staff Modules
      • Custom Staff Modules
        • State dependent modules
      • Command hooks
      • Luckperms integration
    • Staff Locations
    • Teleporting
    • Vanish
      • Luckperms integration
    • Warnings
      • Quick start
      • Severity levels
      • Thresholds
      • Actions (punishments)
      • Appealing
      • Warning workflow
  • Web Platform
    • Register Players
    • Setup Web Platform
    • Architecture
  • Integrations
    • Discord Integration
      • Staff Chat
      • Template Packs
      • Customize Discord Templates
    • Trello Integration
    • PAPI expansion
      • PAPI Examples
  • Migration guides
    • Staff+ migration guide
    • Migrating to >=V1.16.43
    • Upgrading Discord Integration to 1.16.51
  • Developers
    • API guide
Powered by GitBook
On this page

Was this helpful?

  1. Features
  2. Warnings

Thresholds

PreviousSeverity levelsNextActions (punishments)

Last updated 3 years ago

Was this helpful?

Thresholds can be reached by players if they receive too many warnings. An example configuration:

severity-levels:
  - name: STEALING
    score: 1
    expiresAfter: 1 WEEK
  - name: GRIEFING
    score: 3
  - name: BULLYING
    score: 6
thresholds:
  - score: 3
    actions:
      - command: "tempban %target% 4 days"
  - score: 6
    actions:
      - command: "ban %target%"
        rollback-command: 
          command: "unban %target%" 

We defined two thresholds. When the player reaches the first threshold of a total warning score of 3 he will be temporarily banned. Keep in mind that his total score wont be reset. Which means that if he gets another warning for stealing for example, his total score will be 4 and he will immediately get temporarily again. So once you reach a threshold you will be punished more severely on subsequent warnings.

However warnings can be expired. This mean they will no longer be counted during threshold calculations.

The second threshold bans a player when he reaches a total score of 6. This also means that a warning for bullying in this example will immediately ban the player.

Score Calculation Example

Consider player "myman" has following warning history:

Type

score

appeal approved

expired

STEALING

1

true

false

GRIEFING

3

false

false

GRIEFING

3

false

true

STEALING

1

true

true

BULLYING

6

false

false

In this example the player his total score will be: 9

  • The first warning does not count because it was successfully appealed

  • The second warning counts

  • The third warning does not count because it is expired

  • The fourth warning does not count because it was successfully appealed AND expired

  • The fifth warning counts

You will notice you can also define here. These will get executed if the warning that originally caused a threshold breach gets deleted or .

banned
appealed
rollback-commands