McPluginLab v1.0.1

[1.0.1] - 2026-11-02

Databases: a project can now have its own MariaDB, started with the network and wired into plugin configs.

Added

• MariaDB instance type. mpl create demo/db --type mariadb (or Add instance → Database → mariadb in the GUI).
  The first start creates the data directory, a database named after the project and a user mpl with a generated
  password.
  • Uses the mariadbd on your PATH when there is one. Otherwise MariaDB 11.8.3, 11.4.5 or 10.11.11 is downloaded
    once, checksum verified, and cached.
  • Listens on 127.0.0.1 only. --bind-all opens it to other machines; root is never reachable over the network.
  • mpl up starts the database before servers and proxies, and mpl down stops it last.
• Plugin database binding. mpl plugin bind writes the database connection into a plugin's config on every start
  and network sync, for the servers (and proxies) the plugin is linked to:

  mpl plugin bind -P demo Shop -f plugins/Shop/config.yml \
    -s storage.host={host} -s storage.port={port} -s storage.database={database} \
    -s storage.user={user} -s storage.password={password}

  Templates: {host} {port} {database} {user} {password} {jdbc}. Supports .yml, .toml and
  .properties files. The config file must already exist, so start the server once first.
• mpl db commands. mpl db info, mpl db sql <instance> "<sql>" [--root] and mpl db reset.
• GUI: Connection tab on database instances.
  • Host, database, user, password and JDBC URL, with copy buttons.
  • A table browser: click a table to run SELECT * … LIMIT 200.
  • A SQL box with results shown as a table (NULLs dimmed, long values truncated, row count).
  • A Reset database button.
  • The link-plugin dialog has an optional database binding.
• MCP tools for AI agents: db_info, db_query, db_reset and bind_plugin_database. create_instance accepts
  type=mariadb. The mpl-plugin-test skill documents the flow.
• Docs: new Databases page; CLI, architecture and AI agent docs updated.

Notes

• Plugin config files that do not exist yet are left alone, because creating one would stop the plugin from writing
  its defaults. Start the server once, then bind.
• Existing projects keep working: all new settings have defaults, so old project and instance files load unchanged.
• The daemon build changes with this release. If an older daemon is running, mpl restarts it when idle, and warns
  instead when instances are running; run mpl shutdown to switch over.

SHA-256 of mpl-1.0.1.zip: 30acdf3dcf09f2fbc1c7ebdcac32bc5174beacd0eb87380741752f583b5c737c

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).