---
title: "Commands"
description: "Every Asphyxia server console command, with arguments and examples."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.asphyxia.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands

Every command lives under a single `asphyxia` command, and every one is
**console-only** — typing them in-game does nothing. In-game moderation goes
through the [admin menu](/anticheat/admin-menu), which checks each admin's
individual permissions.

Run `asphyxia help` to print the full list with arguments.

## Moderation

### `asphyxia ban <playerId> [reason]`

Permanently bans a connected player. Prints the new Ban ID.

```bash
asphyxia ban 12 Aimbot
asphyxia ban 12 Repeatedly ramming other players
```

The reason can contain spaces without quoting. If the player is
[whitelisted](/anticheat/whitelisting) or is an admin with `bypassDetections`,
nothing happens and the console tells you why.

### `asphyxia unban <banId> [reason]`

Lifts a ban. Ban IDs come from the ban card the player saw, the
[Bans page](/website/bans), or `asphyxia bans`.

```bash
asphyxia unban A1B2-C3D4 Appealed successfully
```

The record isn't deleted — it stays in the player's history marked as lifted.

### `asphyxia unbanall [code]`

Lifts **every** active ban on your server. Because there's no undo, it takes
two steps.

Run it with no arguments and Asphyxia tells you how many bans it would lift and
gives you a one-time code:

```text
────────────────────────────────────────────────────────────
 This will lift ALL 342 active ban(s) on this server.
 Ban records are kept for history, but every banned player will
 be able to reconnect immediately. This cannot be undone.

 To go ahead, run:  asphyxia unbanall K4M2XQ
 This expires in 60 seconds. Do nothing to cancel.
────────────────────────────────────────────────────────────
```

Type the command back with the code to go through with it. Do nothing and it
expires.

```bash
asphyxia unbanall K4M2XQ
```

### `asphyxia strike <playerId> <severity> [reason]`

Issues a strike. Severity is `low`, `medium` or `high` — see
[Strikes](/anticheat/strikes).

```bash
asphyxia strike 12 high Suspected aimbot
```

## Whitelists

### `asphyxia whitelist <playerId> <detection> [minutes]`

Exempts a player from a detection. Omit the duration and it lasts until the
resource restarts. Use `*` to exempt them from everything.

```bash
asphyxia whitelist 12 "No-Clip Detected" 30
asphyxia whitelist 12 *
```

### `asphyxia unwhitelist <playerId> [detection]`

Removes an exemption. Omit the detection to clear all of them.

```bash
asphyxia unwhitelist 12 "No-Clip Detected"
asphyxia unwhitelist 12
```

### `asphyxia whitelists`

Lists every active exemption with its remaining time.

```text
PLAYER                 DETECTION                  EXPIRES IN     GRANTED BY
────────────────────────────────────────────────────────────
Developer              No-Clip Detected           28 min         Console
Tester                 (all detections)           on restart     Admin
```

## Inspecting

### `asphyxia players`

Lists everyone connected, with their ID, risk score and license.

```text
ID     NAME                     RISK   LICENSE
────────────────────────────────────────────────────────────
12     Playername               15     abc123def456…
```

The **ID** column is what every other command takes.

### `asphyxia bans [limit]`

Shows the most recent active bans. Defaults to 20, maximum 100.

```bash
asphyxia bans 50
```

### `asphyxia status`

A summary of Asphyxia's current state — version, whether the config loaded,
whether the integrity check is passing, debug mode, and current counts. This is
the first thing to run when something seems wrong.

```text
ASPHYXIA STATUS
────────────────────────────────────────────────────────────
  Version           : 1.0.0
  Config loaded     : yes
  Integrity check   : passing
  Debug mode        : off
  Players online    : 12
  Local bans        : 34
  Global bans       : 1892
  Admins            : 4
  Active whitelists : 0
────────────────────────────────────────────────────────────
```

## Maintenance

### `asphyxia reload`

Re-reads your admin list and re-downloads the global banlist, without a
restart. Use it after adding an admin on the dashboard when you don't want to
restart the resource.

> **Note**
>
> `reload` doesn't re-download your detection configuration — that's read once at
> startup. After changing settings on the
> [Configuration page](/website/configuration), restart the resource.

### `asphyxia help`

Prints every command with its arguments and a description.

Source: https://docs.asphyxia.dev/anticheat/commands/index.mdx