// documentation
Commands
The nineteen mcwrench commands, how to invoke them across five runtimes, and a realistic example for each.
Two ways to invoke
Every command maps to a skill. You can fire it explicitly with a slash command, or just describe the task in plain language. The router skill engages on any server-admin topic and hands off to the right specialist, so natural phrasing like audit my paper config or my SMP is laggy works everywhere, on every runtime.
| Runtime | Slash form | Natural language |
|---|---|---|
| Claude Code | /mcwrench:<cmd> | Yes, just describe the task |
| Gemini CLI | /mcwrench:<cmd> | Yes |
| Google Antigravity | /<workflow> (e.g. /audit, /perf) | Yes |
| Claude.ai | None (no custom slash commands) | Yes, just describe the task |
| OpenAI Codex | $skill-name (e.g. $audit-config) | Yes |
The nineteen commands
Each card shows the slash form for Claude Code, what the command does, and a realistic example. Several commands also drive a node helper script, shown where relevant. The same intent works as plain language on every runtime.
/mcwrench:audit
Audit a server config tree for performance, security, and footgun issues, reporting findings as a prioritised list from critical to low with the exact file and key quoted for each.
/mcwrench:learn
Fetch and condense any plugin's real documentation into a local markdown reference, then summarise its config keys, permission nodes, and commands. Never invents keys.
/mcwrench:perf
Diagnose and fix lag, low TPS, high MSPT, GC pauses, or OOM. Measures first with Spark, then tunes heap, JVM flags, and config, tying every recommendation to evidence.
/mcwrench:perms
Set up or troubleshoot LuckPerms groups, tracks, contexts, and prefixes. Establishes the rank ladder first, then gives the exact /lp commands to run, in order.
/mcwrench:proxy
Set up or troubleshoot a Velocity or BungeeCord network and modern forwarding. Walks the 5-point modern-forwarding contract and maps each symptom to its cause with exact config changes.
/mcwrench:bootstrap
Bootstrap a brand-new Paper server, optionally with a Velocity proxy. Downloads Paper via the Fill v3 API, installs Java 25, accepts the EULA, and applies the Java-25 plus Aikar's-flags startup template.
/mcwrench:panel
Pterodactyl and Pelican panel ops: RCON on a secondary allocation, the AlwaysPreTouch and Xmx container-OOM footgun, non-atomic backups, and the client API. Confirms before any destructive action.
/mcwrench:gamemode
Recommend the canonical plugin stack for a gamemode or archetype, with its core and supporting plugins, config touchpoints, and common pitfalls, then fetch exact keys with learn-plugin-docs.
/mcwrench:conflicts
Flag clashing plugins, missing dependencies, and proxy or Folia mismatches in a plugin set. Reads the plugins folder, a --list, or the saved profile, and reports critical to low. Conservative by design, so verify a hit with learn-plugin-docs before removing anything.
/mcwrench:diagnose
Read a crash report or latest.log (or a server folder, or pasted text) and get a ranked root cause. Names the likely culprit plugin namespace and a fix per finding: Java/class-version, OOM, Watchdog overload, ticking-entity crashes, port-bind, EULA, plugin load/dependency. Read-only.
/mcwrench:health
A graded scorecard for a server folder, composing the scanners (scan-server-tree, check-conflicts, check-plugin-versions, parse-log) into security, performance, durability, and currency grades.
/mcwrench:upgrade
Plan a version/Java upgrade (26.1, Java 25). Labels each plugin has-a-build / none / unknown and emits an ordered runbook: back up, bump Java, update plugins, test on a copy, upgrade the world. Read-only.
/mcwrench:brand
Build a server brand kit from a name and vibe: identity, MOTD in both MiniMessage and legacy hex, a themed rank ladder, and optional store, Discord, and in-game copy, each in the format its target parses.
/mcwrench:profile
Show or update mcwrench's per-server profile (software, version, host, RAM, gamemode, proxy, online-mode, plugins, worlds, chat formatter) so later answers stop re-asking known facts.
/mcwrench:create
The foundry. Invent and score original gamemodes (combine archetypes plus one twist), then turn the idea into a local build plan: plugin stack, setup, themed ranks, MOTD, and an audit. Three internal phases (imagine, design, create). Plans only, no live server connectors.
/mcwrench:stack
Pre-pin every plugin's docs for a gamemode's canonical stack in one go, so the whole server type is local.
/mcwrench:format
Convert one string between MiniMessage and legacy color, for a MOTD line, a rank prefix, or a hologram. Lossy for hover and click.
/mcwrench:skript
Write, debug, or explain a Skript script. Frames it as event, conditions, effects, identifies required addons, and fetches live syntax from Skript Hub rather than guessing patterns.
/mcwrench:help
A capability map: the router, all 12 skills, and every command, with a link to the full feature list at mcwrench.teddy.bar. Shown once, not pushy.