Auto Punisher
About this module
The Auto Punisher module automatically runs punishment commands on players who excessively trigger modules within a defined time frame.
Ops or players with the permission: "chatsentry.autopunisher.bypass" will be exempt to ONLY automatic warnings. For the manual warning exemption, see the permissions page.
Currently the only modules that support warnings are:
Chat Cooldown, Link & Ad Blocker, Word & Phrase Filter, Chat Executor, Unicode remover, Cap limiter, Anti Parrot, Anti chat flood, and Anti Statue Spambot
Manual = warnings that are applied manually via /cswarn <player>
Players module warnings can be manually cleared with /cswarnings clearmodulewarnings <player> <module name>
Players admin-given (manual) warnings can be cleared with /cswarnings pardonallmanual <player>
Note: You need a plugin to handle the punishment commands for muting, banning, etc. For the best results, use Essentials or MaxBans' punishment commands.
Config guide
You can access the below settings in the auto-punisher.yml file within the modules folder of the plugin's root folder.
Config excerpts taken from v3.6.0 and may not be completely up-to-date with the latest changes. To see the most up-to-date file, see below:
Under punishment nodes you can:
Use the format "{player_msg}: message" to send a message to the player.
Use the format "{console_cmd}: command" to run a command as the console.
Use the format "{player_cmd}: command" to run a command as the player.
Use the format "{broadcast}: message" to broadcast a message to all players.
Within the above formats, you can use:
"{PLAYER}" - players username for commands.
"{PLAYER_DISPLAYNAME}" - players display name with its original colors
"{PLAYER_DISPLAYNAME_STRIPPED}" - players display name stripped of its original colors
"{CURRENT_WARNS}" - players current warning count for the target module.
"{MAX_WARNS}" - maximum warning count for the target module.
enabled: true/false
nodes determine whether a warning will be added to the player who triggered the module.
warning-lifetime
In hours, how often should one warning (on every module) expire from players?
Set this to -1 to never have warnings expire automatically. This will disable the below this option as well.
check-expiry-interval
In hours, how often (after startup) should the warnings file be scanned for expired warnings? Keep this at 1 unless you experience tick lag from ChatSentry.
Note that the file is also checked on every server startup.
verbose-in-console
Should the Auto Punisher send a message to the console when it warns a player, auto expires a players warning, or runs punishment actions on a player?
suppress-warnings-from-console
When enabled, pardon messages will be hidden from receiver players only if triggered by the console. The point of this is so players don't see when their warnings are reset when triggered by the last punishment set under a module.
broadcast-manual-warnings
Should a broadcast be sent to everybody when a player is manually warned via /warn? (broadcast is configurable via the misc-lang.yml file)
warning-config
IMPORTANT: The applicable above pardon command should be ran at the end (highest) warning count to reset the players warning count immediately to prevent them getting warning counts higher than the max punishment, allowing them to get infinite warnings without punishment.
Last updated
Was this helpful?