Connect a game server

To grant perks in-game, Citadel needs a connection to your server. A connection is a relay — a secure channel your server (or a Citadel-run bot) polls for commands. Both managed integrations connect from the Store page, each with a guided flow that confirms live when your server first checks in.

CFTools (DayZ)

On the Store page, open Game servers (CFTools) → Connect a server:

1. Enter a name and your CFTools Server API ID (CFTools App → your server → Manage → Settings → API Key → Server ID — note this is different from the normal server ID).
2. Click Authorize Citadel on CFTools and approve access for your server.
3. Citadel runs the CFTools bot for your server; your perks can now target it.

Full details: CFTools.

LB Core mod (LBmaster)

On the Store page, open Game servers (LBmaster / LB Core) → Connect a server. The dashboard generates your exact Api.json entry — key included — and listens live until your server's first poll arrives. No ports to open: the mod calls Citadel. Full details: LB Core (LBmaster).

Your own integration

Any server or worker can be a relay client by speaking the Command Relay API (handshake → poll → apply → ack). See the Relay API reference. Custom relays are created under Relays in the dashboard.

How perks reach the server

Each connection has a relay key. When a perk sells, Citadel queues a command on that connection; your relay client polls, applies it, and acknowledges it. Delivery is at-least-once — a command is redelivered until your client confirms it applied, so a paid grant is never silently lost. And because your relay declares its command vocabulary at handshake, the dashboard rejects a perk wired to a command your server doesn't support at save time.