Addon Details

Watch - Add Favorite


Does this version work for you?
22
w00ts
w00t!2

EZFilter - Version 2

posted on 2007-10-29 14:05:53
by SuperDave



Description

Filters words, characters, or spam from chat and player names. Requires only ES 2.0+

Options:
ES:
    // EZFilter release 2 options
    // ./addons/eventscripts/ezfilter/ezfilter.cfg
    // <!-- m --><a class="postlink" href="http://addons.eventscripts.com/addons/view/ezfilter">http://addons.eventscripts.com/addons/view/ezfilter</a><!-- m -->
     
    // 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")


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 )