Server configuration | Asphyxia Docs

Asphyxia splits its settings in two. A handful of secrets and integrations live in server.cfg, because they’re specific to one machine. Everything about how the anti-cheat behaves lives on your dashboard’s Configuration page, so you can change it without touching a file.

Required

These three come from your dashboard when you create a server. Asphyxia won’t start without all of them.

Convar	Description
`asphyxia_license`	Your license key. Verified with the Asphyxia API at startup.
`asphyxia_server_id`	Identifies which server’s configuration to download.
`asphyxia_shared_secret`	Signs and encrypts everything sent to the Asphyxia API.

server.cfgini

set asphyxia_license       "your-license-key"
set asphyxia_server_id     "your-server-id"
set asphyxia_shared_secret "your-shared-secret"

Optional

Convar	Default	Description
`asphyxia_ban_webhook`	(none)	Discord webhook URL. Ban screenshots are uploaded here.
`asphyxia_discord_bot_token`	(none)	Bot token for Discord Lookup.
`asphyxia_debug`	`false`	Turns on debug mode — see below.

Discord bot token

The dashboard’s Discord Lookup tool asks your game server to look up a Discord account, and your game server needs a bot token to ask Discord. The token stays on your machine — it is never sent to the dashboard or to Asphyxia.

Create an application

Open Discord’s Developer Portal and click New Application. Name it whatever you like.

Add a bot and copy its token

Go to Bot in the sidebar, then Reset Token. Discord shows the token exactly once — copy it now.

Put it in server.cfg

server.cfgini

set asphyxia_discord_bot_token "your-bot-token"

Restart the resource and the lookup tool starts working.

No privileged intents and no server memberships are needed — looking up a public profile works for any Discord account.

Ban webhook

When Asphyxia bans someone it captures their screen and posts the image to a Discord webhook, then attaches the resulting link to the ban record so you can see it later from the dashboard’s Bans page.

server.cfgini

set asphyxia_ban_webhook "https://discord.com/api/webhooks/..."

Without this, bans still work — they just have no screenshot attached.

Debug mode

server.cfgini

set asphyxia_debug "true"

Debug mode lets you trigger detections on a live server without punishing anyone. While it’s on:

Bans are recorded in memory only — nothing is written to the database.
Nobody is disconnected, and no Discord webhooks fire.
Admins with bypassDetections are not exempt, so you can test as yourself.
Extra diagnostic lines appear in the console.