PunishAttacker 1.8.9

Quote

REQUIRES

Rust UI Framework

Download and put .dll file into "RustDedicated_Data\Managed" folder

Tired of someone shooting into your players face on your PVE server? While it deal no damage it may lead to fps loss and be really annoying. This plugin will help you to punish them.

The main idea of the plugin is to punish a player attacking another. There is variety of options in config file.

You need to decide what exactly you want to do with attackers to punish them.

Plugin will count every hit attacker made to another player. More hits - heavier punishment, because hits counter serves as multiplier. There are 4 thresholds by number of hits attacker made:

1. The number of hits allowed without punishment
2. The number of hits before death is used as a punishment
3. The number of hits before kick is used as a punishment
4. The number of hits before ban is used as a punishment

Start with setting a number of hits you may allow do deal without punishment. Notifications to stop attacking players still appear (if enabled in config). Then set initial percentage of damage that attacker will get back. For example, by default it set to 0.5, so if attacker hits another player and dealt 30 hp damage he will get 50% back = -15 hp. Additionally ServerRewards RP will be discounted (if enabled in config) by formula: Initial server reward RP amount * The number of hits attacker made. After reaching death as punishment threshold punishment include death. After reaching kick as punishment threshold punishment include kick (if enabled in config) and additionally ZLevelsRemastered levels skills amount may also be taken (if enabled in config). After reaching ban as punishment threshold punishment include ban (if enabled in config).

There are 2 ways to inflict damage on an attacker - using the slap plugin (if activated in config and loaded) or simply by taking away health.

Here is an example of how this plugin works with default thresholds values (5, 10, 15) and Initial percentage damage (0.5) with 50 hp damage dealt by each shot.

So by default, first threshold is 5 hits without punishment. Every hit attacker made he gets notification to stop attacking players. If player will continue hitting another player and reach first threshold 5 hits, on 6th hit he will get punishment: -25 hp (-50 hp, -75 hp and so on) and -100 RP (-200 RP, -300 RP and so on). If player will continue hitting another player and reach second threshold 10 hits, on 10th hit and every hit afterwards he will get punishment: death. If player will continue hitting another player and reach third threshold 15 hits, on 15th hit and every hit afterwards he will get punishment: kick and -10 levels skills in ZLevelsRemastered.

You may also change time (5 minutes default) after which hits number will be cleared and count will start from scratch.

Zone Manager support.

If ZoneManager include mode is set to true, only attackers in specified zones will be punished. If set to false, only attackers outside specified zones will be punished.

As a bonus, this plugin may help to solve several other problems:

1. Protect personal growables from being damaged by other players
2. Protect personal vehicles from being damaged by other players
3. Prevent any fireball damage

There is a problem with fireball damage in rust - you can't detect the author of this type of damage. So there is no way to know whose fireball is attacking target. This type of damage is dealt only by incendiary bullets. So to prevent players from abusing this you may want to disable incendiary bullets damage entirely.

## Permissions

• punishattacker.use -- give player/group this permission to activate punishment system for them

• punishattacker.immunity -- allows player to be ignored by punishment system

## Commands
This plugin provides no commands

## Configuration

• Enable / disable notifications / logging
• Set SteamIDIcon steamid to set desired account icon in chat messages
• Enable / disable modes/plugins support

Quote

{
  "GUI notification enabled": false,
  "Chat notification enabled": false,
  "Chat steamID icon": 0,
  "Prevent private growables damage": false,
  "Prevent private vehicles damage": false,
  "Prevent fireball damage": false,
  "Prevent self damage": false,
  "Prevent ally damage (team / friend / clan)": false,
  "Use Clans": false,
  "Use Friends": false,
  "Use Teams": false,
  "Use Duelist": false,
  "Use RaidableBases": false,
  "Prevent damage inside RaidableBases zone": false,
  "Prevent ally damage inside RaidableBases zone": false,
  "Use LifeSupport": false,
  "Use MultiEvents": false,
  "Use ServerRewards": false,
  "Use Economics": false,
  "Use Slap": false,
  "Use ZLevelsRemastered": false,
  "Use ZoneManager": false,
  "Prevent damage in ZoneManager zone": false,
  "ZoneManager include mode (true = include mode / false = exclude mode)": false,
  "ZoneIDs": [
    "12345",
    "54321"
  ],
  "Use DynamicPVP": false,
  "Punish settings": {
    "Clear tracked hits number every (seconds)": 300.0,
    "Number of hits allowed before punishment": 5,
    "Number of hits before punishment is death": 10,
    "Allow kick as punishment": false,
    "Number of hits before punishment is kick": 15,
    "Allow ban as punishment": false,
    "Number of hits before punishment is ban": 20,
    "Initial percentage of damage as punishment": 0.5,
    "Initial Server Rewards RP amount taken as punishment": 100,
    "Initial Economics Coins amount taken as punishment": 1000.0,
    "ZLevelsRemastered levels amount to take as punishment": 10
  },
  "Log Level (Debug, Info, Warning, Error, Off)": "Off"
}

## Localization

Out of the box plugins phrases are available on : English, Russian and Ukrainian

{
  "Format.Prefix": "<color=#00FF00>[PunishAttacker]</color>: ",
  "Punishment.Damage": "Attacking other player punishment damage: <color=#FFA500>{0}</color>",
  "Punishment.Ban": "Banned for continuously attacking other player",
  "Punishment.Kick": "Kicked for continuously attacking other player",
  "Punishment.Kill": "<color=#FFA500>{0}</color> was attacking <color=#FFA500>{1}</color> and was punished",
  "Warning.First": "Stop attacking players or you will be punished!",
  "Warning.Second": "Stop attacking players or you will be killed!",
  "Warning.Third": "Stop attacking players or you will be kicked!",
  "Warning.Fourth": "Stop attacking players or you will be banned!"
}

Log file example: