mcpField
M
Metroidvania Studio

Metroidvania Studio

本地服务
github.com/LBarimi媒体与设计27 周前更新
代码仓库

关于 Metroidvania Studio

Metroidvania Studio 是面向类银河战士恶魔城游戏创作者的免费开源 2D 关卡编辑器，支持房间式地图、绘制图块、小地图和 JSON 导出。Lua 脚本、无界面 CLI 和本地 MCP 服务可配合可视化编辑实现自动化。

主要功能

  1. 01构建并连接地图房间
  2. 02绘制自动拼接地图
  3. 03设计小地图并预览游戏
  4. 04导入和导出通用 JSON 地图
  5. 05使用 Lua 和 CLI 自动编辑
  6. 06通过试运行审查脚本更改

适用场景

  1. 01规划类银河战士恶魔城的相连房间
  2. 02绘制和修改房间图块
  3. 03为支持的游戏引擎导出地图
  4. 04自动执行重复的地图编辑

MCP 相关

本地 MCP 服务让 AI Agent 与编辑器交互，也可使用 Lua 脚本和无界面 CLI。脚本更改支持试运行、原子更新和版本检查。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "lbarimi-metroidvania-studio": {
      "command": "npx",
      "args": [
        "-y",
        "metroidvania-studio"
      ]
    }
  }
}
启动命令npx -y metroidvania-studio

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmetroidvania-studio1.3.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

README 配图 Metroidvania Studio

Metroidvania Studio 是一款免费、开源的 2D 银河恶魔城游戏关卡编辑器。创建互连的房间、绘制自动拼接地图，并设计小地图，可将 JSON 导出到多种游戏引擎。基于房间的地图编辑器可在本地浏览器或 Windows 程序中运行。

网站 · 文档 · 下载

自动化工作流： Lua 脚本、无头 CLI和供 AI Agent 使用的本地 MCP 服务。

添加房间并绘制图块

添加第二个房间，绘制岩石图块，然后平移回去并连接第一个房间

配置图块调色板

将草原 PNG 导入颜色调色板，并更新现有房间

调整大小、旋转并连接房间

调整三个冰窟房间的大小、旋转并将它们连接起来

设计小地图

探索包含五种地形主题的世界，双击冰窟进行编辑，然后缩小视图

使用游戏预览探索

在房间内拖动游戏摄像机，查看实时画面，并最大化或折叠游戏预览

开始使用

可在 Windows、macOS 和 Linux 上本地运行。无需安装游戏引擎。

从 GitHub Releases 下载可直接运行的软件包，解压后打开顶层目录中的启动文件。预构建的 Web 软件包需要 ASP.NET Core Runtime 10。

要从源代码构建，请安装：

要求用途
Node.js 24+构建 Web UI 并运行构建脚本
.NET SDK 10构建本地服务和命令行工具
Git在构建期间验证源文件

然后使用适用于你平台的脚本：

平台构建运行
Windowsplatform/win/web/build.batplatform/win/web/run.bat
macOSplatform/mac/build.commandplatform/mac/run.command
Linuxbash platform/linux/build.shbash platform/linux/run.sh

运行会将本地构建与当前版本及源文件进行检查。需要时会自动构建，然后在浏览器中打开工作室。构建已是最新时会立即启动。

Maps 和 Textures 存储在启动器旁边或源项目根目录中。通过文件 → 存储文件夹找到它们。房间 JSON 会自动更新到 Maps/AutoExport；调色板设置由 .studio/catalog.json 管理。更新工作室时，请保留 Maps、Textures 和 .studio。

试用示例世界

新工作区会打开一个包含六个房间的世界，其中有一条环形路线、一条垂直竖井、一个侧室、斜坡、背景图块和物体标记。你也可以通过帮助 → 打开示例世界打开它。

绘制房间，按住 Ctrl 并单击两个房间即可同时移动它们；或者切换到小地图，双击房间即可返回编辑。请参阅五分钟快速入门或示例 JSON。

编辑基础

  • **绘制：**在当前房间内按住鼠标左键拖动。首次点击其他房间时会选中该房间。

  • **擦除：**在当前房间内按住鼠标右键拖动。

  • **平移和缩放：**按住鼠标中键拖动以平移，滚动鼠标滚轮以缩放，按住 Ctrl + 滚轮以更改画笔大小。在空白处按住鼠标右键拖动也可平移。

  • **排列房间：**右键单击空白处以添加房间，拖动房间的标题栏以移动房间，或拖动房间外侧的控制柄以调整大小。可在检查器中旋转房间。

  • **保存和交换地图：**使用 File 保存并导入/导出 JSON。使用 Edit 撤销/重做。在顶部工具栏设置 PPU 和分辨率（默认值：16 和 320×180）。

  • **预览：**选择 Game camera 并拖动其白色边框。Game Preview 会立即跟随；可按需展开、最大化或折叠。

查看 Help → Shortcuts，了解完整的控制列表。界面会遵循浏览器语言，也可通过语言选择器更改。

打开 Help → Documentation，查看可搜索的指南和 API 参考，并支持离线访问。

引擎包

引擎软件包安装
Unity.unitypackage指南
GodotAddon ZIP指南
Unreal Engine 4Plugin ZIP指南
Unreal Engine 5Plugin ZIP指南
SDL3C++ source ZIP指南

每个引擎文件夹都包含翻译后的安装指南。地图采用通用的 JSON 格式；引擎包负责导入和渲染，而游戏玩法则由你的游戏项目实现。

脚本与自动化

使用 File → Scripts 生成房间或重复执行编辑任务。通过 CLI 无头运行相同操作，或通过本地 MCP server 连接 AI Agent。试运行、原子更新和版本检查可确保脚本编辑易于审查。

使用 Node.js 24+ 和 .NET 10 runtime 安装 CLI 和 MCP 工具：

npm install --global metroidvania-studio

使用程序下载包？在 Windows 上运行 metroidvania-studio-cli.cmd help，或在 macOS/Linux 上运行 bash metroidvania-studio-cli.sh help。请参阅从下载包无头运行。

从文档、API 参考、Lua 示例或 MCP 设置指南开始。

许可证

项目自有代码和资源采用 MIT License。 有关外部组件及其条款，请参阅第三方声明。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。