m (added <br> lines to force formatting) |
(Updated to match current plugin status.) |
||
| Line 9: | Line 9: | ||
This plugin allows you to filter out lines that would go to your chat windows. Any lines that are filtered out, will not be shown in game. Good for spammers or other types of annoyances. | This plugin allows you to filter out lines that would go to your chat windows. Any lines that are filtered out, will not be shown in game. Good for spammers or other types of annoyances. | ||
| − | + | ==Configuration== | |
| − | + | The plugin is configured via an INI file. Entries are a substring search, and are NOT case sensitive. Using /chatfilter without parameters will show command syntax. | |
| − | |||
| − | |||
| − | |||
| − | + | Default settings for new characters added to the plugin INI file are read from [CF_Settings] and [CF_Filters]. Otherwise, they are read from [CF_Settings_Server_Char] and [CF_Filters_Server_Char]. | |
| − | + | Example of a character named Bubba on the Povar server: | |
| + | [CF_Settings_Povar_Bubba] | ||
| + | [CF_Filters_Povar_Bubba] | ||
===Sample Configuration=== | ===Sample Configuration=== | ||
MQ2ChatFilter.ini | MQ2ChatFilter.ini | ||
| − | <pre>[ | + | <pre>[CF_Settings] |
DefaultState=on | DefaultState=on | ||
| + | SpamFilter=on | ||
| − | [ | + | [CF_Filters] |
Filter1=www.gm963.com | Filter1=www.gm963.com | ||
Filter2=www.gmworker.com | Filter2=www.gmworker.com | ||
| Line 37: | Line 37: | ||
===Command Syntax=== | ===Command Syntax=== | ||
| − | <span class="highlight2">/chatfilter [help | on | off | load | save | add | del | clear | default | list]</span> | + | <span class="highlight2">/chatfilter [help | on | off | load | save | add | del | clear | default | list | spam | debug]</span> |
* <span class="highlight2">on</span>: Turns chat filtering on. | * <span class="highlight2">on</span>: Turns chat filtering on. | ||
| Line 48: | Line 48: | ||
* <span class="highlight2">default</span>: Toggles default status at plugin load (the .ini will be updated with this value). | * <span class="highlight2">default</span>: Toggles default status at plugin load (the .ini will be updated with this value). | ||
* <span class="highlight2">list</span>: Lists current filters. | * <span class="highlight2">list</span>: Lists current filters. | ||
| + | * <span class="highlight2">spam</span>: Toggles automatic filtering of (SPAM) lines. | ||
| + | * <span class="highlight2">debug</span>: Toggles some debug messages to help with troubeshooting. | ||
==Availability== | ==Availability== | ||
| − | MQ2ChatFilter is available as part of the MMOBugs plugin distribution. | + | MQ2ChatFilter is available as part of the MMOBugs plugin distribution for all release types (Live, Test, Emu). |
Revision as of 07:30, 18 October 2020
| Plugin Info | |
|---|---|
| Name | MQ2ChatFilter |
| Version | 1.14 |
| Author | htw |
| Uses INI File | Yes |
Contents
Description
This plugin allows you to filter out lines that would go to your chat windows. Any lines that are filtered out, will not be shown in game. Good for spammers or other types of annoyances.
Configuration
The plugin is configured via an INI file. Entries are a substring search, and are NOT case sensitive. Using /chatfilter without parameters will show command syntax.
Default settings for new characters added to the plugin INI file are read from [CF_Settings] and [CF_Filters]. Otherwise, they are read from [CF_Settings_Server_Char] and [CF_Filters_Server_Char].
Example of a character named Bubba on the Povar server: [CF_Settings_Povar_Bubba] [CF_Filters_Povar_Bubba]
Sample Configuration
MQ2ChatFilter.ini
[CF_Settings] DefaultState=on SpamFilter=on [CF_Filters] Filter1=www.gm963.com Filter2=www.gmworker.com
Configuration Explanation
- DefaultState: Controls the state of the plugin when you first log into game. If DefaultState=on, then filtering is enabled as soon as the plugin is loaded.
- filter#: Where # = 1, 2, etc. See the example above. I.e., Filter1=www.gm963.com would filter out any chat lines with www.gm963.com in it, before you ever saw the chat line in game.
Command Syntax
/chatfilter [help | on | off | load | save | add | del | clear | default | list | spam | debug]
- on: Turns chat filtering on.
- off: Turns chat filtering off.
- load: Loads settings and filters from .ini file (any unsaved additions will be lost!).
- save: Updates .ini file to match current options and filters that are active.
- add: Add a new filter (ex: /chatfilter add "wtb plat" ).
- del: Delete a filter (ex: /chatfilter del 15 ). Deletes filter #15.
- clear: Clears all filters.
- default: Toggles default status at plugin load (the .ini will be updated with this value).
- list: Lists current filters.
- spam: Toggles automatic filtering of (SPAM) lines.
- debug: Toggles some debug messages to help with troubeshooting.
Availability
MQ2ChatFilter is available as part of the MMOBugs plugin distribution for all release types (Live, Test, Emu).