BanSystemUltra 1.5.0

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 Chat and Console:
ban <steamid> <time> <reason> → Temporary ban
ban <steamid> <reason> → Permanent ban

Examples:
Console and Chat Commands:
ban 76561198200022991 30d24h60m "Bug Abusing"
ban 76561198200022991 "Cheating"

Check Ban Stats:
Chat and Console:
banstats <steamid>
- Sends the player’s ban statistics to your configured Discord webhook.

Warn Commands:
warn <steamid> <reason>

Example:
warn 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 Mesages to DiscordWeebhook? Requieres DiscordApi plugin!": true,
  "Configuration for Discord Weebhook Url!": "",
  "Ban the player during the connection if his banned IP is detected in the data? (It will search all the data if there is any banned IP like the player's)": true,
  "Use messages in Embed? (false = normal / true = Embed)": true,
  "Ban player team if the player gets permanent ban? (Bans full team permanently aswell)": true,
  "Use permanent bans via warnings?": true,
  "Number of maximum warns after permanent ban": 10,
  "Use temporary bans via warnings?": true,
  "Ban duration after X warnings (Warnings - ban days (in days))": {
    "2": 1,
    "6": 7,
    "8": 14
  },
  "Discord weebhook url to send banstats": "",
  "Send messages to chat about: Warns, bans and unbans?": true,
  "Config Version (DON'T MODIFY)": "1.5.0"
}