A customizable chat and scoreboard tag system for Counter-Strike 2 servers with permission-based tags, chat formatting, and persistent player preferences.
- Install CounterStrike Sharp and Metamod:Source
- Download SimpleTags.zip from releases
- Extract and upload to your game server:
csgo/addons/counterstrikesharp/plugins/SimpleTags/ - Start server and configure the generated config file at
csgo/addons/counterstrikesharp/configs/plugins/SimpleTags/
If you want persistent player preferences across server restarts:
- Install PlayerSettingsCS2 (required dependency)
- Install AnyBaseLibCS2 (required for PlayerSettings)
| Parameter | Description | Required |
|---|---|---|
Commands |
List of chat commands players can use to toggle tag display. (Default: ["css_tag", "css_tags"]) |
YES |
CommandPermissions |
Permission flag required to use toggle commands. Leave empty for all players. (Default: "") |
YES |
Tags |
Dictionary of tag configurations for different permission groups, SteamIDs, or "everyone". | YES |
Settings |
General plugin settings including default state and tag display method. | YES |
Each tag in the Tags dictionary supports the following properties:
| Parameter | Description | Required |
|---|---|---|
prefix |
Text displayed before player name in chat messages. Supports color codes. (Default: "") |
YES |
nick_color |
Color code for player name in chat. (Default: "") |
YES |
message_color |
Color code for chat message text. (Default: "") |
YES |
scoreboard |
Tag displayed on scoreboard (clan tag or name prefix). (Default: "") |
YES |
team_chat |
Whether this tag applies to team chat messages. (Default: true) |
YES |
| Parameter | Description | Required |
|---|---|---|
DefaultEnabled |
Whether tags are enabled by default for new players. (Default: true) |
YES |
TagMethod |
How tags are displayed on scoreboard: "ClanTag" or "Rename". (Default: "ClanTag") |
YES |
| Method | Description | Behavior |
|---|---|---|
| ClanTag | Uses CS2's clan tag system | Displays tag in square brackets on scoreboard |
| Rename | Modifies player name | Adds tag as prefix to player name |
For issues, questions, or feature requests, please visit our GitHub Issues page.