No replies to this topic

[Luciann1009]

 

File Name: Chat Manager [Admin Prefix & Color Chat]

File Submitter: LuciaNnX

File Submitted: 08 May 2020

File Category: Plugins

 

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
• 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%
• 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
• 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

☄ 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

 

Click here to download this file