Repository navigation
[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 usermplwith a generated
password.- Uses the
mariadbdon yourPATHwhen 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.1only.--bind-allopens it to other machines;rootis never reachable over the network. mpl upstarts the database before servers and proxies, andmpl downstops it last.
- Uses the
- Plugin database binding.
mpl plugin bindwrites the database connection into a plugin's config on every start
and network sync, for the servers (and proxies) the plugin is linked to:Templates: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}{host}{port}{database}{user}{password}{jdbc}. Supports.yml,.tomland
.propertiesfiles. The config file must already exist, so start the server once first. mpl dbcommands.mpl db info,mpl db sql <instance> "<sql>" [--root]andmpl 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_resetandbind_plugin_database.create_instanceaccepts
type=mariadb. Thempl-plugin-testskill 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,
mplrestarts it when idle, and warns
instead when instances are running; runmpl shutdownto switch over.
SHA-256 of mpl-1.0.1.zip: 30acdf3dcf09f2fbc1c7ebdcac32bc5174beacd0eb87380741752f583b5c737c