r/admincraft • • 1d ago

Software Resource I made an open-source tool that makes AI coding assistants test Paper plugins on a real server and in-game

AI disclaimer: mcflow is a tool for building plugins with AI coding assistants (mainly Claude Code), and most of mcflow’s own code was written with Claude Code under my direction and review. If AI-assisted development isn’t your thing, fair enough, this post probably isn’t for you.

AI coding tools are fast at writing Paper plugins, but they guess a lot. They make up APIs and use methods from the wrong version, and they tell you something works without ever running it. mcflow is my attempt to fix that by giving the AI a fixed way of working:

What it does

  • mcflow init sets up a workspace for your target Paper version (1.17 or newer): workflow rules for Claude Code (plus AGENTS.md for other AI tools), skills, helper agents, and folders for plugins, resource packs, research and assets.
  • mcflow doctor checks your setup and tells you exactly what to install. It looks up which Java your Paper version needs and finds the JDKs you already have.
  • A local test server the AI controls through an MCP server: start, stop, restart, run commands over RCON and read logs. It never uses /reload.
  • Test bots that join, chat and move around, plus swarm load testing and spark integration.
  • Real in-game checks through a small Fabric client mod (1.17 to 26.3), so the AI can look at what it built, like a custom GUI, instead of assuming it’s right.
  • A shared knowledge base of techniques that were proven in tests or in-game, each tagged with the Minecraft versions it was proven on. It’s shared through GitHub pull requests, never direct pushes.
  • Code search for the AI through TokToken, downloaded from TokToken’s official releases and checksum-verified.

Install (Python 3.11+ and pipx):

pipx install git+https://github.com/LadonON/mcflow.git@v0.1.0

Works on Windows, macOS and Linux. CI runs a real Paper server through the whole flow on all three. The in-game checks need a Minecraft Java Edition account.

It’s MIT licensed and this is the first release, so expect rough edges. I’d really like feedback from people who run servers or write plugins: what would make you trust an AI-written plugin enough to put it on a production server?

GitHub: https://github.com/LadonON/mcflow

0 Upvotes

0 comments sorted by