ServerPatch

A simple, manual plugin updater for Paper-family servers. Check for updates, review the plan, then apply when you are ready nothing runs in the background.

Features

• Checks Modrinth and Hangar for compatible updates
• Saves an encrypted snapshot so /sp update only applies what you reviewed
• Dry-run mode — simulate updates without downloading or replacing JARs
• Checksum verification and api-version checks before replace
• Backups before every update, with full or per-plugin rollback
• Pin plugins to a max version or ignore plugins you manage manually
• Changelog preview with confirmation for major/breaking updates
• Async network work — stays off the main thread

Quick start

/sp check          # scan plugins and save update plan
/sp status         # review pending updates
/sp update         # apply the plan (confirm if major/breaking)

Restart the server after updating.

Commands

Command	What it does
/sp check [--plugin <name>]	Scan for updates
/sp dryrun	Simulate without changing files
/sp status	Show pending snapshot and metrics
/sp update [confirm]	Apply snapshot
/sp changelog <plugin>	View release notes
/sp pin set/remove/list	Lock max version per plugin
/sp ignore add/remove/list	Skip plugins from checks
/sp rollback <plugin> [confirm]	Restore one plugin from backup
/sp backup restore <folder> [confirm]	Restore a full backup

Alias: /serverpatch — permission: serverpatch.admin (default: OP)

Supported servers

• Paper, Purpur, Spigot, Folia
• Minecraft 1.20.x, 1.21.x, and 26.x (pick the matching JAR)

Notes

• No silent auto-updates — you always run check and update yourself

• SpigotMC is metadata-only when a safe direct download is not available

• Premium or incompatible plugins are skipped instead of guessed

• Made by Sahil Waheed (Shiraken12T)