About BanSystemUltra
BanSystem Ultra
Advanced Ban, Warning, and IP Protection System for Your Server
BanSystem Ultra is a powerful moderation plugin designed to give you complete control over player management.
It allows you to ban players temporarily or permanently by SteamID or IP address, automatically detecting and blocking alternate accounts that share the same IP.
Intelligent Ban System
Automatic IP & SteamID Bans:
When a player is banned, their IP address is automatically added to the ban list.
If another player connects using a banned IP, they will be instantly blocked.
This prevents ban evasion and multiple account abuse.
Multi-IP Detection:
The plugin scans your ban data for repeated IPs.
If multiple accounts share the same banned IP, all of them will be automatically banned — perfect for catching alternate accounts.
Team Ban Option:
If a player receives a permanent ban, you can configure the plugin to also ban their entire team.
Ideal for competitive or clan-based servers where team accountability matters.
Warning System
Manage player behavior with a fully configurable warning system:
- Issue warnings with customizable reasons.
- Automatically ban players temporarily or permanently after reaching a set number of warnings.
- Configure how many warnings trigger a ban and how long the ban should last.
Example:
3 warnings → 1-day ban
6 warnings → 7-day ban
10 warnings → permanent ban
All of this is fully adjustable in the configuration file.
Ban History
Every banned player receives a detailed entry in the Ban History database, including:
- Ban reason
- Ban date and duration
- Total ban count
To clear the ban history, simply delete the file:
oxide/data/BanSystemUltra/BanHistory.json
Commands
Ban Commands:
banplayer <steamid> <time> <reason> → Temporary ban
banplayer <steamid> <reason> → Permanent ban
Examples:
banplayer 76561198200022991 30d24h60m "Bug Abusing"
banplayer 76561198200022991 "Cheating"
Check Ban Stats:
banstats <steamid>
- Sends the player’s ban statistics to your configured Discord webhook.
Warn Commands:
warnplayer <steamid> <reason>
Example:
warnplayer 76561198200022991 "Racism"
- If the player reaches the maximum number of warnings (defined in config), they will be automatically banned with the last warning’s reason.
Example Ban Message:
Connection Rejected – You are banned from this server for 7 days (Reason: Racism)
Default Configuration
{ "Send messages to Discord Webhook? (Requires DiscordAPI plugin)": true, "Discord Webhook URL": "", "Ban players automatically if their IP matches a banned one?": true, "Use embedded messages? (false = normal / true = embed)": true, "Ban entire team on permanent bans?": true, "Use permanent bans via warnings?": true, "Maximum warnings before permanent ban": 10, "Use temporary bans via warnings?": true, "Ban duration by warning count (days)": { "3": 1, "6": 7, "8": 14 }, "Discord webhook for banstats": "" }
