RCON Commands

Citadel provides a built-in RCON console for sending raw BattlEye RCON commands to your DayZ server.

Using the Console

Dashboard

Navigate to a server and open the RCON Console tab. Type commands directly and see output in real-time.

API

POST /api/servers/:id/rcon
{
  "command": "say -1 Hello everyone!"
}

Common Commands

Command	Description
`say -1 <message>`	Broadcast message to all players
`say <player#> <message>`	Send private message to a player
`kick <player#> <reason>`	Kick a player
`ban <player#> <minutes> <reason>`	Ban a player (`-1` for permanent)
`players`	List connected players
`bans`	List active bans
`removeBan <ban#>`	Remove a ban
`lock`	Lock the server
`unlock`	Unlock the server
`shutdown`	Graceful server shutdown
`#restart`	Restart the server
`reassign`	Force all clients to reconnect
`loadBans`	Reload bans from file
`writeBans`	Write bans to file
`maxPing <ms>`	Set maximum allowed ping

RCON vs Provider Actions

RCON commands are low-level BattlEye protocol operations. For advanced actions like teleporting, healing, or spawning items, use the Provider System (InHouseProvider) which routes through the Sidecar and DayZ mod.

Feature	RCON	InHouseProvider
Kick/ban	✅	✅
Messages	✅	✅
Lock/unlock	✅	✅
Teleport	❌	✅
Heal/kill	❌	✅
Spawn items	❌	✅
Vehicle control	❌	✅
Weather/time	❌	✅

Ban Management

Citadel uses a global ban database rather than per-server bans. When you ban a player through the dashboard or API:

The ban is recorded in data/bans.json with a unique UUID
The player is immediately kicked via RCON with a configurable ban message
The player's Steam ID is written to the server's ban.txt file
On server start/restart, all global bans are synced to the server's ban.txt

Bans can be exported as JSON and shared with other server owners for cross-community ban lists. Import shared ban lists via the Bans page or the /api/bans/import endpoint.

Ban Kick Message

When a player is banned, they see a configurable kick message. Configure it in Settings → Ban Settings or via environment variables:

Setting	Env Variable	Default
Kick Message	`BAN_KICK_MESSAGE`	`You have been banned. Reason: {reason}. To appeal, visit our Discord.`
Appeal URL	`BAN_APPEAL_URL`	(empty)

Supported placeholders:

{reason} — The admin-provided ban reason
{banId} — The UUID ban ID (useful for appeals)

If BAN_APPEAL_URL is set (e.g. https://discord.gg/your-server), it automatically replaces "our Discord" in the default message.

[!TIP]

Edit this page on GitHub