Metroidvania Studio MCP server

Metroidvania Studio

Metroidvania Studio is a free, open-source 2D level editor for metroidvania games. Build connected rooms, paint autotiled maps, and design minimaps with JSON export for multiple game engines. The room-based map editor runs locally in your browser or the Windows program.

Website · Documentation · Downloads

Automate your workflow: Lua scripts, a headless CLI, and a local MCP server for AI agents.

Add Rooms & Paint Tiles

Configure Tile Palettes

Resize, Rotate & Connect Rooms

Design Your Minimap

Explore with Game Preview

Get Started

Runs locally on Windows, macOS, and Linux. No game engine installation is required.

Download a ready-to-run package from GitHub Releases, extract it, and open the launch file at the top level. The prebuilt web package requires ASP.NET Core Runtime 10.

To build from source, install:

Then use the scripts for your platform:

Run checks your local build against the current version and source files. It builds automatically when needed, then opens the studio in your browser. An up-to-date build starts immediately.

Maps and Textures are stored beside the launcher or at the source project root. Find them through File → Storage folders. Room JSON updates automatically in Maps/AutoExport; palette settings are managed in .studio/catalog.json. Keep Maps, Textures and .studio when updating the studio.

Try the Sample World

A new workspace opens a six-room world with a looping route, a vertical shaft, a side chamber, slopes, background tiles, and object markers. You can also open it through Help → Open sample world.

Paint a room, Ctrl-click two rooms to move them together, or switch to the minimap and double-click a room to jump back into editing. See the five-minute walkthrough or sample JSON.

Editing Basics

Shortened. The full README is on GitHub.