Description
Filters words, characters, or spam from chat and player names. Requires only ES 2.0+
Options:[syntax="es"]// EZFilter release 2 options
// ./addons/eventscripts/ezfilter/ezfilter.cfg
// http://addons.eventscripts.com/addons/view/ezfilter
// Load this addon with: es_load ezfilter
// To configure language settings for EZFilter please see ezfilter_languages.ini
// ***** Replacement options *****
ezfilter_replace_characters "@#$%&*"
// Characters to use when masking a filtered words without a replacement word [default "@#$%&*"]
ezfilter_replace_line 0
// 0 = replace or mask filtered words, 1 = suppress chat that contains filtered words [default 0]
ezfilter_replace_strikes 1
// 0 = filtering a word or character adds no strikes, 1 = filtering any number of words or characters in a line containing is considered a strike,
// 2 = every word or character that is filtered is considered a strike [default 1]
ezfilter_replace_names 1
// 0 = no change, 1 = mask or replace filtered words in names when players connect but kick players who retain a filtered name,
// 2 = kick all players with a filtered word in their name [default 1]
// ***** Spam options *****
ezfilter_spam_delay 2
// Number of seconds after saying a line players must wait to say the next line--set to 0 to remove [default 2]
ezfilter_spam_duplicate 1
// 0 = no change, 1 = chat that is a duplicate of the player's previous chat is considered spam [default 1]
ezfilter_spam_strikes 1
// 0 = filtering spam adds no strikes, 1 = filtering a line as spam is considered a strike [default 1]
// ***** Character restriction options *****
ezfilter_characterrestrict 1
// 0 = no change, 1 = only allow specified characters [default 1]
ezfilter_characterrestrict_allow "!#$%&'()*+,-./0123456789:;-=-?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_` abcdefghijklmnopqrstuvwxyz{|}~"
// Characters allowed when characters are restricted [default "!#$%&'()*+,-./0123456789:;-=-?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_` abcdefghijklmnopqrstuvwxyz{|}~"]
// Note: Quotation marks are always allowed.
ezfilter_characterrestrict_strikes 0
// 0 = filtering characters adds no strikes, 1 = filtering characters is considered a strike [default]
// ***** Punishment options *****
// Note that a maximum of one punishment can be executed when a player uses a filtered word.
ezfilter_punishment_strikes_clear 2
// 0 = never clear strikes, 1 = clear strikes every time EZFilters is loaded, 2 = clear strikes every map [default 2]
ezfilter_punishment_warn_strikes 3
// Number of strikes a player must have to be warned--set to 0 to remove this punishment [default 3]
ezfilter_punishment_mute_strikes 5
// Number of strikes a player must have to be muted--set to 0 to remove this punishment [default 5]
ezfilter_punishment_mute_delay 60
// Number of seconds to mute players--set to 0 for effect to remain while EZFilter is loaded [default 60]
ezfilter_punishment_kick_strikes 8
// Number of strikes a player must have to be kicked--set to 0 to remove this punishment [default 8]
ezfilter_punishment_ban_strikes 10
// Number of strikes a player must have to be banned--set to 0 to remove this punishment [default 10]
ezfilter_punishment_ban_time 0
// Minutes to ban players--set to 0 for permanent [default 0]
// ***** Announcement options *****
ezfilter_announce_warn_chat 1
// 0 = no change, 1 = players receive the warn punishment in chat area [default 1]
ezfilter_announce_warn_center 1
// 0 = no change, 1 = players receive the warn punishment in center text [default 1]
ezfilter_announce_warn_hud 1
// 0 = no change, 1 = players receive the warn punishment in a HUD message [default 1]
ezfilter_announce_mute_console 0
// 0 = no change, 1 = announce to the player on the console when he or she is muted,
// 2 = announce to all players on the console when a player is muted [default 0]
ezfilter_announce_mute_chat 2
// 0 = no change, 1 = announce to the player in chat area when he or she is muted,
// 2 = announce to all players in chat area when a player is muted [default 2]
ezfilter_announce_mute_center 1
// 0 = no change, 1 = announce to the player in center text when he or she is muted [default 1]
ezfilter_announce_mute_hud 1
// 0 = no change, 1 = announce to the player in a HUD message when he or she is muted [default 1]
ezfilter_announce_unmute_console 0
// 0 = no change, 1 = announce to the player on the console when he or she is unmuted,
// 2 = announce to all players on the console when a player is unmuted [default 0]
ezfilter_announce_unmute_chat 2
// 0 = no change, 1 = announce to the player in chat area when he or she is unmuted,
// 2 = announce to all players in chat area when a player is unmuted [default 2]
ezfilter_announce_unmute_center 1
// 0 = no change, 1 = announce to the player in center text when he or she is unmuted [default 1]
ezfilter_announce_unmute_hud 1
// 0 = no change, 1 = announce to the player in a HUD message when he or she is unmuted [default 1]
ezfilter_announce_ban_console 0
// 0 = no change, 1 = announce to all players on the console when a player is banned [default 0]
ezfilter_announce_ban_chat 1
// 0 = no change, 1 = announce to all players in chat area when a player is banned [default 1]
// ***** Filter word options *****
// To configure which words should be filtered, use the following command:
// ezfilter_add -"word"- ["replacement word"]
// -"word"- is the word or phrase to filter and is not case sensitive
// ["replacement word"] is the word or phrase to use instead of the filtered word or phrase (optional)
// - Filtered words without replacement words will be replaced with random characters from ezfilter_replace_characters.
// The following options are an example and should be changed as desired:
ezfilter_add "cat"
// The word "cat" will be replaced with random characters from ezfilter_replace_characters
ezfilter_add "llama"
// The word "llama" will be replaced with random characters from ezfilter_replace_characters
ezfilter_add "octopus" "octopi"
// The word "octopus" will be replaced with "octopi"
ezfilter_add "mouse" "mice"
// The word "mouse" will be replaced with "mice"
ezfilter_add "cow" "kine"
// The word "cow" will be replaced with "kine"
// Chat filters can be removed with the following command:
// ezfilter_remove -word-
// Due to the fact chat filters can be added and removed above, this command will not be used by most users.
// ***** Say command options *****
// Note that say commands which do not show up in chat will be automatically ignored by EZFilter.
// To configure say commands that should be ignored in addition those automatically ignored, use the following command:
// ezfilter_command_add -command- [0 = do not filter words after command, 1 = filter words after command]
// -command- is the say command that will be ignored by EZFilter and is case sensitive
// - When the second parameter is omitted it is assumed to be 1.
// The following options are an example and should be changed as desired:
ezfilter_command_add alligator
// Chat lines that being with the command "alligator" won't count as spam but will be filtered
ezfilter_command_add !frog
// Chat lines that being with the command "!frog" won't count as spam but will be filtered
ezfilter_command_add !trout 0
// Chat lines that being with the command "!trout" won't count as spam and won't be filtered
// Say commands can be removed with the following command:
// ezfilter_command_remove -command-
// Due to the fact say commands can be added and removed above, this command will not be used by most users.
// ***** Immunity options *****
// Note that immunity options are not saved. The options below designate immunities each time the script is loaded.
// To configure which players are immune from filters, use the following command:
// ezfilter_immunity_add -"Steam ID"- [0 = immune from punishments, 1 = immune from punishments and filters]
// -"Steam ID"- is the Steam ID of the player you wish to designate as immune
// - When the second parameter is omitted it is assumed to be 0.
// The following options are an example and should be changed as desired:
ezfilter_immunity_add "STEAM_0:0:0000000" 1
// Makes the player with Steam ID "STEAM_0:0:0000000" immune from being punished or filtered
ezfilter_immunity_add "STEAM_0:0:0000001"
// Makes the player with Steam ID "STEAM_0:0:0000001" immune from being punished
ezfilter_immunity_add "STEAM_0:0:0000002"
// Makes the player with Steam ID "STEAM_0:0:0000002" immune from being punished
// Immunities can be removed with the following command:
// ezfilter_immunity_remove -"Steam ID"-
// Due to the fact immunities can be added and removed above, this command will not be used by most users.
// ***** Documentation *****
// This addon also makes available the following server command:
// ezfilter_mute -userid/Steam ID/player name- [duration in seconds--set to 0 for effect to remain while EZFilter is loaded]
// This command has all the effects of being muted for strikes. If duration is omitted, ezfilter_punishment_mute_delay will be used instead.
// This addons fires the player_filtered event when a player says a line that is filtered.
// player_filtered
// event_var(userid) - Userid of the player whose chat was filtered
// event_var(strike) - Number of strikes the player has
// event_var(reason) - Reason for filter ("LANGUAGE", "MUTE", "SPAM")[/syntax]
Please see the forum link below for more translations or if you have a translation to add. Please also post general questions or comments.
Version Notes For 2
Updated on: 2007-11-14 16:48:47 EST by SuperDave (
View Zip Contents)
-Fixed the error where registered say commands were distorted
-Fixed the error where names that were filtered but not considered a strike were ignored
-Fixed the incorrect file structure inside the .zip
-Added the ability to filter based on characters
-Added French translation (thanks eric0279!)
( Previous Versions )