Main/core config guide
You can access the below settings in the config.yml file within the plugin's root folder.
Config excerpts taken from v4.4.0 and may not be completely up-to-date with the latest changes. To see the most up-to-date file, see below:

check-for-updates

Should ChatSentry notify operators (and players with the permission "chatsentry.admin") when new plugin updates are available?
Keeping this on is highly recommended as otherwise you won't be able to take advantage of new features and fixes as quickly!
1
check-for-updates: true
Copied!

bungeecord

Experimental: Using BungeeCord? ChatSentry offers various cross-server synchronization options below.
For information on how to set up the plugin to work with BungeeCord, see the guide here: https://wiki.chatsentry.xyz/bungeecord-bridge-setup-guide
The below settings are global and non-exclusive to this instance. Any changes made here will be applied to all other ChatSentry configs on your network.
1
bungeecord:
2
enable: false
3
sync-configs: true
4
sync-playerdata: true
5
global-admin-notifier-messages: true
Copied!

process-commands

Should ChatSentry's modules filter commands as well as chat? Unless otherwise stated in their descriptions, modules require this option to be enabled in order to filter commands. Almost all modules support processing commands.
1
process-commands: true
Copied!

process-signs, process-anvils, process-books

Should ChatSentry's applicable modules filter through writing on signs, renaming items in anvils, and writing in books?
Currently the only modules directly supporting these options are the Word & Phrase Filter, the Link & Ad Blocker, and the Unicode Remover
1
process-signs: true
2
process-anvils: true
3
process-books: true
Copied!

context-prediction

Context prediction aims to increase positive detections and decrease false positive detections through acting as a safenet for supported modules with sophisticated logic that dynamically adjusts thresholds and options real-time to react more precisely based on predicted context of messages. Adjustments are temporary & unique to messages; they do not permanently change any config options.
1
context-prediction: true
Copied!

disable-vanilla-spam-kick

Should ChatSentry disable Minecraft's built in "Kicked for spamming" / "disconnect.spam" kick? There is no way to disable these kicks in the server configuration, however with a workaround ChatSentry can override it and prevent it from occurring. It's recommended to keep this enabled to give the auto punisher full punishment priority.
1
disable-vanilla-spam-kick: true
Copied!

enable-violations-log

Should chat detections and violations be logged for future reference? This is required to be enabled in order to make use of the lookup command.
1
enable-violations-log: true
Copied!

enable-logging-for

Below is which violations and detections are logged. Requires the above option to be enabled.
It's recommended you keep these as they are by default to prevent unnecessary detections being logged and taking up useless storage space.
1
enable-logging-for:
2
chat-cooldown: false
3
link-and-ad-blocker: true
4
word-and-phrase-filter: true
5
spam-blocker: false
6
unicode-remover: true
7
cap-limiter: false
8
anti-parrot: true
9
anti-chat-flood: false
10
anti-statue-spambot: false
11
chat-executor: false
Copied!

override-bypass-permissions

You can disable the functionality of particular module and restrictions' bypass permissions and force modules to apply themselves to players even with bypass permissions or op by enabling the overrides below
It's recommended you do this per-player/group with permissions by simply negating/disabling the bypass permission for modules/restrictions you'd like to apply to them if they have the bypass all permission. However, this option is available as a hard override
This option is also useful for testing purposes if you don't want to have to deop yourself to test a module or restriction
1
override-bypass-permissions:
2
chat-cooldown: false
3
link-and-ad-blocker: false
4
word-and-phrase-filter: false
5
spam-blocker: false
6
unicode-remover: false
7
cap-limiter: false
8
anti-parrot: false
9
anti-chat-flood: false
10
anti-statue-spambot: false
11
anti-join-flood: false
12
chat-executor: false
13
auto-grammar: false
14
anti-command-prefix: false
15
command-spy: false
Copied!

enable-<module>

