McPluginLab v1.0.0

McPluginLab is a desktop workbench for testing Minecraft plugins: servers, proxies, plugin auto-deploy,
live consoles, bots and a game client in one app, driven from a GUI, the command line or an AI agent.

Highlights

• Projects group the servers, proxies, bots and clients you test together, with an overview page to start,
  stop and restart everything or a selection. Proxies and servers come up first, then bots and clients.
• Server software: Paper, Purpur, Folia and Spigot (BuildTools), Velocity, Waterfall and BungeeCord.
  Downloads are verified and cached; the EULA, offline mode and ports are set up for you.
• Self-configuring networks: server lists, modern or legacy forwarding and secrets are written on every start.
  Any server can be switched out of the network to run standalone.
• Live consoles with colors, tab completion and scrollback, embedded or popped out into your terminal.
  Servers keep running when the window closes.
• Plugin auto-deploy: link target/MyPlugin-*.jar and every build is copied to its servers, old versions
  are removed and the servers restart.
• SoulFire bots and a built-in Minecraft launcher (offline accounts) that join your network automatically.
• Automatic Java: each instance gets the Java version it needs; missing JDKs are downloaded from Adoptium.
• MCP server for AI agents (mpl mcp): start projects, deploy, send commands, drive bots and wait for
  log lines, the same way you do.
• Config editor with syntax highlighting, and a full CLI (mpl up, mpl send --expect, mpl attach, …).

Install

Requirements: Linux x64 and Java 21 or newer.

unzip mpl-1.0.0.zip
export PATH="$PWD/mpl-1.0.0/bin:$PATH"
mpl desktop   # optional: add McPluginLab to your application menu
mpl gui

For AI agents: claude mcp add mpl -- /path/to/mpl-1.0.0/bin/mpl mcp

See the README and docs/ for the full guide.

Known limitations

• Linux x64 only.
• The built-in client supports offline accounts only (no Microsoft login yet).