View Single Post
Plugin Info:     Modification:          Category:         
OciXCrom
Veteran Member
Join Date: Oct 2013
Location: Macedonia
Old 05-28-2017 , 10:34   Chat Manager [Admin Prefix & Color Chat]
Reply With Quote #1



Chat Manager





Description
  • The best of its kind plugin that allows you to take full control over your in-game chat. With this plugin you can add admin prefixes, custom player prefixes, different chat color for each player, different chat styles, colored names, change the team prefixes, change the dead prefix, add a prefix for alive players, add city and country, show the IP and SteamID in chat, date and time, log the chat and many more!

Information
  • You will find two plugins in the archive. The first one (crx_chatmanager) is the main plugin, and the second one (crx_chatmanager_toggle) contains the command /cm that allows players to turn on/off their prefix, chat color and custom name. There's no need to add the second plugin if you don't want players to have access to such settings.

Commands
  • The only command found in the main plugin is the command cm_reload that allows admins to immediately reload the configuration file.

Main settings
  • The main settings can be found in the [Main Settings] section in the file configs/ChatManager.ini.
  • ALL_CHAT -- if set to 1, all players will see all chats independant of whether they are dead or alive, this won't let them view the other team's private chat however; setting it to 2 will let them view the team chats as well
  • ADMIN_LISTEN_FLAGS -- players with this flag (or these flags) will be able to see all chats at all time
  • ADMIN_LISTEN_TEAM_CHAT -- whether players with the admin listen flag will be able to see the opposite team's chat
  • GLOBAL_CHAT_FLAG -- when a player with this flag writes in chat, it will be visible for all players at all times
  • GLOBAL_CHAT_TEAM -- whether players with global chat will be visible when writing in their team's private chat
  • BLOCK_FIRST_SYMBOLS -- messages starting with these symbols will be hidden in chat (you can use this to hide messages starting with "/")
  • DEAD_PREFIX -- the prefix for dead players (*DEAD*)
  • ALIVE_PREFIX -- the prefix for alive players (you can leave it blank)
  • SPEC_PREFIX -- the standard *SPEC* prefix for spectators
  • TEAM_PREFIX_T -- (Terrorist) prefix
  • TEAM_PREFIX_CT -- (Counter-Terrorist) prefix
  • TEAM_PREFIX_SPEC -- (Spectator) prefix
  • ERROR_TEXT -- what will show up when an invalid value is recieved
  • FORMAT_TIME -- how to show the time when using %time% (more info here)
  • CHAT_LOG_FILE -- chat messages will be logged in this file; leave it blank if you want to disable logging
  • CHAT_LOG_SAY_FORMAT -- the format that will be used when logging messages from the say chat
  • CHAT_LOG_TEAM_FORMAT -- the format that will be used when logging messages from the say_team chat
  • SAY_SOUND -- here you set a sound that will be played when sending a message in the say chat
  • SAY_TEAM_SOUND -- here you set a sound that will be played when sending a message in the say_team chat
  • EXPIRATION_DATE_FORMAT -- date format used with expiration dates (more info here)
  • EXPIRATION_DATE_BEHAVIOR -- what to do when the date for a specific extra has expired - 0 = ignore the entire line; 1 = put a "#" symbol in the beginning of the line; 2 = remove the entire line from the file
  • COLORCHAT_FLAG -- players with this flag can use color codes in their message (&x01, &x03, &x04) in order to modify their message color
  • SAY_METHOD -- whether the plugin will hook the "say" and "say_team" commands or the "SayText" message

Adding prefixes, chat colors and custom names
  • These things can be added in the [Admin Prefixes], [Chat Colors] and [Name Customization] sections.
  • The names are pretty self-explainatory, so I don't think that additional instructions are needed.
  • You can find examples and a syntax in the .ini file.
  • A new prefix, color or name can be added on a new line in the respective section.
  • When adding something, you can choose if you want to add it on a certain flag, name, IP address, etc.
  • In the list down below you will find all types of data that can be used when adding an extra.
    • flag -- adds the extra if the player has all of the flags specified in the "info" argument
    • anyflag -- adds the extra if the player has at least one of the flags specified in the "info" argument
    • name -- adds the extra if the player's name is equal to the one specified in the "info" argument
    • ip -- adds the extra if the player's IP address is equal to the one specified in the "info" argument
    • steam -- adds the extra if the player's SteamID is equal to the one specified in the "info" argument
    • noprefix -- adds the extra if the player doesn't have a prefix
  • For example, if you write "flag" "mnop" "[VIP]", players with flags "mnop" will receive the prefix [VIP].
  • If a player meets the requirements for more than one prefix/color/name, he will get the one that's highest in the list.
  • You can also set an expiration date for the extras by adding the expiration date in the end of the line. For example, if you want to add a prefix for the player named OciXCrom that will expire on 20.09.2019, you need to type "name" "OciXCrom" "[Prefix]" "20.09.2019" on a new line in the [Admin Prefixes] section.

Defining chat formats
  • Formats determine how the chat is going to look. You can set a different chat style for each player in the [User Formats] section, but first you need to define the formats in the [Format Definitions] section. You can use the following placeholders when defining formats:
    • $admin_prefix$ -- the admin prefix set in the [Admin Prefixes] section
    • $dead_prefix$ -- *DEAD* prefix (and the alive one, if set)
    • $team$ -- player's team
    • $name$ -- player's real name
    • $custom_name$ -- player's custom name set in the [Name Customization] section
    • $ip$ -- player's IP address
    • $steam$ -- player's SteamID
    • $userid$ -- player's userid
    • $chat_color$ -- player's chat color set in the [Chat Colors] section
    • $message$ -- the actual message
    • $time$ -- time/date
  • You can also use the following ones, but since they are disabled by default, you need to enable them in the .sma file. To enable a placeholder, you need to remove the "//" from the line that contains #define in the beginning of the file, and recompile the plugin after.
    • $health$ -- player's health
    • $armor$ -- player's armor
    • $frags$ -- player's frags
    • $deaths$ -- player's deaths
    • $city$ -- player's city
    • $country$ -- player's country
    • $country_code$ -- player's country code
    • $continent$ -- player's continent
    • $continent_code$ -- player's continent code

Color codes list
  • &x07 = red
  • &x06 = blue
  • &x05 = grey
  • &x04 = green
  • &x03 = team color
  • &x01 = default

Additional information and download link



__________________

Last edited by OciXCrom; 03-08-2021 at 16:18.
OciXCrom is offline
Send a message via Skype™ to OciXCrom