---
title: "Bans"
description: "Review every ban on your server, see the screenshot, and lift the ones that were wrong."
---

> 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.

# Bans

Every ban Asphyxia has issued on your server, whether it came from a detection,
an admin, the console, or one of your own scripts.

## The table

| Column | Meaning |
| :--- | :--- |
| Ban ID | The code the player was shown — how they'll refer to it |
| Player | Their name at the time |
| Reason | What they were banned for |
| Banned by | Asphyxia, an admin, or a resource |
| Date | When it happened |
| Status | Active, or lifted |

Search matches names, reasons and Ban IDs — so when a player appeals with just
their Ban ID, you can find it immediately.

**Hide unbanned** filters to bans still in force.

## Screenshots

If you've set a [ban webhook](/anticheat/server-config), Asphyxia captures the
player's screen at the moment of the ban and attaches it here. It's usually the
quickest way to confirm a ban was correct — a cheat menu on screen ends the
argument.

Screenshots are best-effort. A player whose client dies instantly won't produce
one, and the ban stands regardless.

## Lifting a ban

Open the ban and lift it, optionally with a reason.

The record isn't deleted — it stays here marked as lifted, along with who
lifted it and why. Ban history is worth keeping: "banned once, appealed
successfully" is different from "never banned", and you should be able to tell
them apart six months later.

From the console:

```bash
asphyxia unban A1B2-C3D4 Appeal accepted
```

Admins can lift bans in-game with the `unbanPlayers` permission.

## Lifting everything

There's no button for this on purpose. If you genuinely need to clear every
ban — a fresh start, or recovering from a misconfiguration that banned half
your playerbase — use the console:

```bash
asphyxia unbanall
```

It asks for confirmation with a one-time code before doing anything. See
[Commands](/anticheat/commands).

## Bans are permanent

Asphyxia has no temporary bans. A ban lasts until someone lifts it.

This is deliberate: the detections that ban outright are the ones with no
innocent explanation, and a timed ban on those just means the cheater comes
back later. Behaviour that *might* be innocent produces
[strikes](/anticheat/strikes) instead.

## Global bans

Bans here are yours. Ones promoted to the network-wide list are on
[Global Banlist](/website/global-bans).

Source: https://docs.asphyxia.dev/website/bans/index.mdx