Rust Plugin
TicketToolLink connects your Rust 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, their playtime, and any active ban from the server's ban list. It is a single-file plugin for Oxide (uMod) and Carbon.
Community and Pro
Game server plugins are included with Community and Pro, the same as lookups and ban lookup. Game Server Plugins compares the five official plugins.
Requirements
- Server: a Rust dedicated server running Oxide (uMod) or Carbon.
- 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-rust-<version>.cs from the Rust 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 Rust 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
Rename TicketToolLink-rust-<version>.cs to TicketToolLink.cs and put it in oxide/plugins (Oxide) or carbon/plugins (Carbon). The plugin loads on its own and creates its config file: oxide/config/TicketToolLink.json or carbon/configs/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 ticketlink reload. Within a few seconds the key shows Connected now on the Connections page, and 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 Rust in the Lookups card, tick Rust server in the Ban lookup card, or both.
Commands
| Command | Permission | What it does |
|---|---|---|
ticketlink status | tickettoollink.admin | Shows the connection state, key id, Discord server and ban source |
ticketlink reload | tickettoollink.admin | Re-reads the config and reconnects |
Both work from the server console. To let a player run them in game, grant tickettoollink.admin with your permissions plugin.
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 their playtime.
- Ban lookup card: a Rust server row with the reason, date, expiry and moderator from the server's own ban list. Steam's VAC and game bans are a separate Ban Lookup source.
- Variables:
{rust.linked},{rust.name},{rust.steam_id},{rust.url},{rust.online},{rust.last_seen},{rust.first_seen},{rust.server}and{rust.details}, plus{bans.rust.banned},{bans.rust.reason}and the otherbans.rustfields. 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.
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 Rust lookups show as unavailable. To build a plugin of your own, see the Game Plugin Protocol.