CFTools

For DayZ servers on CFTools, Citadel applies store grants (priority queue, whitelist) and runs a full-featured admin Discord bot — all driven by the CFTools Data API.

Platform model (grant access, don't share secrets)

Citadel registers one CFTools application. You simply grant Citadel's application access to your server — you never create your own CFTools app or hand over a secret. (This is the same model MGSM uses.)

Connect

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

1. Enter a name and your Server API ID (CFTools App → server → Manage → Settings → API Key → Server ID — not the normal server id).
2. Click Authorize Citadel on CFTools and approve the grant for your server.

That's it on your side. Citadel handles the rest.

Priority queue and whitelist are CFTools premium features — make sure your CFTools plan covers them.

Map perks to CFTools commands

Create perks on the Store page and target your connected server. Supported command types:

| Command | Payload | Effect | |---|---|---| | AddPriorityQueue | { steam64, days?, comment? } | grant priority queue (omit days/-1 = permanent) | | RemovePriorityQueue | { steam64 } | revoke priority queue | | AddWhitelist | { steam64, days?, comment? } | grant whitelist | | RemoveWhitelist | { steam64 } | revoke whitelist |

Add a Steam64 purchase question to your perk and use {{user.steam64}} in the payload so the grant targets the buyer.

The CFTools Discord bot

Connecting a server also gives you a managed CFTools admin bot in your Discord (player lists, kick, broadcast, heal, teleport, stats, and /priority-queue). To run it, Citadel needs your Discord bot token, application id, and guild id — invite the bot with the applications.commands scope.