Anti-Cheat & Bans¶
Protect your server from cheaters and manage player bans.
What It Does¶
sbbot provides automated anti-cheat detection and comprehensive ban management. It can automatically detect common cheating methods, ban offenders, and prevent banned players from creating new accounts to return.
Auto-Ban (Cheater Detection)¶
Enable Auto-Ban¶
When enabled, the bot automatically scans server logs for cheating behavior and bans detected cheaters without manual intervention.
How It Works¶
The auto-ban system detects players who stack fireplaces or garden plots within a close radius. This is a common cheating method where players use multiple accounts to stack objects at the same location, giving them an unfair advantage.
Detection parameters
- Checks the last 45 minutes of server logs
- Detects when 3 or more players are within a 1.3 unit radius of each other
- Bans all players involved when stacking is detected
- Bans are applied to both the local ban list and the Nitrado ban list
Ban Twinks¶
Enable Ban Twinks¶
When enabled, banning a player will automatically find and ban all other accounts that share the same device ID. This prevents "twinks" — alternate accounts used by banned players to return to the server.
How it works
Every gaming account has a unique device ID. When ban-twinks is on, the ban command searches for all accounts with the same device ID and bans them all together.
Manual Ban Management¶
Add a Player to the Ban List¶
| Parameter | Required | Description |
|---|---|---|
| gamer_tag | Yes | XBOX or PSN tag of the player |
| ban_days | Yes | Number of days to ban the player |
| reason | No | Reason for the ban |
| ban_twinks | No | If set, also bans all accounts with the same device ID |
This bans Player123 for 7 days with the reason "Stealing", without banning twink accounts.
Remove a Player from the Ban List¶
Unbans the specified player from the local ban list and the Nitrado ban list.
View Active Bans¶
Displays all currently active bans with details including:
- Player name
- Ban expiry date
- Reason
- Who issued the ban
Expired Ban Cleanup¶
Expired bans are automatically removed from both the local list and Nitrado ban list. The cleanup runs periodically and:
- Finds bans past their expiry date
- Verifies the player has no other active bans
- Removes the expired ban from Nitrado
- Handles device-based twink bans
Banned Device Detection¶
The bot scans server logs for device ID information. If a player connects with a banned device ID, they are automatically banned.
This works even if the player uses a different account name — the device ID link catches them.
Related Features¶
- Player Management — Whitelist management