▌ Xbans — Overview
(Price: 20€)
[ Moderation ]
• SteamID bans (perm / timed) with custom join message
→ Shows: reason / expiration / remaining
• Timed bans (
• Unban system + Discord logging
• Kick All command (optional self-exclude)
[ IP & Anti-Evasion ]
• IP-linked bans to prevent evasion
• Detects banned players across known IPs
• Stores IP history per SteamID
[ Alt Detection ]
• Strong Match — same active IP
→ Action: Can be changed*Webhook / Kick / Ban*
• Historical Match — old IP
• Owned IP Change — tracks legit IP moves
• Safe tracking:
[ Controls ]
• Configurable alt actions
• Ignored SteamIDs (admins/shared)
• Reduces false positives on clean joins
[ Discord ]
• Alerts: bans, unbans, joins, alts, IP changes
• Channels:
• Role/user mentions for critical alerts
• Cooldowns (anti-spam)
[ Database ]
• MySQL (clusters, shared data)
• SQLite (single server)
---
▌ Commands (Ingame + RCON)
(Price: 20€)
[ Moderation ]
• SteamID bans (perm / timed) with custom join message
→ Shows: reason / expiration / remaining
• Timed bans (
30m, 2h, 7d) auto-expire• Unban system + Discord logging
• Kick All command (optional self-exclude)
[ IP & Anti-Evasion ]
• IP-linked bans to prevent evasion
• Detects banned players across known IPs
• Stores IP history per SteamID
[ Alt Detection ]
• Strong Match — same active IP
→ Action: Can be changed*Webhook / Kick / Ban*
• Historical Match — old IP
• Owned IP Change — tracks legit IP moves
• Safe tracking:
current / owned / history[ Controls ]
• Configurable alt actions
• Ignored SteamIDs (admins/shared)
• Reduces false positives on clean joins
[ Discord ]
• Alerts: bans, unbans, joins, alts, IP changes
• Channels:
Main / Bans / BannedJoin / Alt• Role/user mentions for critical alerts
• Cooldowns (anti-spam)
[ Database ]
• MySQL (clusters, shared data)
• SQLite (single server)
---
▌ Commands (Ingame + RCON)
xban <id> [reason] → xban 7656... cheatingxtimedban <id> <time> [reason] → 7d abusexunban <id>xkickall → kick all playersxbans.reload → reload config{
"Features": { // Main feature switches. Turn systems off independently without unloading the plugin.
"Bans": true, // true = enforce bans and allow xban/xtimedban/xunban. false = no ban enforcement or ban commands.
"AltAccounts": true // true = track alt ownership/history and send alt alerts. false = disable alt detection logic.
},
"Database": { // Database backend settings.
"MySQL": {
"UseMysql": true, // true = use MySQL. false = use SQLite fallback.
"MysqlHost": "127.0.0.1", // MySQL server IP or hostname.
"MysqlUser": "", // MySQL username.
"MysqlPass": "", // MySQL password.
"MysqlDB": "", // MySQL database name. Required when UseMysql is true.
"MysqlPort": 3306, // MySQL port.
"TablePrefix": "xbans" // Table prefix. Tables are prefix_players, prefix_bans, prefix_alts, prefix_alt_alerts.
},
"SQLite": {
"Path": "" // SQLite fallback file. Empty = ArkApi/Plugins/Xbans/Xbans.db.
}
},
"Messages": { // Player-facing messages.
"Sender": "SERVER", // Sender name used for plugin chat/server messages.
"KickAllMessage": "You have been kicked from the server.\nReason: Server-wide kick.", // Message shown by xkickall.
"AltKickMessage": "You have been kicked from the server.\nReason: Alt Account Detection.", // Message shown for strong alt Kick mode.
"BanMessageTemplate": "You are banned!\nReason: {reason}\nUntil: {until}\nTime Left: {time_left}" // Ban disconnect message. Placeholders: {reason}, {until}, {time_left}.
},
"Bans": { // Ban system defaults.
"DefaultReason": "No Reason" // Default reason used when xban/xtimedban is executed without a reason.
},
"AltDetection": { // Alt account detection behavior.
"WebhookOnly": true, // Strong current-IP match sends webhook only. Kick/Ban below override this.
"Kick": false, // Strong current-IP match kicks the joining account.
"Ban": false, // Strong current-IP match permanently bans the joining account. Highest priority.
"SendCriticalMention": true, // Include CriticalMention when strong/historical match links to an already banned account.
"cd_alerts": 60, // Strong match alert cooldown in minutes. Default 60 = one alert per pair/IP per hour.
"historical_cd_alert": 1440, // Historical and owned-IP-change alert cooldown in minutes. Default 1440 = one per day.
"IgnoredSteamIDs": [ // SteamIDs ignored only by alt detection. Bans still apply normally.
76561198000000000,
76561198000000001
]
},
"DiscordWebhooks": { // Discord webhook routing. Empty specific webhooks fall back to Main.
"Main": "", // Main fallback webhook.
"Bans": "", // Ban/unban events.
"BannedJoin": "", // Banned player join attempts.
"AltAccounts": "", // Strong, historical, and owned-IP-change alt alerts.
"CriticalMention": "<@123456789012345678> or <@&123456789012345678>" // Optional user/role mention for critical alt links.
}
}
"Features": { // Main feature switches. Turn systems off independently without unloading the plugin.
"Bans": true, // true = enforce bans and allow xban/xtimedban/xunban. false = no ban enforcement or ban commands.
"AltAccounts": true // true = track alt ownership/history and send alt alerts. false = disable alt detection logic.
},
"Database": { // Database backend settings.
"MySQL": {
"UseMysql": true, // true = use MySQL. false = use SQLite fallback.
"MysqlHost": "127.0.0.1", // MySQL server IP or hostname.
"MysqlUser": "", // MySQL username.
"MysqlPass": "", // MySQL password.
"MysqlDB": "", // MySQL database name. Required when UseMysql is true.
"MysqlPort": 3306, // MySQL port.
"TablePrefix": "xbans" // Table prefix. Tables are prefix_players, prefix_bans, prefix_alts, prefix_alt_alerts.
},
"SQLite": {
"Path": "" // SQLite fallback file. Empty = ArkApi/Plugins/Xbans/Xbans.db.
}
},
"Messages": { // Player-facing messages.
"Sender": "SERVER", // Sender name used for plugin chat/server messages.
"KickAllMessage": "You have been kicked from the server.\nReason: Server-wide kick.", // Message shown by xkickall.
"AltKickMessage": "You have been kicked from the server.\nReason: Alt Account Detection.", // Message shown for strong alt Kick mode.
"BanMessageTemplate": "You are banned!\nReason: {reason}\nUntil: {until}\nTime Left: {time_left}" // Ban disconnect message. Placeholders: {reason}, {until}, {time_left}.
},
"Bans": { // Ban system defaults.
"DefaultReason": "No Reason" // Default reason used when xban/xtimedban is executed without a reason.
},
"AltDetection": { // Alt account detection behavior.
"WebhookOnly": true, // Strong current-IP match sends webhook only. Kick/Ban below override this.
"Kick": false, // Strong current-IP match kicks the joining account.
"Ban": false, // Strong current-IP match permanently bans the joining account. Highest priority.
"SendCriticalMention": true, // Include CriticalMention when strong/historical match links to an already banned account.
"cd_alerts": 60, // Strong match alert cooldown in minutes. Default 60 = one alert per pair/IP per hour.
"historical_cd_alert": 1440, // Historical and owned-IP-change alert cooldown in minutes. Default 1440 = one per day.
"IgnoredSteamIDs": [ // SteamIDs ignored only by alt detection. Bans still apply normally.
76561198000000000,
76561198000000001
]
},
"DiscordWebhooks": { // Discord webhook routing. Empty specific webhooks fall back to Main.
"Main": "", // Main fallback webhook.
"Bans": "", // Ban/unban events.
"BannedJoin": "", // Banned player join attempts.
"AltAccounts": "", // Strong, historical, and owned-IP-change alt alerts.
"CriticalMention": "<@123456789012345678> or <@&123456789012345678>" // Optional user/role mention for critical alt links.
}
}
