{"id":44838,"date":"2026-06-02T06:35:50","date_gmt":"2026-06-02T03:35:50","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/"},"modified":"2026-06-02T06:35:50","modified_gmt":"2026-06-02T03:35:50","slug":"compatguard","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/","title":{"rendered":"CompatGuard"},"content":{"rendered":"

—<\/p>\n

# CompatGuard<\/p>\n

**The intelligent plugin manager for Paper 1.21.x servers.**<\/p>\n

CompatGuard helps server administrators instantly see which plugins are outdated
\nor incompatible \u2014 with zero configuration required. It auto-detects update
\nsources, estimates compatibility risk, and lets you update plugins with a single
\nclick, right from the game.<\/p>\n

—<\/p>\n

## \u2728 Features<\/p>\n

### \ud83d\udd0d Plugin Compatibility Scanning
\n– Scans every installed plugin’s metadata on startup (or on demand)
\n– Classifies each plugin into five risk levels:
\n – \u2705 **SAFE** \u2014 current api-version, no issues detected
\n – \ud83d\udfe9 **LIKELY SAFE** \u2014 slightly old api-version but stable
\n – \ud83d\udfe1 **REVIEW NEEDED** \u2014 old api-version or missing metadata
\n – \ud83d\udfe0 **HIGH RISK** \u2014 very old api-version, high incompatibility chance
\n – \ud83d\udd34 **FAILED \/ DISABLED** \u2014 plugin failed to load
\n– Configurable scoring rules in `rules.yml`
\n– Detailed per-plugin reports with `\/cg report `<\/p>\n

### \ud83d\udd04 Intelligent Auto-Update Detection
\n– **Zero manual configuration** \u2014 automatically finds update sources:
\n 1. Parses the plugin’s `website` field for a GitHub URL
\n 2. Searches Modrinth by plugin name (fuzzy match)
\n 3. Searches Spiget (SpigotMC) by plugin name
\n 4. Probes common GitHub release filename patterns as a fallback
\n– Manual overrides available via `sources.yml` for niche or private plugins<\/p>\n

### \u2b06\ufe0f Safe In-Game Updates
\n– Clickable `[\u2714 Update Now]` \/ `[\u2718 Skip]` buttons when you join (if updates exist)
\n– Updates are staged in `plugins\/update\/` \u2014 the running server JAR is **never touched**
\n– Applied on the next server restart via Paper’s built-in update mechanism
\n– Clickable `[\u2714 Restart Now]` \/ `[\u2718 Later]` prompt after staging
\n– Backup old JAR to `plugins\/backup\/` before downloading (configurable, on by default)<\/p>\n

### \ud83e\udd16 Auto-Update on Startup
\n– Enable `auto-update: true` to automatically download all available updates on startup
\n– Optional `auto-restart-after-update: true` for fully hands-off update cycles
\n– Configurable delay so async checks complete before downloads begin<\/p>\n

### \ud83d\udd14 Discord Webhook Notifications
\n– Posts a rich embed to your Discord channel when updates are found
\n– Colour-coded: \ud83d\udfe0 orange for updates, \ud83d\udfe2 green for all-clear
\n– Lists each outdated plugin with old \u2192 new version and source type
\n– Configurable per-server name in footer<\/p>\n

### \ud83d\udccb Admin Tools
\n| Command | Description |
\n|———|————-|
\n| `\/cg` | Open paginated GUI or console summary |
\n| `\/cg scan` | Re-scan all plugins immediately |
\n| `\/cg checkupdates` | Check updates (async) and print results |
\n| `\/cg update ` | Download & stage update for a specific plugin |
\n| `\/cg debug ` | Full update status: version, source, URL, JAR path |
\n| `\/cg report [name]` | Server-wide or per-plugin report + JSON export |
\n| `\/cg reload` | Reload all config files |<\/p>\n

### \ud83d\udcc1 Reports
\n– JSON reports saved to `plugins\/CompatGuard\/reports\/`
\n– Includes version, status, score, warnings, and update result per plugin<\/p>\n

—<\/p>\n

## \u2699\ufe0f Configuration Highlights<\/p>\n

“`yaml
\n# Auto-detect sources (GitHub, Modrinth, Spiget) \u2014 no manual setup needed
\nauto-detect-sources: true<\/p>\n

# Plugins to exclude from all checks
\nignore:
\n – SomePrivatePlugin<\/p>\n

# Download updates automatically on startup
\nauto-update: false<\/p>\n

# Notify OPs with clickable update prompts when they join
\nnotify-ops-on-join: true<\/p>\n

# Backup old JAR before staging new version (strongly recommended)
\nbackup-before-update: true<\/p>\n

# Re-scan every N hours automatically (0 = off)
\nauto-scan-interval-hours: 0<\/p>\n

# Discord webhook for update reports
\ndiscord:
\n enabled: false
\n webhook-url: “”
\n server-name: “My Server”
\n“`<\/p>\n

—<\/p>\n

## \ud83d\udee1\ufe0f Safety Guarantees
\n– **Read-only by default** \u2014 no files are touched unless you use the update feature
\n– **HTTPS-only downloads** \u2014 HTTP URLs are refused
\n– **50 MB download cap** \u2014 prevents accidental large file downloads
\n– **Atomic staging** \u2014 files are written to a temp file then renamed, preventing corruption
\n– **Backup before update** \u2014 old JAR saved to `plugins\/backup\/` for easy rollback<\/p>\n

—<\/p>\n

## \ud83d\udccb Requirements
\n– **Paper 1.21.x** (Purpur should work too)
\n– **Java 21+**<\/p>\n

—<\/p>\n

## \ud83e\udd1d Contributing & Support
\n– **Discord:** [https:\/\/discord.com\/invite\/pDPJ92VVv8] <\/p>\n

—<\/p>\n","protected":false},"excerpt":{"rendered":"

Intelligent plugin compatibility auditor & update manager. Auto-detects outdated plugins, estimates risk, and supports one-click in-game updates.<\/p>\n","protected":false},"featured_media":44839,"template":"","meta":{"_minecraft_slug":"compatguard","_minecraft_project_id":"rOHDPWtr","_minecraft_author":"RayAstra","_minecraft_license":"MIT","_minecraft_downloads":8,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"compatguard.zip","_minecraft_size_bytes":86963,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:16:57.491167Z","_minecraft_date_created":"2026-05-03T04:30:56.231801Z","_minecraft_date_modified":"2026-04-25T09:35:00.658160Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/compatguard","_minecraft_icon_attachment_id":44839,"_minecraft_imported_at":"2026-06-02T03:35:50+00:00","_minecraft_import_hash":"98742a0a984afec826c32c8344fb2d41","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,126,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-44838","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-paper","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":"\nCompatGuard - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CompatGuard - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Intelligent plugin compatibility auditor & update manager. Auto-detects outdated plugins, estimates risk, and supports one-click in-game updates.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/\",\"name\":\"CompatGuard - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp\",\"datePublished\":\"2026-06-02T03:35:50+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/compatguard\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"CompatGuard\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CompatGuard - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/","og_locale":"en_US","og_type":"article","og_title":"CompatGuard - Minecraft","og_description":"Intelligent plugin compatibility auditor & update manager. Auto-detects outdated plugins, estimates risk, and supports one-click in-game updates.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/","name":"CompatGuard - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp","datePublished":"2026-06-02T03:35:50+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/compatguard-icon-2866cdbf0d4e133691e7c21b19fc9127f55d440f_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/compatguard\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"CompatGuard"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/44838","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/44839"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=44838"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=44838"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=44838"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=44838"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}