mcwrench, configure and tune any Minecraft server

Your AI Minecraft server administrator.

v1.0.0 · MIT · open source mcwrench Configure and tune any Minecraft server

Your AI assistant becomes an expert Minecraft server administrator. It audits configs, kills lag, wires proxies and permissions, picks plugin stacks, bootstraps servers, and learns any plugin's docs on demand. Any server type, any plugin, any panel.

Install it Read the docs Star on GitHub
Claude Code Claude.ai OpenAI Codex Google Antigravity Gemini CLI
10
specialist skills
5
AI runtimes
8
doc sources
11
gamemode stacks

// why mcwrench

Server admin is config archaeology. This is the map.

YAML footguns, JVM flags, proxy handshakes, permission nodes, and a thousand plugins that each document themselves differently. mcwrench knows the patterns and looks up the rest.

Without it

  • ✕ Ten browser tabs of wikis and Discord pins
  • ✕ Copy-pasted flags that OOM your container
  • ✕ online-mode and forwarding mismatches that break joins
  • ✕ AI that invents config keys that do not exist

With mcwrench

  • ✓ One assistant that routes to the right specialist
  • ✓ Flags and limits tuned to your version and host
  • ✓ Cross-file checks that catch the real footguns
  • ✓ Real keys only, fetched from the plugin's own docs

// the toolbox

Ten skills, one router.

An always-on router engages on any server-admin topic and hands off to the right specialist. You just describe the problem.

🧭

minecraft-server-router

Always-on hub. Engages on any topic and routes to a specialist.

🔍

audit-config

Lints a config tree for footguns, performance and security.

⚡

performance-tuning

TPS, MSPT, OOM, Spark profiling, Aikar's flags, view and sim distance.

🔐

permissions-helper

LuckPerms groups, tracks, contexts, meta and node conventions.

🌐

proxy-network

Velocity and Bungee modern forwarding, and the forwarding.secret handshake.

🎮

gamemode-stacks

Canonical plugin stacks for 11 archetypes, with pitfalls.

🚀

new-server-bootstrap

Fill v3 Paper download, Java 25, EULA, Aikar startup, starter configs.

🪺

pterodactyl-ops

Pterodactyl and Pelican: RCON, the Xmx and OOM footgun, backups, client API.

📜

skript-author

Write and debug Skript with live syntax from the Skript Hub API.

📚

learn-plugin-docs

Fetches and condenses ANY plugin's real docs into a local reference, so answers cite sources and never guess.

// see it work

You ask in plain words. It answers with real keys.

A prioritised audit, the way mcwrench reports it. Critical first, with the exact file and key to change.

audit-config

you ▸ audit my paper config, it is behind velocity

CRIT spigot.yml bungeecord:true + paper-global velocity.enabled:true will not start. Pick one.

HIGH server.properties online-mode=true behind a proxy breaks UUIDs and skins. Set false.

HIGH paper-global.yml proxies.velocity.secret is empty. Paste the proxy forwarding.secret.

MED server.properties simulation-distance=10. 6 is plenty for your player count.

▸ 1 critical, 2 high, 1 medium. Fix the critical first; it blocks boot.

It never guesses

Unsure about a plugin? It runs learn-plugin-docs and reads the real docs before answering.

It is careful

Deleting worlds, exposing RCON, flipping online-mode: it warns and confirms first.

// learns from

Modrinth Hangar GitHub Oraxen SpigotMC Skript Hub PaperMC GitBook

// how it works

Trigger, route, learn, advise.

01

Trigger

Say "my SMP is laggy" or run /mcwrench:audit.

02

Route

It picks the right specialist and reads its playbook.

03

Learn

Unsure about a plugin? It fetches the real docs to _cache/ first.

04

Advise

Prioritised findings with exact file:key changes.

// install

Pick your runtime.

Skills are filesystem-based and do not sync between tools. Install in each surface you use.

Claude Code plugin + slash

Gemini CLI GEMINI.md + TOML

Codex / Antigravity .agents/skills

Claude.ai zip upload

Full guide: the docs.

// command reference

Nine slash commands.

Shown for Claude Code (/mcwrench:*). The same intent works as plain language everywhere.

CommandDoes
/mcwrench:auditLint a config tree, prioritised critical to low
/mcwrench:learnFetch and condense any plugin's docs
/mcwrench:perfFix lag, low TPS, or OOM (Spark-led)
/mcwrench:permsLuckPerms ranks, contexts, prefixes
/mcwrench:proxyVelocity and Bungee modern forwarding
/mcwrench:bootstrapStand up a new Paper or Velocity server
/mcwrench:panelPterodactyl and Pelican RCON, OOM, backups
/mcwrench:gamemodeCanonical plugin stack for an archetype
/mcwrench:skriptWrite and debug Skript with live syntax

Every command with examples lives in the docs.

// questions

Good to know.

Does it change my server by itself?+

No. It reads and advises, and gives you exact edits. Anything destructive (deleting worlds, exposing RCON) it warns about and confirms first.

Which AI tools does it work in?+

Claude Code, Claude.ai, OpenAI Codex, Google Antigravity, and Gemini CLI. One source of truth, installed per tool.

Does it support Folia or Bedrock?+

It targets Paper, Purpur, Folia, Vanilla, and Velocity. It defaults to recommending Paper, and engages on Java plus Bedrock via Geyser or Floodgate. Bedrock-only servers are out of scope.

Is it free and open source?+

Yes. MIT licensed. The docs-learner runs on stock Node 18+ with no install for the common paths.

Will it invent config keys?+

No. When it is not confident about a plugin, it fetches that plugin's real documentation first and answers from it, citing the source.

Stop guessing at YAML.

Drop mcwrench into your AI assistant and let it audit, tune, and run your server, with answers that cite real docs.

Get it on GitHub Download v1.0.0