# ServerPatch <\/p>\n
A plugin updater for PaperMC servers, designed for stability, security, and determinism. It checks your installed plugins for updates, creates an encrypted snapshot, and executes updates with zero background usage when idle.<\/p>\n
## Key Features <\/p>\n
### \ud83d\udd12 Snapshot Update System
\nUpdates are now **deterministic**.
\n1. **Check**: `\/serverpatch check` scans plugins and saves an **encrypted snapshot** of the update plan. No files are downloaded yet.
\n2. **Verify**: You can review pending updates with `\/serverpatch snapshot-status`.
\n3. **Run**: `\/serverpatch run` executes the snapshot exactly as planned. If the server environment changes (e.g., you switch from Paper to Spigot), the snapshot is invalidated for safety.<\/p>\n
### \ud83d\udee1\ufe0f Enhanced Security & Stability
\n– **Strict Loader Matching**: Enforces compatibility. Paper servers will reject plugins marked only for Spigot unless explicitly allowed.
\n– **Hash Verification**: Verifies SHA-256 hashes against remote sources (Modrinth) to prevent tampering and incomplete downloads.
\n– **Duplicate Prevention**: Automatically detects and prevents duplicate jars (e.g., `Plugin-1.0.jar` vs `Plugin.jar`) after updates.
\n– **Zero Idle Usage**: No background threads or tasks run when the plugin is idle.<\/p>\n
### \ud83d\udce6 Modrinth & Hangar Support
\n– **Deep Integration**: Fetches detailed metadata, including load compatibility and stability.
\n– **Smart Fallback**: Prioritizes Modrinth\/Hangar, falling back to SpigotMC only for free resources if needed.<\/p>\n
## Installation<\/p>\n
Drop `ServerPatch-1.1.0.jar` into your `plugins\/` folder and restart the server.<\/p>\n
**Requirements**:
\n– PaperMC 1.20+ (or forks like Purpur)
\n– Java 17+<\/p>\n
## Commands<\/p>\n
All commands require the `serverpatch.admin` permission.<\/p>\n
### Check for updates
\n“`
\n\/serverpatch check
\n“`
\nScans all plugins, resolves updates, and **saves a snapshot**. Does NOT download or modify files.<\/p>\n
### View Snapshot Status
\n“`
\n\/serverpatch snapshot-status
\n“`
\nShows the pending updates stored in the current snapshot, including versions and target files.<\/p>\n
### Apply updates
\n“`
\n\/serverpatch run
\n“`
\nLoads the secure snapshot, verifies integrity, downloads the updates, and replaces the plugin JARs. **A server restart is required to load new versions.**<\/p>\n
### Mute restart warnings
\n“`
\n\/serverpatch silent
\n“`
\nMutes the generic “Restart Required” broadcast that appears after updates are applied.<\/p>\n
### Restore from backup ## Configuration (`config.yml`)<\/p>\n | Setting | Default | Description | ## Permissions<\/p>\n | Permission | Default | Description | ## Author ServerPatch is a plugin that manually checks and updates other plugins from Modrinth, Hangar, and SpigotMC.<\/p>\n","protected":false},"featured_media":137610,"template":"","meta":{"_minecraft_slug":"serverpatch","_minecraft_project_id":"odapE4VV","_minecraft_author":"Shiraken12T","_minecraft_license":"MIT","_minecraft_downloads":30,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"serverpatch.zip","_minecraft_size_bytes":312451,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:09:45.387849Z","_minecraft_date_created":"2026-02-11T02:21:05.075702Z","_minecraft_date_modified":"2026-05-08T19:42:43.213257Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/serverpatch","_minecraft_icon_attachment_id":137610,"_minecraft_imported_at":"2026-06-08T03:18:32+00:00","_minecraft_import_hash":"0bfea1f1daa9afb7a7e87787bacd3b46","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-137609","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","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“`
\n\/serverpatch backup restore
\n“`
\nStages a restore from a timestamped backup folder (tab-complete available).
\nConfirm with `\/serverpatch backup confirm`.<\/p>\n
\n|—|—|—|
\n| `mode` | `CHECK_ONLY` | `CHECK_ONLY`, `DOWNLOAD_ONLY`, or `AUTO_UPDATE` |
\n| `sources.modrinth` | `true` | Enable Modrinth source |
\n| `sources.hangar` | `true` | Enable Hangar source |
\n| `compatibility.allowSpigotOnPaper` | `false` | If true, allows Spigot-only plugins on Paper |
\n| `security.verifyChecksum` | `true` | Enforce hash verification |
\n| `network.timeoutSeconds` | `30` | Connection timeout for update checks |<\/p>\n
\n|—|—|—|
\n| `serverpatch.admin` | OP | Access to all ServerPatch commands |<\/p>\n
\nMade by Shiraken12T<\/p>\n","protected":false},"excerpt":{"rendered":"