Metroidvania-System 地图编辑器上手指南：从 0 到跑通第一张地图
【免费下载链接】Metroidvania-SystemGeneral-purpose framework for creating metroidvania games in Godot.项目地址: https://gitcode.com/gh_mirrors/me/Metroidvania-System
Metroidvania-System 地图编辑器是这款 Godot 游戏框架里最省事的工具：在网格上点鼠标就能完成放房间、连出入口、摆收集品这些活。想想另一条路——手写地图数据文件，一条条维护房间连接关系，改个出口还要回头翻文件核对——你就明白为什么值得先花十分钟把它装起来。
它替你省下的几件苦差事
上手之前，先说清楚这个 Godot 地图编辑器替你扛了哪些活：
- 可视化房间布局：网格上拖一下就是房间，尺寸随拖随变，全程不碰数据文件。
- 房间连接自动维护：给某条边开门，相邻房间对应的边自动对齐，不用手动同步。
- 多层地图：每个图层是一张独立平面，配合电梯、楼梯做出立体结构。
- 主题一键切换：SotN、Kenney、Exquisite 等内置主题，换个下拉选项地图皮肤就变了。
- 撤销重做兜底：
Ctrl+Z/Ctrl+Y，画错了随时退，放心大胆试。
三步进入 MetSys 地图编辑器
- 克隆仓库到本地：
git clone https://gitcode.com/gh_mirrors/me/Metroidvania-System - 用 Godot 4.2 或更新版本打开项目目录。第一次打开时编辑器会自动重启一次，这是它在装 MetSys 单例，属正常现象。
- 点顶部工具栏的 MetSys 图标，选 "Map Editor" 标签页。 🖱️
至此，你的 Godot 编辑器里已经多了一块可视化关卡设计的画布，剩下的都是画图了。
跟着做完：画出第一张房间布局
- 建房间：左侧切到
Room Layout模式，在网格上按住左键拖出一个矩形，松手就是一间房。 - 挪位置：
Shift+Drag可以整房平移；不满意就Ctrl+Z撤掉重来。 - 定出入口：切到
Border Type模式，点在房间的某条边上，门就开了；Shift+Click能给整个房间统一设置。边界管理的核心逻辑在addons/MetroidvaniaSystem/Database/SubEditor.gd里，平时你只需要点。 🚪 - 摆互动元素：
Custom Elements模式下点格子放收集品、传送门。可放哪些元素由设置里挂的脚本决定，基类是addons/MetroidvaniaSystem/Scripts/CustomElementManager.gd，示例项目用的是SampleProject/Scripts/CustomElements.gd。 🧩 - 存盘：
Ctrl+S，数据落到SampleProject/Maps/MapData.txt，关掉重开不会丢。 💾
进阶玩法：多层地图、换主题、绑场景
怎么搭一张多层立体地图
画完第一层，在上方Current Layer下拉里加新图层，每一层都是独立平面。用Preview Layer可以把另一层半透明地叠在当前视图上，方便对齐电梯上下口。层与层之间通行，就靠电梯、楼梯这类房间。
怎么一键切换内置主题
主题预设都在addons/MetroidvaniaSystem/Themes/目录下，打开SampleProject/Resources/Settings.tres，在theme字段里选 SotN、Kenney、Exquisite 任意一个，保存后编辑器立刻换装。哪个都不合眼缘的话，照着现有主题复制一份改图片也行。
怎么给房间绑定 .tscn 场景文件
切到Scene Assign模式，把Corridor.tscn这类场景文件直接拖到房间上就完成绑定；也可以点Create New Scene让编辑器现场建一个新场景。场景文件统一放在SampleProject/Maps/下，运行时框架会自动按绑定关系加载和切换。
接下来做什么：翻示例、改个主题试试
示例工程里的SampleProject/Maps/就是一张能直接跑的地牢，每个房间都有对应场景，值得逐个点开看看别人是怎么连的。建议你下一步就做两件事：打开Settings.tres换一次主题，再给示例地图加一层、接一个电梯。做完这两件，这个框架对你来说就不陌生了。
【免费下载链接】Metroidvania-SystemGeneral-purpose framework for creating metroidvania games in Godot.项目地址: https://gitcode.com/gh_mirrors/me/Metroidvania-System
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
