Documentation menu

RCon Copilot

The RCon Copilot turns a plain-English request into a reviewable plan over your server's telemetry — you confirm before anything runs. It's part of the Live Ops Console (a Citadel Cloud feature).

How it works

  1. Type what you want, e.g. "ban everyone with a headshot ratio over 90% and 10+ kills in the last 6 hours".
  2. The copilot returns a plan: how it interpreted you, the matched players (with the metrics they matched on), and the proposed action.
  3. You review the matched list, then confirm. Only then does anything execute.

Nothing runs at the plan stage — it's a dry run.

Safety by design

The copilot never writes raw database queries or commands. It chooses from a constrained set of options (whitelisted data sources, fields, and operators, plus a fixed command list), and Citadel compiles that into a safe, read-only query scoped to your server. Execution goes through the same command path as the manual quick actions, including:

  • A dry run first, always.
  • A mass-action guard — acting on more than a handful of players at once requires an explicit extra confirmation.
  • Destructive actions (kill, ban) are clearly marked.

What you can ask

  • Selection over kill stats (kills, headshot ratio, mean distance) and shot accuracy, within a time window — e.g. "find players with accuracy above 80% in the last 3 hours".
  • Actions on the matched set — kick, ban, kill, heal, message — or a server-wide broadcast.

Availability

The copilot requires an ANTHROPIC_API_KEY to be configured on the instance. If it isn't, the copilot endpoints report disabled and the rest of the console is unaffected.