地图编辑器
MC Studio 内置了强大的 3D 地图编辑器，用于搭建游戏场景中的地形和建筑。你可以通过选取、编辑、笔刷、地形等工具快速创建复杂的方块结构。
新版编辑器
以下内容仅适用于新版编辑器。旧版编辑器已停止更新，请将作品升级至新版使用。
概述
地图编辑器是场景制作的核心工具，界面分为四个区域：
| 区域 | 说明 |
|---|---|
| 工具栏 | 选取、编辑、笔刷、地形等主要功能入口，以及撤销/重做/保存/运行 |
| 副工具栏 | 当前工具的简单配置项 |
| 功能窗口 | 复杂功能的独立面板（材质、笔刷、地形、素材库等） |
| 预览窗 | 内嵌游戏的 3D 场景预览，支持自由移动相机 |
预览窗操作
默认镜头移动方式类似创造模式飞行：
- WASD：前后左右移动
- 空格：向上移动
- Shift：向下移动
- 右键拖拽：调整视角
- 滚轮：沿镜头方向前进/后退
维度切换
点击预览窗左上角的维度下拉菜单，可切换到下界、末地或自定义维度进行编辑。
选取工具
选取工具是地图编辑的第一步。快捷键 M。
基础操作
- 点击工具栏中的"选取"按钮进入选取模式
- 选择一个方块作为起点，按住左键拖拽至终点
- 以起点和终点为对角线，生成一个选区（包围盒）
选区调整
| 操作 | 方法 |
|---|---|
| 移动选区 | 拖动位移拖柄，沿 X/Y/Z 轴移动 |
| 精确偏移 | 点击工具栏"偏移"按钮，输入坐标值 |
| 调整尺寸 | 拖动选区某个面 |
| 纵向微调 | Ctrl + 滚轮 调整包围盒纵向位置 |
| 水平微调 | 方向键 ↑↓←→ 调整水平位置 |
| 取消选区 | 点击空气区域或按 Esc |
选区操作
选定选区后，你可以：
| 操作 | 快捷键 | 说明 |
|---|---|---|
| 删除 | Delete | 删除选区内所有方块 |
| 复制 | Ctrl+C | 复制选区到剪贴板，进入编辑模式 |
| 剪切 | Ctrl+X | 剪切选区到剪贴板 |
| 填充 | Ctrl+F | 用指定方块填满选区 |
| 替换 | Ctrl+H | 将选区内的一种方块替换为另一种 |
| 堆叠 | Ctrl+M | 沿 X/Y/Z 轴定向堆叠指定次数 |
多选模式
在副工具栏切换到"多选模式"后，可以同时选出多个选区。复制、填充、替换等操作对全部选区共同生效。
编辑工具
编辑工具用于对选取的方块进行变换操作。快捷键 Q。
复制或剪切选区后，包围盒变为黄色进入编辑状态，你可以：
| 操作 | 说明 |
|---|---|
| 移动 | 拖动拖柄移动方块 |
| 缩放 | 拖动拖柄缩放方块 |
| 旋转 | 在副工具栏选择沿某轴旋转 90°/180°/-90° |
| 伸缩 | 沿某轴按倍数伸缩 |
完成调整后按 回车 确认，按 Esc 放弃编辑。
方向方块注意
如果选区内有带方向状态的方块（如楼梯、活塞），旋转和缩放可能不会产生预期效果。建议对此类方块谨慎操作。
笔刷工具
笔刷工具用于在地图中快速生成指定形状的方块。快捷键 B。
笔刷类型
| 笔刷 | 说明 | 支持结构选项 |
|---|---|---|
| 单点 | 放置单个方块 | - |
| 立方体 | 生成立方体，可指定 XYZ 边长 | 实心/中空/去除底面/仅框架 |
| 球体 | 生成球体或椭球体 | 实心/中空 |
| 半球体 | 生成半球体，可指定朝向 | 实心/中空/去除底面 |
| 圆柱 | 生成圆柱或椭圆柱 | 实心/中空/去除底面 |
| 圆锥 | 生成圆锥或椭圆锥 | 实心/中空/去除底面 |
| 多棱柱 | 正多边形底面，可指定边数和外接圆半径 | 实心/中空/去除底面 |
| 素材笔刷 | 使用素材库中的自定义素材作为笔刷形状 | - |
通用参数
每种笔刷都支持以下配置：
| 参数 | 说明 |
|---|---|
| 连续生成间距 | 鼠标拖动多少格距离后生成一个笔刷形状 |
| 直线生成 | 点击 A 点再点击 B 点，在 AB 线段上生成 |
| 覆盖原方块 | 是否覆盖已有方块 |
| 放置基点 | 停靠/居中/向上/向下 |
| 厚度 | 中空/去除底面时的壳体厚度 |
素材笔刷
素材笔刷可以直接将素材库中的建筑模板作为笔刷使用，一键刷出复杂结构，大幅减少重复操作。
地形工具
地形工具用于对地图整体地形进行大范围调整。快捷键 L。
地形操作
| 操作 | 说明 |
|---|---|
| 隆起 | 指定区域内的方块向相机方向隆起 1 格 |
| 凹陷 | 方块向远离相机方向凹陷 1 格 |
| 平滑 | 去掉突出、填充凹陷，让地表变得平滑 |
| 侵蚀 | 去掉突出的方块 |
| 填充 | 填充凹陷区域和空洞 |
| 顶层覆盖 | 在顶部覆盖若干层指定材质 |
| 顶层替换 | 将顶部若干层方块替换为指定材质 |
| 表层替换 | 替换表面 1 层方块（含侧面） |
通用参数
| 参数 | 说明 |
|---|---|
| 操作区域 | 球体范围或立方体范围 |
| 区域直径 | 正整数，指定影响范围大小 |
| 强度 | 1-10，每秒操作次数 |
| 不影响流体 | 是否跳过水和岩浆方块 |
植被工具
地形工具还包含植被工具，支持在地图中放置原生植物特征：
- 单点模式：点击一次放置一个植物
- 范围模式：在指定区域内按密度生成多个植物
植被生成依赖引擎
植被能否生成取决于原生游戏的特征生成逻辑。部分植被在放置后无法撤销，请谨慎使用。
素材库
素材库用于保存、复用方块结构，是提升地图制作效率的关键工具。
素材
- 保存素材：选取方块后右键选择"保存为素材"，存入素材库长期使用
- 放置素材：在素材库窗口单击素材，左键点击地图位置放置
- 二次编辑：放置后可进行移动、旋转、缩放、翻转等调整
- 导入导出：素材
.mdl文件可导入导出，支持跨作品使用 - 模型导入：支持导入
.obj、.fbx、.3ds、.ply、.stl模型转为素材
结构
- 保存结构：选取方块后右键"保存为结构"，生成
.mcstructure文件 - 结构选项：可选包含实体、去除空气、网易版优化、切分结构
- 放置结构：在素材库"结构"分页中选择并放置
素材 vs 结构
素材跨作品可用，长期保存在本地。结构仅当前作品可见，保存在行为包 structures/ 目录中。
剪贴板
- 复制/剪切选区后，方块保存到剪贴板
- 剪贴板内容为临时存储，关闭编辑器后清除
- 可将剪贴板内容添加到素材库转为永久素材
方块状态设置
编辑时可以为方块指定状态值，进一步控制方块的外观和行为。
支持的状态值示例
| 状态值 | 说明 |
|---|---|
| 方向 | 面朝东/西/南/北/上/下 |
| 开关状态 | 门的开关、拉杆状态 |
| 红石信号 | 活化/未活化 |
| 含水状态 | 方块是否含水 |
使用方式
- 在材质预设窗口选择方块，展开"状态值设置"标签
- 通过下拉选框修改状态值
- 配置好的材质预设可应用到笔刷、填充、替换等所有工具
吸管工具保留状态值
使用吸管工具（快捷键 I）拾取方块时，会同时保留该方块的状态值信息。
常用快捷键
| 功能 | 快捷键 | 功能 | 快捷键 | |
|---|---|---|---|---|
| 选取 | M | 笔刷 | B | |
| 编辑 | Q | 地形 | L | |
| 撤销 | Ctrl+Z | 重做 | Ctrl+Y | |
| 复制 | Ctrl+C | 粘贴 | Ctrl+V | |
| 剪切 | Ctrl+X | 删除 | Delete | |
| 填充 | Ctrl+F | 替换 | Ctrl+H | |
| 堆叠 | Ctrl+M | 保存 | Ctrl+S | |
| 取消选取 | Ctrl+D | 完成 | Enter | |
| 放弃编辑 | Esc | 吸管 | I | |
| 打开材质 | E | 出生点 | Ctrl+B |