Below you can enable the modules you'd like to use. Go in to the modules config files in the modules folder to adjust their settings.
1
# Intelligent Auto Punisher:
2
# Automatically runs punishment commands on players who excessively trigger modules within a defined time frame.
3
enable-auto-punisher: false
4
5
# Intelligent Chat Cooldown:
6
# Controls how quickly players can send messages and configured or all commands within a defined time frame.
7
enable-chat-cooldown: false
8
9
# Intelligent Spam Blocker:
10
# Prevents players from repeating the same or similar messages over and over within a short period of time. The more times a player attempts to repeat a message when it's already being blocked, the longer before they will be able to repeat themselves again, creating a dynamic and infinitely expanding block period that will disallow spam bots trying to repeat the same messages over and over for long durations of time.
11
enable-spam-blocker: false
12
13
# Intelligent Link & Ad Blocker:
14
# Prevents web links & server advertising (regular server ips & numeric server ips) with optional extra sensitivity bypass detection in chat, commands, signs, anvils, and books (additional check contexts can be disabled). Includes the ability to whitelist domains or all subdomains of a domain.
15
enable-link-and-ad-blocker: false
16
17
# Intelligent Word & Phrase Filter:
18
# Hyper intelligently detects swears configured blocked words or phrases (and words/phrases similar to those on the list) from being said in chat, commands, signs, anvils, and books (additional check contexts can be disabled).
19
enable-word-and-phrase-filter: false
20
21
# Unicode Remover:
22
# Removes non US-ASCII (US keyboard) characters in chat messages and commands to prevent alphanumeric lookalike unicode characters from being used to bypass filters & modules. Has the option to use a compatibility mode that only blocks unicode used by hacked clients - blocking virtually all alphanumeric lookalike unicode supported by MC while allowing other languages in chat, commands, signs, anvils, and books (additional check contexts can be disabled)
23
enable-unicode-remover: false
24
25
# Intelligent Cap Limiter:
26
# Limits the use of excessive capital letters in messages without interference of messages using proper grammar. Can auto-set the message to lowercase or blocks it entirely. Player names are ignored.
27
enable-cap-limiter: false
28
29
# Anti Statue Spambot:
30
# Prevents joining players abilities to send messages or commands until they move in order to protect against basic artificially controlled spam bots. Has an optional command whitelist. Does not require "process-commands" in the main config to be enabled to function.
31
enable-anti-statue-spambot: false
32
33
# Intelligent Anti Parrot:
34
# Prevents players using hacked clients to automatically copy ("parrot") other players chat messages. Also prevents the same (non-generic) message from be said by multiple players within a short time frame.
35
enable-anti-parrot: false
36
37
# Intelligent Anti Chat Flood:
38
# Prevents or intelligently modifies the use of excessive repeated characters and very long "words" without interfering with players using 'expressive' chat.
39
enable-anti-chat-flood: false
40
41
# Anti Join Flood:
42
# Prevents more than a defined amount of players joining every minute to prevent bot join flooding to lag, spam, & or crash the server.
43
enable-anti-join-flood: false
44
45
# Anti Command Prefix:
46
# Prevents players using prefixed commands to get around filters and discover potential sensitive server information like the plugins. Ex. /minecraft:me instead of /me. Does not require "process-commands" in the main config to be enabled to function. Optionally integrates with the Command Spy module; when a command is modified/a prefix is removed, it will appear crossed out in the command spy notification.
47
enable-anti-command-prefix: false
48
49
# Intelligent Chat Executor:
50
# Modifies and or performs actions triggered by defined chat messages/commands using simple or complex matching techniques.
51
enable-chat-executor: false
52
53
# Auto Grammar:
54
# Converts players' messages to use proper capitalization, periods, and correct typos in chat and configured or all commands.
55
enable-auto-grammar: false
56
57
# Command Spy:
58
# Shows players real-time commands to admins. Commands can optionally be whitelisted or blacklisted. Does not require "process-commands" in the main config to be enabled to function.
59
enable-command-spy: false
60
61
# Admin Notifier:
62
# Notifies admins real-time when a module is triggered with detailed information, allowing them to know when to take action if necessary.
63
enable-admin-notifier: false
Copied!