Skip to main content

CS2 Plugin

TicketToolLink connects your Counter-Strike 2 server to one Discord server. When someone opens a ticket, staff see the player's in-game name, whether they are online and when they were last seen, whether they are an admin on your server, and any active ban from CS2-SimpleAdmin or the server's own ban list.

Community and Pro

Lookups, ban lookup and in-game reports are included with Community and Pro. Staff actions need Pro. Game Server Plugins compares the five official plugins.

Requirements

  • Server: a CS2 dedicated server with CounterStrikeSharp installed (.NET 8).
  • Admin plugin (optional): CS2-SimpleAdmin, for its bans. Only CS2-SimpleAdmin on MySQL or MariaDB is supported.
  • Network: outbound HTTPS to dash.ticket-tool.app. There is no port to open.

How members are matched

Ticket Tool looks up the Steam account the ticket opener linked on their Linked accounts page and shared with your Discord server, and asks the plugin about that SteamID64. There is no in-game linking: members link Steam once, by signing in through Steam or importing it from Discord. If the opener hasn't shared a Steam account with your server, the card says so and the plugin isn't asked.

Download

Download TicketToolLink-cs2-<version>.zip from the CS2 releases page of the open-source ticket-tool-app/integrations repository. Each release has a .sha256 checksum file next to it.

Setup

Create a plugin key

Go to Dashboard → Automations → Connections. Under Game server plugins, click Create a key, pick Counter-Strike 2 and name it after the server. Copy the key: it is only shown once. Create one key for each server you run.

Install the plugin

Unzip the release into the server's game/csgo folder, so you have addons/counterstrikesharp/plugins/TicketToolLink, and start the server once. That creates addons/counterstrikesharp/configs/plugins/TicketToolLink/TicketToolLink.json.

Paste the key

Paste the whole key from the dashboard into the key field:

{
  "key": "ttp_0123456789abcdef.your-key-here",
  "api-url": "https://dash.ticket-tool.app"
}

Run css_ticketlink reload. Within a few seconds the key shows Connected now on the Connections page, and css_ticketlink status says the plugin is connected. The key is never written to the server log.

Turn it on in a category

Edit a category and open Game server tools on the General tab. Switch on Counter-Strike 2 in the Lookups card, tick Counter-Strike 2 in the Ban lookup card, or both.

Commands

CommandPermissionWhat it does
css_ticketlink status@css/rootShows the connection state, key id, Discord server and ban source
css_ticketlink reload@css/rootRe-reads the config and reconnects

Both work from the server console.

What staff see

  • Lookups card: the player's in-game name with a link to their Steam profile, their SteamID64, Online on the server or Offline with the last-seen date, when they first joined, and up to six extra lines from the plugin, such as whether they are an admin.
  • Ban lookup card: a Counter-Strike 2 row with the reason, date, expiry and moderator.
  • Variables: {cs2.linked}, {cs2.name}, {cs2.steam_id}, {cs2.url}, {cs2.online}, {cs2.last_seen}, {cs2.first_seen}, {cs2.server} and {cs2.details}, plus {bans.cs2.banned}, {bans.cs2.reason} and the other bans.cs2 fields. Variables says what each one holds.

If the plugin is offline or slow, the ticket still opens straight away. Staff see the linked Steam account and a note that the plugin didn't answer.

Ban sources

providerBan source
simpleadminCS2-SimpleAdmin bans (MySQL or MariaDB)
serverThe server's own ban list

Steam's own VAC and game bans are a separate Ban Lookup source.

Staff actions and in-game reports

Staff can message, warn, kick or unban a player from Discord, and players can report from in game. Both are off until you turn them on in the plugin's config, and Ticket Tool only offers the actions you turned on. Staff actions need Pro; in-game reports work on Community and Pro. Staff actions and In-game reports explain where staff run them and how a report opens a ticket.

{
  "actions": ["message", "warn", "kick", "unban"],
  "reports": true,
  "report-command": "report",
  "report-cooldown-seconds": 60
}

Run css_ticketlink reload after changing them.

ActionWhat happens in game
messageThe player gets a chat message from the staff member
warnThe player gets a warning in chat and in the middle of the screen
kickThe player is kicked with the reason staff typed
unbanThe ban is lifted where it was found: css_unban for CS2-SimpleAdmin, or removeid and writeid for banned_user.cfg

With reports on, !report [player] <message> sends a report to Ticket Tool. The first word counts as the reported player only when it's the name of someone online, and each player can send one report every report-cooldown-seconds.

Rotating or revoking a key

On the Connections page, Rotate issues a new key for the same entry and stops the old one at once, so put the new key in the plugin's config and reload. Revoke deletes the key, and Counter-Strike 2 lookups show as unavailable. To build a plugin of your own, see the Game Plugin Protocol.