# WardenGuard<\/p>\n
**WardenGuard** is a cross-server ban enforcement plugin that connects your Minecraft server to the centralized WardenGuard ban network. Keep banned players off your server automatically, detect alt accounts, and contribute to a shared ban database with your community.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Ban Enforcement
\n– Checks players against the WardenGuard ban network on every join
\n– 3-tier ban level system – configure which severity triggers an auto-kick
\n– Local ban cache with configurable sync interval (default: every 5 minutes)
\n– Fallback enforcement from cache if the API is temporarily unreachable
\n– Retry queue for failed checks – no join goes unverified<\/p>\n
### Alt Account Detection
\n– Detects linked accounts via exact IP match or \/24 subnet matching
\n– Configurable action: kick or staff-warn only
\n– Set a minimum ban level threshold to filter false positives
\n– Logs all detected alts, even those without active bans<\/p>\n
### Ban Reporting ### Staff Tools —<\/p>\n ## Platform Support<\/p>\n | Platform | Min Version | **Java 17 or newer is required.**<\/p>\n —<\/p>\n ## Soft Dependencies (optional integrations)<\/p>\n – **LiteBans** – auto-reports bans to WardenGuard on issue —<\/p>\n ## Commands and Permissions<\/p>\n | Command | Permission | Description | **Additional permission:** `wardenguard.bypass` – exempt a player from automatic ban enforcement.<\/p>\n —<\/p>\n ## Configuration<\/p>\n WardenGuard is configured via `config.yml`. Key options:<\/p>\n “`yaml All messages are fully customizable. Available placeholders: `{player}`, `{level}`, `{reason}`, `{linked}`, `{url}`, `{count}`.<\/p>\n —<\/p>\n ## Getting Started<\/p>\n 1. Register your server at wardenguard.com to obtain an API key. —<\/p>\n ## Links<\/p>\n – Website: wardenguard.com WardenGuard links your server to a global ban network, blocks banned players automatically, and detects alt accounts on join for Spigot servers.<\/p>\n","protected":false},"featured_media":168566,"template":"","meta":{"_minecraft_slug":"wardenguard","_minecraft_project_id":"2ognM9Px","_minecraft_author":"mexz","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"wardenguard.zip","_minecraft_size_bytes":41804,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:13:51.704293Z","_minecraft_date_created":"2026-05-12T00:24:48.267420Z","_minecraft_date_modified":"2026-05-08T18:48:11.473667Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/wardenguard","_minecraft_icon_attachment_id":168566,"_minecraft_imported_at":"2026-06-09T19:43:45+00:00","_minecraft_import_hash":"7eb5d8d00e7eac2e6e112184c9bba1e3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,867,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-168565","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/wg report
\n– Automatic reporting when a ban is issued via LiteBans, AdvancedBan, or BanManager
\n– Staff receive clickable report links in chat (Spigot\/Paper only)<\/p>\n
\n– `\/wg check
\n– `\/wg scan` – scan all online players against the ban list
\n– `\/wg sync` – force an immediate ban list refresh
\n– `\/wg status` and `\/wg ping` – monitor API connectivity and configuration
\n– Recent player cache: commands work on players who left within the last 30 minutes<\/p>\n
\n|———-|————-|
\n| Spigot \/ Paper | 1.21.4 |<\/p>\n
\n– **AdvancedBan** – auto-reports bans to WardenGuard on issue
\n– **BanManager** – auto-reports bans to WardenGuard on issue<\/p>\n
\n|———|————|————-|
\n| `\/wg report
\n| `\/wg check
\n| `\/wg sync` | `wardenguard.admin` | Force ban list sync |
\n| `\/wg scan` | `wardenguard.admin` | Scan all online players |
\n| `\/wg status` | `wardenguard.admin` | Show API status and config |
\n| `\/wg ping` | `wardenguard.admin` | Test API connectivity |
\n| `\/wg reload` | `wardenguard.admin` | Reload config.yml |<\/p>\n
\nwardenguard:
\n api_key: “your_api_key_here”
\n api_url: “https:\/\/wardenguard.com\/api\/v1”
\n auto_ban_level: 2 # 1, 2, 3, or 0 to disable auto-ban
\n sync_interval_seconds: 300 # how often to pull full ban list (default 5 min)
\n check_on_join: true # check player via API on every join
\n notify_staff_on_ban: true # send report URL to staff chat after ban
\n staff_permission: “wardenguard.staff”
\n alt_detection:
\n enabled: true
\n kick_enabled: true # kick on alt match (false = warn staff only)
\n min_ban_level: 2 # only trigger for linked accounts at this level or higher
\n include_subnet: false # also flag \/24 subnet matches (higher false positive rate)
\n log_all: true # also log alts with no active ban
\n kick_message: “Your account is linked to a banned player ({linked}). Appeal at wardenguard.com\/appeal”
\n warn_staff: “{player} flagged as potential alt of {linked} (Level {level} ban: {reason})”
\n warn_staff_all: “{player} shares an IP with {linked} (no active ban)”
\n messages:
\n banned_message: “You are banned from this network. Appeal at wardenguard.com\/appeal”
\n report_url_message: “Submit your ban report: {url}”
\n not_banned: “{player} is not on the Warden Guard ban list.”
\n is_banned: “{player} is BANNED (Level {level}): {reason}”
\n sync_complete: “Ban list synced. {count} bans loaded.”
\n warn_staff_on_join: “{player} joined with a Level {level} ban: {reason}”
\n warn_staff_on_kick: “{player} tried to join but was blocked – Level {level} ban: {reason}”
\n“`<\/p>\n
\n2. Drop the correct jar for your platform into your `plugins\/` or `mods\/` folder.
\n3. Start the server and add your `api_key` to `plugins\/WardenGuard\/config.yml`.
\n4. Reload with `\/wg reload` or restart the server.<\/p>\n
\n– Ban Feed: wardenguard.com\/feed
\n– Support: wardenguard.com<\/p>\n","protected":false},"excerpt":{"rendered":"