Citadel Bot (CFTools)
Citadel Bot is the standalone Discord bot for DayZ servers, powered by the CFTools Data API. It gives your staff and community first-class control over your servers straight from Discord — live chat feeds, killfeeds, leaderboards, detailed player stats, and a complete admin/moderation toolkit — and it wires player purchases on a Citadel storefront straight through to in-game CFTools grants.
[!NOTE] built into the Citadel Server Manager. If you're looking for the Server Manager's integrated bot (interactive panels,
DISCORD_BOT_API_KEY), see Discord Bot instead.
Documentation
| Page | What's in it |
|---|---|
| Prerequisites | What you need before you start — Discord app, CFTools app + grant, Server API ID |
| Installation | Self-host (npm), Docker, and Coolify (env-only) |
| Client Configuration | config.js and every .env variable |
| Server Configuration | Every per-server option in servers.js |
| Commands | All 36 commands by category, with permission levels |
| Features | Chat feed, killfeed, watch list, leaderboards, teleport, heatmaps |
| Storefront Relay | Apply CFTools grants from Citadel store purchases |
| Permissions | The six internal permission levels and how to assign them |
| Troubleshooting | Common errors and how to fix them |
Feature highlights
- Live Discord → DayZ chat feed with a customizable role-tag system
- Watch List — role-ping notifications when a watched player logs in
- Delayed Killfeed — buffer kill messages before forwarding to a public channel
- Player lists — public, admin (CFTools + Steam links), and flagged
- Player management — heal, kick, kill, strip, DM, broadcast
- World control — time & weather, spawn items, wipe vehicles/AI, priority queue, shutdown
- Teleport suite — coordinates or named (autocomplete) locations; single, multiple, or all
- Leaderboards — every available stat, plus an automatic recurring leaderboard
- Player statistics — Steam64, BattlEye GUID, Bohemia Interactive Id, with hit-zone heat maps
- Server info overview and an optional HTTP API
- Citadel storefront grants — auto-apply priority queue / whitelist on purchase
Quick start
npm install
cp config/.env.example config/.env
cp config/config.example.js config/config.js
cp config/servers.example.js config/servers.js
# fill in your Discord token, CFTools credentials, and server(s)
npm start
Full walkthrough in Installation. Need a hand? Join the Citadel support server.