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
  • Placeholders:
  • Executors:
  • Targets:
  • Filters

Was this helpful?

  1. Features
  2. Warnings

Actions (punishments)

PreviousThresholdsNextAppealing

Last updated 3 years ago

Was this helpful?

We can define actions inside the warnings-module. Actions will be executed whenever a warning is issued. Every action must follow the

Besides the general command, a rollback-command can be specified. A rollback command follows the . The rollback command gets executed whenever a warning is deleted or has been successfully .

Placeholders:

placeholder

description

%target%

The name of the player that was warned

%issuer%

The name of the staff member that created the warning

%severity%

The severity of the warning

%score%

The score of the warning

%reason%

The reason of the warning

Executors:

executor value

description

target

The player that has been warned

issuer

The staff member that issued the warning

Targets:

target value

description

target

The player that has been warned

issuer

The staff member that issued the warning

Filters

filter

possible values

description

type

comma separated list of the any type

hasculprit

[true/false]

Can specify if a command should be executed only when it's a report that is targeting a player

Example configuration:

warnings-module:
  actions:
    - command: 'eco take %target% 2000'
      filters: 'severity=MINOR,MAJOR'
      rollback-command: 
        command: 'eco give %target% 2000'
    - command: 'eco take %target% 5000'
      filters: 'severity=CRITICAL'
      rollback-command: 
        command: 'eco give %target% 5000'
    - command: 'freeze enabled %target%'
      filters: 'severity=CRITICAL'
      rollback-command: 
        command: 'freeze disabled %target%'

In the above example configuration the following will happen:

If a MINOR or MAJOR warning is issued. - The target will be deducted $2000 from his balance. If a CRITICAL warning is issued. - The target will be deducted $5000 from his balance. - The target will get frozen if he is online, or the next time he comes online. If the warning gets rollbacked the target will get automatically reimbursed.

It's important to not that actions get linked to the warning the moment the warning is created. Changing the action configuration will not impact existing warnings.

Can specify if a command should be executed only when the report is of a certain

Staff++ command format
Staff++ command format
appealed
type