metroidvania-studio
v1.3.2
Published
Create connected 2D worlds with Lua scripting, a headless CLI, and a local MCP server.
Downloads
724
Maintainers
Readme
Metroidvania Studio
Create connected 2D worlds with Lua scripting, a headless CLI, and a local MCP server. Maps stay in your workspace as engine-neutral JSON.
This package contains the command-line and MCP tools. It requires Node.js 24+ and the .NET 10 runtime. A .NET SDK, an engine installation, and a browser are not needed to run it.
npm install --global metroidvania-studio
metroidvania-studio version
mkdir maps
metroidvania-studio --workspace ./maps init --map world.map.json
metroidvania-studio --workspace ./maps inspect --map world.map.json
metroidvania-studio --workspace ./maps run --map world.map.json --script layout.lua --dry-run
metroidvania-studio mcp --workspace ./mapsMCP uses standard input/output. The installed program does not download tools, access an external service, or send telemetry. Installing from a package registry is a separate npm operation. Resource and map paths are confined to the selected workspace. Use --read-only for an MCP connection that must not edit files.
Use METROIDVANIA_STUDIO_DOTNET to select an existing .NET host when it is not found automatically.
Keep LICENSE, THIRD-PARTY-NOTICES.md, and app/licenses with redistributed copies.
Open docs/site/index.html inside the installed package for the searchable offline API reference.
