/mcwrench:audit
Lints a server's config tree for footguns, performance, and security; reports critical to low.
Seed it: node skills/audit-config/scripts/scan-server-tree.mjs ./myserver
// documentation
Usage guide
How mcwrench works, and how to use every command with examples. mcwrench is a Minecraft server config and operations assistant: it reads and advises, quotes real config keys, prioritises findings, and never invents keys.
How it works
- â–£A router plus specialists. The always-on
minecraft-server-routerengages on any server-admin topic and hands off to the right specialist. - â–£It never invents config keys or versions. If it is not confident about a plugin, it runs
learn-plugin-docsto fetch and condense that plugin's real docs, then answers from them. - â–£Findings are prioritised: critical (crash or data loss), then high (lag or security), then medium, then low.
- â–£Destructive actions are confirmed first (deleting worlds, exposing RCON, flipping online-mode behind a proxy).
- â–£Current facts (2026): Minecraft 26.1.x, Paper 26.1+ needs Java 25, Velocity 3.5.0-SNAPSHOT, Paper downloads via Fill v3.
Two ways to invoke, per tool
| Tool | Slash commands | Natural language |
|---|---|---|
| Claude Code | /mcwrench:* | yes |
| Gemini CLI | /mcwrench:* | yes |
| Google Antigravity | /audit, /perf, ... | yes |
| Claude.ai | none | yes, just describe it |
| OpenAI Codex | $skill-name | yes |
On tools without slash commands, just say what you want: "audit my paper config" or "my SMP is laggy, low TPS".
Commands
Each command maps to a skill. The slash form is for Claude Code; the same intent works as plain language everywhere.
/mcwrench:learn
Fetches and condenses a plugin's real docs into skills/_cache/<slug>/REFERENCE.md, then summarises its keys, permissions, and commands.
/mcwrench:perf
Diagnoses lag with Spark first, then tunes heap, JVM flags, and config (view and sim distance, entity limits, hoppers, chunks).
/mcwrench:perms
LuckPerms groups, tracks, contexts, prefixes, and the exact /lp commands.
/mcwrench:proxy
Sets up or troubleshoots Velocity and Bungee modern forwarding and the forwarding.secret handshake.
/mcwrench:bootstrap
Stands up a new Paper (optionally plus Velocity) server: download, Java 25, EULA, startup flags, starter config.
/mcwrench:panel
Pterodactyl and Pelican ops: RCON (secondary allocation), the AlwaysPreTouch and Xmx OOM footgun, non-atomic backups, the client API.
/mcwrench:gamemode
Canonical plugin stack, config touchpoints, and pitfalls for 11 archetypes.
/mcwrench:skript
Writes and debugs Skript with reload-safety, and live syntax from the Skript Hub API.
The docs learner
It routes each plugin to the cheapest authoritative source and caches a condensed reference.
| Source | What |
|---|---|
| Modrinth / Hangar | Official REST APIs, markdown body |
| GitHub README | Raw markdown from the repo |
| Oraxen | Content negotiation and bulk docs API |
| SpigotMC | Resource API, BBCode to markdown |
| Skript Hub | Syntax API, filtered by addon |
| PaperMC | Tree-searches the PaperMC/docs source |
| GitBook / unknown | .md then llms-full.txt then Readability |
Output lands in skills/_cache/<slug>/REFERENCE.md (condensed, with source URL and fetch date) and RAW.md (full). The cache is git-ignored and reused for 7 days.
Script reference
| Script | Does |
|---|---|
| learn-plugin-docs/.../learn-docs.mjs "<name|url>" | Fetch and condense plugin docs |
| new-server-bootstrap/.../fetch-paper.mjs <mcver> | Resolve latest Paper via Fill v3 |
| skript-author/.../fetch-skripthub.mjs --addon X | Pull Skript syntax |
| audit-config/.../scan-server-tree.mjs <root> | Manifest a server tree |
| audit-config/.../diff-against-defaults.mjs a b | Show overridden keys |
| scripts/validate.mjs [--strict] | Validate repo structure |
| scripts/pack-skill.mjs --all | Zip a skill for Claude.ai |
Tips
- â–¸Tell it your version and software. "Paper 26.1.2 on Pterodactyl, 8 GB" beats "my server".
- â–¸Share a Spark report URL for lag questions; it is the evidence the advice is built on.
- â–¸For an unfamiliar plugin, ask anyway. It learns the docs before answering, so it will not guess.
- â–¸It refuses known footguns: mixing G1 and ZGC flags, two claims plugins, two skyblock engines.