Connect Announce

Simple CounterStrikeSharp plugin that replaces connect/disconnect messages and resolves city/country data with GeoLite2-City.mmdb.

Installation

Copy the complete ConnectAnnounce folder from the release zip to:

csgo/addons/counterstrikesharp/plugins/ConnectAnnounce/

Do not upload only ConnectAnnounce.dll. ConnectAnnounce.deps.json must stay next to the DLL or CounterStrikeSharp cannot resolve the plugin dependencies.

The release zip includes GeoLite2-City.mmdb, so it can be installed directly. To update the database later, download it from one of these links and replace the file in the plugin folder:

• https://git.io/GeoLite2-City.mmdb
• https://github.com/P3TERX/GeoLite.mmdb/raw/download/GeoLite2-City.mmdb

csgo/addons/counterstrikesharp/plugins/ConnectAnnounce/GeoLite2-City.mmdb

Files

• ConnectAnnounce.dll
• ConnectAnnounce.deps.json
• MaxMind.GeoIP2 dependencies
• data/cannounce_settings.txt
• GeoLite2-City.mmdb

The options JSON is generated on load at:

csgo/addons/counterstrikesharp/configs/plugins/ConnectAnnounce/ConnectAnnounceConfig.json

Messages

Default messages live in:

ConnectAnnounce/data/cannounce_settings.txt

Available placeholders:

• {PLAYERNAME}
• {STEAMID}
• {PLAYERCOUNTRY}
• {PLAYERCOUNTRYSHORT}
• {PLAYERCOUNTRYSHORT3}
• {PLAYERCITY}
• {PLAYERREGION}
• {PLAYERIP}
• {PLAYERTYPE}
• {DISC_REASON_LABEL}
• {DISC_REASON}

Colors

Configurable colors are stored in ConnectAnnounceConfig.json:

Admin announcements

ShowEnhancedToAdmins controls how admins are announced. When true and the connecting/disconnecting player is an admin, everyone on the server sees the messages_admin block instead of the normal messages block, so the whole server knows an admin joined or left. Regular players are always announced with messages.

Which players count as "admin" is controlled by AdminFlag in ConnectAnnounceConfig.json (default @css/generic). Set it to whatever flag your admins actually have, e.g. @css/ban. Players with @css/root always count as admin. This flag also drives the {PLAYERTYPE} placeholder.

{
  "AdminFlag": "@css/generic",
  "PlayerNameColor": "Purple",
  "SteamIdColor": "Default",
  "LocationColor": "Green",
  "PlayerIpColor": "Default",
  "PlayerTypeColor": "Default",
  "DisconnectReasonLabelColor": "Green",
  "DisconnectReasonColor": "Green"
}

Valid CSSSharp color names: Default, White, DarkRed, Green, LightYellow, LightBlue, Olive, Lime, Red, LightPurple, Purple, Grey, Yellow, Gold, Silver, Blue, DarkBlue, BlueGrey, Magenta, LightRed, Orange.

Commands

• css_geolist <target>
• css_ca_reload