XRulesPunishments

ATTENTION!!!
Plugin depends on XConfiguration

XRulesPunishments - is a small plugin that allows you to easily punish players according to predefined rules. The rules and the number of possible violations are predefined in the plugin configuration. Can be extremely useful when used in conjunction with plugins such as Essentials or LiteBans.

Configuration
The basic plugin configuration looks like this:

# Supported types of actions:
# [console] - execute command from console
# [punished_command] - execute a command from the punished player
# [executor_command] - execute the command fromf the executor of the punishment
# [punished_message] - send a message to the punished player
# [executor_message] - send a message to the executor of the punishment
# [broadcast_message] - broadcast message to all online players
# [broadcast_sound] (works only on server, not proxy) - broadcast sound to all online players
# [punished_sound] (works only on the server) - play a sound to the punished player
# [executor_sound] (works only on the server) - play sound to the executor of the punishment
# Specify 'Can-be-executed-on-offline-target: true' if the rule can be executed on offline player
Rules:
- ==: Rule
  Identifier: '1.1'
  Violations:
    '1':
    - '[console] mute {player_name} 5m The first violation of rule 1.1, you are muted
      for 5 minutes.'
    '2':
    - '[console] mute {player_name} 15m The second violation of rule 1.1, you are
      muted for 15 minutes.'
    '3':
    - '[console] ban {player_name} 5m The third violation of rule 1.1, you are banned
      for 5 minutes.'

The plugin generates an example rule, which you can use to create your own rules.

Identifier:
The identifier of the rule by which it will be possible to assign punishments.
Used for the command ' /rulespunishment punish...'.

Section Violations:
Sets the levels and penalties for each of them. When a player is punished for the first time, the plugin remembers the violator and the rule that he violated, and actions for punishment from the first level are triggered. If, after that, the same player is punished again according to the same rule, the action section of the second level will be triggered. Etc. After the player reaches the maximum punishment level, the punishment level for the player under this rule is reset.

Players rule violation levels are stored for 5 hours from the moment they are assigned.

Action List:
It is a string consisting of two parts - the type of action and arguments.
Supported action types:

• [console] - execute command from console
• [punished_command] - execute a command from the punished player
• [executor_command] - execute the command from the executor of the punishment
• [punished_message] - send a message to the punished player
• [executor_message] - send a message to the executor of the punishment
• [broadcast_message] - send a message to all online players
• [broadcast_sound] (works only on the server) - play sound to all online players
• [punished_sound] (works only on the server) - play a sound to the punished player
• [executor_sound] (works only on the server) - play sound to the executor of the punishment

Commands and permissions
- /rulespunishments [Alias: /rp] - prints all plugin commands.
Permission: rules.punishments.commands.help
- /rulespunishments help - prints all plugin commands.
Permission: rules.punishments.commands.help
- /rulespunishments reload - reloads plugin configurations.
Permission: rules.punishments.commands.reload
- /rulespunishments punish [rule identifier] [player's nickname] - punish the player according to a certain rule.
Permission: rules.punishments.commands.punish

To fully use the '/ rulespunishments punish ...' command, in addition to the permission for the 'rules.punishments.commands.punish' command itself, you must have permission for the applied rule 'rules.punishments.commands.punish.{rule_identifier}' or permission to use all rules 'rules.punishments.commands.punish. *'.