Use when the user wants to check if a PaperMC server can be upgraded to a newer version, and which plugins would break or need updates.
How this skill is triggered — by the user, by Claude, or both
Slash command
/minecraft-papermc-server:paper-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
REQUIRED SUB-SKILL: compat-check
REQUIRED SUB-SKILL: compat-check
Check whether a newer PaperMC version is available and verify all installed plugins have compatible builds for it. Produces a Paper Compatibility Report.
Ask for any of these not already provided:
./minecraft-audits/server-<hostname>-YYYY-MM-DD.mdNo files are written in this section.
SSH into production:
{server-files-path}/version_history.json — extract current MC version and Paper build number{server-files-path}/plugins/*.jar — build installed plugin listplugin.yml inside the JAR:
ssh <alias> "unzip -p {server-files-path}/plugins/<plugin>.jar plugin.yml 2>/dev/null | grep '^version:'"
GET https://api.papermc.io/v2/projects/paper/versions/
Compare against current version.
## Paper decisions: no update available to decision doc, offer to skip to meta-refreshFor the selected target version:
GET https://api.papermc.io/v2/projects/paper/versions/{target}/builds — read commit messages from builds between current and target../compat-check/SKILL.md) against every installed plugin for the target MC version✗ none as BLOCKERRead ./paper-compat-report-format.md for exact output format.
Present to user. Then:
Files are written only after the user responds to the compatibility report.
Append to decision doc:
## Paper decisions
| Decision | Value |
|----------|-------|
| Target version | {target} or {current} (staying) |
| Reason | ALL CLEAR / {N} blockers |
| Blockers | {list or none} |
After writing the decision doc, say:
Paper check complete. Decision doc updated.
- Proceed — continue to meta-refresh
- Cancel — stop here
If PaperMC API is unreachable or returns unexpected responses, invoke superpowers:systematic-debugging.
., compare each segment as integers: 1.21.11 > 1.21.2 because 11 > 2)plugin.yml inside JARs when filename doesn't contain version infonpx claudepluginhub disqt/minecraft-claude-marketplace --plugin minecraft-papermc-serverProvides expert guidance on Bukkit, Spigot, and Paper plugin development including NMS internals, performance optimization, and ecosystem integration.
Discovers MCP servers from Claude Code configs, detects dependencies, updates packages using best practices. Run after fresh installs, connection errors, or periodically.
Checks for skills-for-fabric marketplace updates at session start, compares local version against GitHub releases, and shows changelog if updates are available.