# CS2-Tags

Our fork of [daffyyyy/CS2-Tags](https://github.com/daffyyyy/CS2-Tags): chat prefixes, name/message
colours and scoreboard (clan) tags, assigned by SteamID64, admin group or permission. Built for
CounterStrikeSharp 1.0.375 (net10.0) and meant to run alongside CS2-SimpleAdmin.

## Changes from upstream 1.0.4c

- Targets net10.0 / CSS 1.0.375. Uses System.Text.Json, so Newtonsoft.Json no longer ships with it.
- Config moved to `configs/plugins/CS2-Tags/tags.json`. The default file uses our SimpleAdmin rank
  groups. Comments and trailing commas are allowed. A broken file is logged and the previous
  tags stay in use.
- Scoreboard tags call `SetStateChanged` on `m_szClan` so clients are told about the change.
- Colour tags like `{RED}` are only expanded in the config's strings. Players can no longer colour
  their own chat by typing them.
- An empty `nick_color` means the team colour (like normal chat), not whatever colour the prefix
  ended on.
- A tag with an empty `prefix`, `nick_color` and `message_color` leaves that player's chat alone
  (the game prints it), in both all and team chat. The old `team_chat` key is gone.
- `css_tags_reload` works from the server console and for `@css/root` admins, and reapplies
  scoreboard tags straight away. Hot reload applies tags to players already connected.
- Removed `css_tag_mute`/`css_tag_unmute` and the `@` team-chat admin chat. CS2-SimpleAdmin
  already does both, and its catch-all command listener runs first. CSS always runs those before
  per-command listeners, so gagged players' messages never reach this plugin.

## Configuration

`addons/counterstrikesharp/configs/plugins/CS2-Tags/tags.json`, written with defaults on first load:

```jsonc
{
  "tags": {
    "76561198000000000": { "prefix": "{Magenta}[Dev]", "nick_color": "", "message_color": "", "scoreboard": "[Dev]" },
    "#rank/owner":       { "prefix": "{DarkRed}[Owner]", "nick_color": "{LightRed}", "message_color": "", "scoreboard": "[Owner]" },
    "#rank/admin":       { "prefix": "{Red}[Admin]",     "nick_color": "{LightRed}", "message_color": "", "scoreboard": "[Admin]" },
    "@css/vip":          { "prefix": "{Gold}[VIP]",      "nick_color": "",           "message_color": "", "scoreboard": "[VIP]" },
    "everyone":          { "prefix": "",                 "nick_color": "",           "message_color": "", "scoreboard": "" }
  }
}
```

Each player gets exactly one tag, picked in this order:

1. A SteamID64 key matching the player.
2. The first `#group` or `@permission` key the player matches, **in file order**. Put higher
   ranks first. `@css/root` passes every `@css/...` check, so owners match any permission key.
3. `everyone`, if present.

Fields (all optional, empty means "not set"):

- `prefix` - shown before the name in chat.
- `nick_color` / `message_color` - colour tags; empty means team colour / default.
- `scoreboard` - clan tag on the scoreboard; empty leaves the player's own clan tag.

Colours: any `ChatColors` field name in braces, case-insensitive, e.g. `{Red}`, `{LightBlue}`,
`{Gold}`, `{Grey}`, plus `{TEAMCOLOR}`.

Group membership comes from CS2-SimpleAdmin (`css_addadmin ... -g`, `css_addgroup`, then
`css_reloadadmins`). After changing ranks or `tags.json`, run `css_tags_reload` to reapply
scoreboard tags without waiting for a respawn.

## Commands

- `css_tags_reload` (`@css/root` or server console) - reload `tags.json` and reapply scoreboard tags.

## Building and releasing

```
cd plugins/CS2-Tags && ../../build.sh      # output in compiled/CS2-Tags/
FORGEJO_TOKEN=... ./release.sh v<ModuleVersion>
```

`release.sh` rebuilds from the committed source and publishes `CS2-Tags-<tag>.tar.gz`, laid out
like `game/csgo/`, to https://git.zio.sh/cs2/CS2-Tags. The tag must equal `v<ModuleVersion>`
(`v1.0.4c-zio1` now).