Getting Started

Overview

XBans is a comprehensive moderation addon for XCore that gives server administrators full control over player sanctions, security, and chat moderation. It combines traditional ban/mute/warn/jail management with advanced features like AI-powered chat filtering, VPN/proxy detection, alt-account analysis, and a complete staff toolkit.

Key highlights:

  • Unified sanctions — Ban, mute, warn, report, and jail with temporary or permanent durations
  • IP-level enforcement — IP bans, IP mutes, CIDR range blocking, and ISP blocking
  • AI chat moderation — Bayesian classifier pre-trained for English, French, Spanish, Portuguese, and German
  • Security suite — VPN/proxy blocking, client brand filtering, protocol version control, and 10-factor alt-detection
  • Staff tools — Freeze, watchlist, staff notes, warden notifications, and detailed player profiles
  • Point-and-click moderation — Fully customizable YAML-driven GUI screens, including a categorised /punish menu with sub-menus for sanction durations and reasons
  • Offline sanctions — Ban, mute, or warn players who have never connected; the sanction is enforced the moment they first join
  • Discord integration — Webhook notifications for all sanction events
  • Web dashboard — REST API module for the XCore web panel
  • Cross-server sync — All sanctions sync instantly across your network via XCore

Requirements

  • Paper 1.21.1+ (or Folia)
  • Java 21+
  • XCore 1.0.0+ installed as a plugin
  • Optional: IPInfo API token for VPN/proxy detection
  • Optional: Discord webhook URL for sanction notifications

Installation

  1. Install XCore in your server's plugins/ folder if you haven't already.
  2. Place XBans.jar in plugins/XCore/addons/.
  3. Start the server. XBans generates its configuration files in plugins/XCore/addons/XBans/.
  4. Edit config.yml to configure your moderation preferences, API keys, and feature toggles.
  5. Customize lang.yml to match your server's language and style.
  6. Restart the server or use /xbans reload to apply changes.

XBans creates its database tables automatically on first startup. If you're using MySQL/MariaDB through XCore, all sanctions are stored centrally and can be synced across servers.

Grant yourself xbans.admin to access all features, or assign granular permissions per command for your staff team.

Sanctions