# Main/core config guide You can access the below settings in the **config.yml** file within the plugin's root folder. {% hint style="success" %} **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:** {% endhint %} {% content-ref url="/pages/-MFJ4FTIcBrX-7-q3XIe" %} [config.yml](/files/files/root-folder/config.yml.md) {% endcontent-ref %} ### ### 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! ```yaml check-for-updates: true ``` ### 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](/network-bridge-setup-guide.md) 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. ```yaml bungeecord: enable: false sync-configs: true sync-playerdata: true global-admin-notifier-messages: true ``` ### 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. ```yaml process-commands: true ``` ### process-signs, process-anvils, process-books Should ChatSentry's applicable modules filter through writing on signs, renaming items in anvils, and writing in books? {% hint style="info" %} Currently the only modules directly supporting these options are the Word & Phrase Filter, the Link & Ad Blocker, and the Unicode Remover {% endhint %} ```yaml process-signs: true process-anvils: true process-books: true ``` ### 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. ```yaml context-prediction: true ``` ### 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. ```yaml disable-vanilla-spam-kick: true ``` ### 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. ```yaml enable-violations-log: true ``` ### 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. ```yaml enable-logging-for: chat-cooldown: false link-and-ad-blocker: true word-and-phrase-filter: true spam-blocker: false unicode-remover: true cap-limiter: false anti-parrot: true anti-chat-flood: false anti-statue-spambot: false chat-executor: false ``` ### 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 ```yaml override-bypass-permissions: chat-cooldown: false link-and-ad-blocker: false word-and-phrase-filter: false spam-blocker: false unicode-remover: false cap-limiter: false anti-parrot: false anti-chat-flood: false anti-statue-spambot: false anti-join-flood: false chat-executor: false auto-grammar: false anti-command-prefix: false command-spy: false ``` ### enable-\ 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. ```yaml # Intelligent Auto Punisher: # Automatically runs punishment commands on players who excessively trigger modules within a defined time frame. enable-auto-punisher: false # Intelligent Chat Cooldown: # Controls how quickly players can send messages and configured or all commands within a defined time frame. enable-chat-cooldown: false # Intelligent Spam Blocker: # 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. enable-spam-blocker: false # Intelligent Link & Ad Blocker: # 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. enable-link-and-ad-blocker: false # Intelligent Word & Phrase Filter: # 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). enable-word-and-phrase-filter: false # Unicode Remover: # 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) enable-unicode-remover: false # Intelligent Cap Limiter: # 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. enable-cap-limiter: false # Anti Statue Spambot: # 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. enable-anti-statue-spambot: false # Intelligent Anti Parrot: # 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. enable-anti-parrot: false # Intelligent Anti Chat Flood: # Prevents or intelligently modifies the use of excessive repeated characters and very long "words" without interfering with players using 'expressive' chat. enable-anti-chat-flood: false # Anti Join Flood: # Prevents more than a defined amount of players joining every minute to prevent bot join flooding to lag, spam, & or crash the server. enable-anti-join-flood: false # Anti Command Prefix: # 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. enable-anti-command-prefix: false # Intelligent Chat Executor: # Modifies and or performs actions triggered by defined chat messages/commands using simple or complex matching techniques. enable-chat-executor: false # Auto Grammar: # Converts players' messages to use proper capitalization, periods, and correct typos in chat and configured or all commands. enable-auto-grammar: false # Command Spy: # 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. enable-command-spy: false # Admin Notifier: # Notifies admins real-time when a module is triggered with detailed information, allowing them to know when to take action if necessary. enable-admin-notifier: false ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.chatsentry.xyz/config-guides/main-config.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.