Ping Tracker

Overview

The ping tracker plugin allows you to track the ping of connected players and kick them if they are consistently above a set maximum. You can also kick players that have a large average variation in their ping.

The "MaxJitter" setting controls the maximum average change in ping between measurements. Each time the ping is recorded, the difference from the last recorded ping is also stored. When the ping is averaged, these changes in ping are also averaged and if the average change exceeds the "MaxJitter" setting, the player is warned or kicked.

This stops people with constantly spiking ping from remaining on the server, as they are more likely to be warping around, but their average ping will likely be below the "MaxPing" setting.

The plugin will wait 30 seconds after a player has loaded in before it starts to track their ping to give it time to settle.

Config

The default config looks something like this:

{
    "MeasureInterval": 1,
    "CheckInterval": 60,
    "Warn": true,
    "MaxPing": 200,
    "MaxJitter": 50
}

The file should be called "PingTracker.json" and should be placed in the directory defined as your plugin config directory (default is config://shine/plugins).

Option	Description
MeasureInterval	Sets how often, in seconds, the plugin should check a player's ping.
CheckInterval	Sets how often, in seconds, the plugin should calculate an average ping and average ping variation and warn/kick if necessary.
Warn	Sets whether to warn players on the first time their average ping is above the tolerance.
MaxPing	Sets the maximum tolerated average ping.
MaxJitter	Sets the maximum tolerated average ping variation.

Immunity

If you wish to make a group immune to this plugin's effects, give them access to sh_pingimmune.