Getting Started

• Java 21 or higher
• Paper 1.21.1+ (or Folia)
• XCore (required — install it first)

1. Make sure XCore is installed and running on your server.
2. Download XBans from BuiltByBit.
3. Place the .jar file in /plugins/XCore/addons/.
4. Restart your server — do not use /reload.
5. XBans will automatically connect to the database configured in XCore.
6. Configure settings in /plugins/XCore/addons/XBans/config.yml.

XBans is organized into several major systems:

• Sanctions — Ban, IP ban, IP range ban, mute, IP mute, warn, kick, shadow ban, and reports with templates and silent mode.
• AI Moderation — Bayesian classifier pre-trained in EN, FR, ES, PT, DE. Self-learning from moderator actions. Real-time chat analysis and report classification.
• IP Security — VPN/proxy/Tor blocking, datacenter/hosting blocking, mobile network blocking, ISP blocking, CIDR range blocking, and GeoIP country whitelist/blacklist.
• Client Security — Client brand detection, brand blocking (e.g. Wurst, Meteor), whitelist mode, and protocol version control.
• Alt-Account Detection — 10-factor scoring system: shared IP, client brand, protocol version, country/ISP, login time proximity, name similarity (Levenshtein), fingerprint matching, and sanction history correlation. Risk levels from LOW to CRITICAL with auto-actions.
• Moderation Tools — Freeze, watchlist, staff notes, and Warden (real-time staff notification system).
• GUIs — 13 fully YAML-configurable screens including sanction lists, player browser, player profile, report resolution, duplicate accounts, and notes.
• Integrations — Discord webhooks, Web Dashboard REST API, cross-server sync, and a complete audit log.