feat:上传mcguide-开发指南部份

mcguide/14-地图制作/2-地图编辑器使用说明.md

@@ -0,0 +1,110 @@
+---
+front: https://nie.res.netease.com/r/pic/20221219/e57b7c1f-382e-4095-bbbd-573ca78fb57a.png
+hard: 入门
+time: 10分钟
+selection: 100
+---
+
+# 地图编辑器使用说明
+
+**在本文中**
+
+- [界面介绍](#界面介绍)
+- [预览窗功能](#预览窗功能)
+- [维度切换](#维度切换)
+- [主要工具](#主要工具)
+- [其他相关文档](#其他相关文档)
+- [常用快捷键](#常用快捷键)
+
+::: warning 注意
+
+以下内容仅适用于 **新版编辑器** 。旧版编辑器现已停止更新，请将作品升级至新版使用。
+
+:::
+
+使用本章可快速查找并了解地图编辑器的工具资源和其他相关文档，以及常用快捷键。
+
+
+
+## 界面介绍
+
+地图编辑器的功能分区如下图所示：
+
+![](./images/new_docs/A1.png)
+
+1. ###  界面划分
+
+   - **工具栏：** 包含地图编辑器主要编辑功能的入口按钮，同时还有撤销重做、保存、游戏模式、运行等编辑常用功能入口。
+
+   - **副工具栏：** 用于展示工具栏中部分功能的配置项。在副工具栏中配置的功能通常较为简单，可配置项不多。
+
+   - **功能窗口：** 如果一个编辑工具的功能较为庞杂，需要很多配置项，则会单独为其展示一个功能窗口，比如材质、笔刷、地形、素材库等，都有单独的窗口供您使用。
+
+   - **预览窗：** 用于在编辑器内嵌游戏中提供编辑操作的预览效果。同时还兼具维度切换、坐标展示等功能。
+
+
+2. ### 窗口布局调整
+
+   - 
+     您可以根据自己的编辑需要，自行移动、开关功能窗口。
+
+
+![](./images/new_docs/B1.gif)
+
+## 预览窗功能
+
+编辑器预览窗里，默认的镜头移动方式类似我的世界创造模式的飞行：
+
+- WASD键控制前后左右的移动，Shift键向下移动，空格键向上移动；
+- 长按鼠标右键并移动鼠标，可调整当前视角；
+- 使用鼠标滚轮沿当前镜头方向前进/后退。
+
+在菜单栏点击【作品】-【设置】，可以调整操作方式为【镜头模式】：
+
+- 在镜头模式下，W/S键控制移动为沿镜头方向的前进/后退。
+
+![](./images/new_docs/B2.gif)
+
+
+## 维度切换
+
+如果您需要在主世界以外的其他维度进行地图编辑，可以点击预览窗左上角的维度下拉菜单，将内嵌游戏切换至其他维度，如下界、末地，或者您自行创建的自定义维度。
+
+![](./images/C1.gif)
+
+如果在切换维度前存在自定义维度增删等操作，您可能会遇到弹窗提醒重载地图。详情请见关卡编辑器文档中[关于维度增删特殊情况的说明](../20-玩法开发/11-组装简单玩法/0-关卡编辑器.md#4-增删维度的特殊情况)。
+
+## 主要工具
+
+1. [选区工具](./3-选取工具.md)
+2. [编辑工具](./4-编辑工具.md)
+3. [材质选择](./5-材质选择.md)
+4. [笔刷工具](./6-笔刷工具.md)
+5. [地形工具](./7-地形工具.md)
+6. [素材库、结构与剪贴板](./8-素材库、结构与剪贴板.md)
+
+## 其他相关文档
+
+1. [方块状态值设置说明](./91-方块状态值设置说明.md)
+2. [蒙版工具说明](./92-蒙版工具说明.md)
+
+
+## 常用快捷键
+
+以下为常用的快捷键。
+
+| 功能 | 快捷键| | 功能 | 快捷键 |
+| :--- | :--- | :--- | :--- | :--- |
+| 撤销 |  ctrl+Z | | 复制 | ctrl+C |
+| 重做 | ctrl+Y | | 剪切 | ctrl+X |
+| 保存地图 | ctrl+S | | 粘贴 | ctrl+V |
+| 笔刷 | B | | 打开材质 | E |
+| 地形 | L | | 切换材质 | 数字键1到0 |
+| 选取 | M | | 以当前材质填充 | alt+delete |
+| 取消选取 | ctrl+D | | 切换材质预设分页 | ~ |
+| 编辑 | Q | | 调整选区/模型位置 | ctrl+鼠标滚轮 |
+| 删除 | delete | | 吸管 | I |
+| 完成 | 回车 | | 堆叠 | ctrl+M |
+| 放弃编辑 | esc | | 填充 | ctrl+F |
+| 橡皮 | Y | | 替换 | ctrl+H |
+| 出生点 | ctrl+B || 偏移 | V |

mcguide/14-地图制作/3-选取工具.md

@@ -0,0 +1,122 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/2db6428c-4864-44b1-9f0d-109a1be77bbd.png
+hard: 入门
+time: 15分钟
+selection: 90
+---
+
+# 选取工具
+
+选取工具能让您能够更加方便地对范围内的方块进行选中。在开始之前，您应该知道如何启动 **MC Studio** 、 **创建项目** 、 **进入编辑器模式** 并学会在内嵌游戏中 **移动** 。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **选取工具** 。
+
+
+
+## 要求
+
+建议在开始本指南之前完成以下内容。
+
+- [MC Studio使用说明](../12-入门教程/20-MC%20Studio使用说明.md)
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+
+
+
+## 基础选取操作
+
+点击工具栏中的【选取】按钮，即可进入选取模式。在选取模式下，选择一个方块作为 **起点** ，然后 **按住左键** 拖拽至 **终点** ，以起点和终点为对角线生成 **选区（包围盒）** 。
+
+![](./images/new_docs/B3.gif)
+
+## 选区调整
+
+选好选区后，您可以对选区进行如下调整：
+
+- 拖动位移拖柄，对选区的位置进行X、Y、Z轴的移动.
+
+![](./images/new_docs/B5.gif)
+
+- 点击工具栏【偏移】按钮，可以对选区位置进行更精确地调整。
+
+![](./images/new_docs/B7.gif)
+
+::: tip 快捷键
+
+Ctrl+鼠标滚轮调整包围盒的纵向位置，用键盘↑↓←→方向键调整包围盒的水平位置。
+
+:::
+
+- 拖动某个平面，调整选区尺寸；
+
+![](./images/new_docs/B6.gif)
+
+- 点击空气区域或按ESC键取消选取选区。
+
+![](./images/new_docs/B38.gif)
+
+- 单选模式下，当选区存在时，可以直接框选另一处选区以创建新的包围盒。
+
+![](./images/new_docs/B39.gif)
+
+## 选区操作
+
+选定好选区之后，您就可以对选区内方块进行进一步的操作了。
+
+- **删除**（delete）：快速删除选区内的方块。
+
+![](./images/new_docs/B12.gif)
+
+- **复制/剪切**（ctrl+X/ctrl+Z）：将选区及内部方块复制/剪切至剪贴版。此时包围盒会变成黄色状态，并进入[编辑](./4-编辑工具.html)状态。
+
+![](./images/new_docs/B8.gif)
+
+- **堆叠**（ctrl+M）：点击堆叠按钮，将选中区域沿X、Y、Z轴定向堆叠指定次数， **确定** 选择后即可生成。
+
+![](./images/new_docs/B9.gif)
+
+- **填充**（ctrl+F）：将选中区域中的全部空间替换成选定的方块，按下 **填充** 后即可生成。
+
+![](./images/new_docs/B10.gif)
+
+- **替换**（ctrl+H）：将选中区域中含有的一种方块全部替换为选定的方块。点击每一行替代方块的右槽方块，选取您想要的方块材质，点击 **替换** 按钮一键看到结果。
+
+![](./images/new_docs/B11.gif)
+
+::: tip 提示
+
+填充和替换工具可以指定所用方块的状态值，例如您可以指定使用朝东的原木楼梯来填充选区。关于状态值的使用，请查看[这篇文档](./91-方块状态值设置说明.md)。
+
+:::
+
+## 多选模式
+
+选取工具默认为【单选模式】，我们可以在副工具栏上切换为【多选模式】，这样我们可以同时选出多个选区。
+
+![](./images/new_docs/B4.gif)
+
+- 选中多个选区后，可以对其中单独一个选区进行位置、尺寸的调整。
+
+
+![](./images/new_docs/B13.gif)
+
+::: tip 提示
+
+复制、剪切、堆叠、填充、替换、偏移等工具将对全部选区共同生效。
+
+:::
+
+
+
+## 智能识别物体
+
+选中建筑区域后，右键选择 **智能识别物体**，即可框选出指定的建筑结构，并将包围盒缩小至建筑大小，方便进一步操作。
+
+![](./images/new_docs/B46.gif)
+
+
+
+## 下一步：编辑工具
+
+选取区域还仅仅只是第一步，使用[编辑工具](./4-编辑工具.md)对世界做些改变吧！

mcguide/14-地图制作/4-编辑工具.md

@@ -0,0 +1,74 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/92b4fd40-9630-44a3-a4f4-247f5810ffa6.png
+hard: 入门
+time: 5分钟
+selection: 80
+---
+
+# 编辑工具
+
+选好选区后，编辑工具将选取方块模拟生成，并通过操作系列使其在世界中生效。在开始之前，您应该学会熟悉地图编辑器的布局与选取工具。
+
+
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **编辑工具** 。
+
+::: danger 快捷键
+
+使用快捷键Q快速切换选区模式至编辑模式，对包围盒内的方块结构进行编辑。
+
+:::
+
+
+
+## 要求
+
+建议在开始本指南之前完成以下内容。
+
+- [选取工具](./3-选取工具.md)
+
+
+
+## 常用编辑操作
+
+在编辑模式下，我们可以：
+
+- **使用拖柄移动选区内的方块。**
+
+![](./images/new_docs/B14.gif)
+
+- **使用拖柄缩放选区内的方块。**
+
+![](./images/new_docs/B15.gif)
+
+- **选区方块绕轴旋转：** 在 **编辑工具** 的 **副工具栏** 可以选择沿一个轴旋转`90°`、`180°`或`-90°`。
+
+![](./images/new_docs/B16.gif)
+
+- **选区方块沿轴按倍数伸缩：** 在 **编辑工具** 的 **副工具栏** 可以选择沿一个轴旋转`90°`、`180°`或`-90°`。
+
+![](./images/new_docs/B17.gif)
+
+::: danger 提示
+
+需要注意的是，如果选区内有明确方向状态的方块，一般不适合直接对齐进行尺寸伸缩，或进行沿X、Z轴的旋转操作，因为在大多数情况下这样做并不能带来期望的效果。
+
+:::
+
+
+
+## 对多选选区的编辑
+
+在多选模式下，编辑操作影响所有子选区。点击 **编辑** 会显示一个大的包围盒，实际编辑人移动、旋转、缩放时，会将之前子选区内方块整合后统一处理。
+
+![](./images/new_docs/B18.gif)
+
+
+
+## 下一步：材质选择
+
+现在您已经学习了编辑工具的所有功能，包括如何将选取工具切换至编辑工具，并对所选区域进行移动、缩放、旋转。
+
+在下一节中，您将学习如何使用材质工具在地图中选取想要铺设的方块。

mcguide/14-地图制作/5-材质选择.md

@@ -0,0 +1,112 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/70a0fa58-73e0-4a59-ae80-7cfb91f1f781.png
+hard: 入门
+time: 10分钟
+selection: 70
+---
+
+# 材质选择
+
+在制作我的世界地图时，选择合适的方块至关重要。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **材质选择** 。
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+
+
+
+## 方块材质
+
+地图编辑器使用 [**材质预设功能**](#材质预设) 将方块类型包装为 **方块材质** ，就像在涂鸦软件中选择一个色值一样。每种方块类型即是色值的一种。
+
+在一个作品中，可能存在着非常多的自定义方块和原有的原版方块，这些方块材质都可以通过 **选择材质** 窗体找到。
+
+![image-20240806141537453](./images/new_docs/A0.png)
+
+通过搜索框，可以快速匹配到想要的方块材质。
+
+![image-20240806142018906](./images/new_docs/A0_1.png)
+
+::: danger 快捷键
+
+可以使用默认快捷键E打开 **选择材质** 窗体。
+
+:::
+
+
+
+## 材质预设
+
+材质预设指的是1个至多10个方块材质的组合。在材质预设中被选中的方块将作为笔刷、地形等工具的材质使用。
+
+::: danger 快捷键
+
+启用一个材质预设时，可以通过主键盘数字键1~0来快速切换当前预设中的材质，应用到工具中。
+
+:::
+
+![](./images/new_docs/A2.png)
+
+### 创建、删除材质预设
+
+我们可以点击预设页签右侧的【+】按钮新增预设，或通过点击预设页签内的【×】按钮删除已存在的预设。
+
+![](./images/new_docs/B19.gif)
+
+### 预设内添加、删除材质
+
+点击材质右侧的【+】按钮，会打开材质选择框，选择好方块后点击【确认】按钮即可应用该方块到材质。想要删除预设中的材质，使用鼠标左键选中该材质后点击窗口右上角的【删除】按钮即可。
+
+::: info 注意
+
+材质方块选择支持指定状态值。详见[这篇文档](./91-方块状态值设置说明.md)。
+
+:::
+
+![](./images/new_docs/B20.gif)
+
+另外还有2个快捷的工具可以帮助您添加材质：
+
+- **吸管：** 可以直接选择地图中已有的方块，应用到材质中。
+- **复制：** 选中一个材质后点击复制按钮，即可创建一个与之完全相同的材质（包括状态值相同）。
+
+![](./images/new_docs/A3.png)
+
+::: info 注意
+
+材质窗口有一个蒙版按钮，用于将当前材质应用到蒙版的快捷操作。是感兴趣的开发者可以阅读[这篇文档](./92-蒙版工具说明.md)了解蒙版的功能。
+
+:::
+
+
+
+## 混合材质
+
+混合材质有助于实现比较多样化的材质效果，避免单一材质应用到笔刷、地形工具后产生过于单一的效果。
+
+**使用方法如下：**
+1. 点击 **添加成分** 按钮，添加更多的方块。
+2. 修改每个方块的占比数值，使所有方块占比相加不超过100%（低于100%将有部分空间被留作空气。
+3. 直接使用笔刷或地形工具即可看到混合材质的效果。
+
+下图中我们展示了使用混合材质制作一条更加真实的石路效果。
+
+![](./images/new_docs/B21.gif)
+
+
+
+## 下一步：笔刷工具
+
+现在您已经学习了材质选择的所有功能，包括如何添加材质预设、改变方块材质、混合方块材质等。
+
+在下一节中，您将学习如何使用笔刷工具在地图中绘制想要的方块。学习结束时，您会重新将它们用于搭建基础地形、建造建筑框架。

mcguide/14-地图制作/6-笔刷工具.md

@@ -0,0 +1,216 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/e789927f-c71d-4218-a89d-8902fa4da1ad.png
+hard: 入门
+time: 15分钟
+selection: 60
+---
+
+# 笔刷工具
+
+使用笔刷工具，您可以直接在地图中快速生成指定形状的方块。笔刷首先需要指定材质，这需要用到上一篇介绍的[材质选择](./5-材质选择.md)功能。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **笔刷工具** 。
+
+
+
+下面将逐一展示当前地图编辑器支持的笔刷类型。
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+- [材质工具](./5-材质选择.md)
+
+
+
+## 单点笔刷
+
+单点笔刷用于放置单个方块。
+
+![](./images/new_docs/A4.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+
+
+
+## 立方体笔刷
+
+立方体笔刷用于生成一个立方体形状，可指定该立方体在XYZ上的边长，同时可根据需要生成中空立方体、去除上下底面的中空立方体（可用于生成围墙）、立方体框架等。
+
+![](./images/new_docs/A5.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|笔刷尺寸|输入立方体在XYZ三轴上的边长。|
+|结构选项|① 实心：生成实心立方体。<br/>② 中空：生成空心立方体，搭配“厚度”参数可指定外壳部分厚度。<br/>③ 去除底面：去除除立方体的上下底面，仅剩四周的4个面，支持配置“厚度”。<br/>④ 仅框架：仅保留立方体框架结构，框架的粗细可使用“厚度”参数指定。
+|厚度|用于指定中空、去除底面情况下的面的厚度，以及仅框架情况下的框架粗细。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+
+
+
+## 球体笔刷
+
+用于生成一个球体，当半球体包围盒XYZ三个轴上的尺寸参数配置不等时，即生成椭球体。可根据需要生成空心球。
+
+![](./images/new_docs/A6.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|笔刷尺寸|输入球体的包围盒在XYZ三轴上的边长。当三个数值不完全相等时，即生成椭球体。|
+|结构选项|① 实心：生成实心球体。<br/>② 中空：生成空心球体，搭配“厚度”参数可指定外壳部分厚度。
+|厚度|用于指定中空情况下的球壳厚度。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+
+
+
+## 半球体笔刷
+
+用于生成一个球体，当半球体包围盒在X轴、Z轴上的边长不同时等于Y轴边长的2倍时，生成非标准半球体。可根据需要生成空心半球体、去除底面的空心半球体（可用于生成穹顶等）。
+
+![](./images/new_docs/A7.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|笔刷尺寸|输入**默认状态下**半球体的包围盒在XYZ三轴上的边长。当X轴、Z轴上的数值不同时等于Y轴数值的2倍时，生成非标准半球体。<br/>对于半球体默认状态指的是以+Y为放置方向的状态。改变放置方向后会出现XYZ数值与实际游戏内笔刷包围盒在XYZ轴上的三边不一样的情况。|
+|结构选项|① 实心：生成实心半球体。<br/>② 中空：生成空心半球体，搭配“厚度”参数可指定外壳部分厚度。<br/>③ 去除底面：去除半球体的底面，仅剩半球形外壳，支持配置“厚度”。|
+|厚度|用于指定中空、去除底面情况下的球壳厚度。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置方向|即半球切面正对的方向。共6种选项：+X，+Y，+Z，-X，-Y，-Z。|
+
+
+
+## 圆柱笔刷
+
+用于生成一个圆柱体，当圆柱体包围盒在X轴、Z轴上的边长不相等，生成一个椭圆柱体。可根据需要生成空心圆柱体、去除上下底面的空心圆柱体（可用于生成围墙、空心柱子等）。
+
+![](./images/new_docs/A8.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|笔刷尺寸|输入**默认状态下**圆柱体的包围盒在XYZ三轴上的边长。当X轴、Z轴上的数值不同时，生成椭圆柱体。<br/>对于圆柱体默认状态指的是以Y轴为放置方向的状态。改变放置方向后会出现XYZ数值与实际游戏内笔刷包围盒在XYZ轴上的三边不一样的情况。|
+|结构选项|① 实心：生成实心圆柱体。<br/>② 中空：生成空心圆柱体，搭配“厚度”参数可指定侧面厚度。<br/>③ 去除底面：去除圆柱体的上下底面，仅剩侧面，支持配置“厚度”。|
+|厚度|用于指定中空、去除底面情况下的厚度。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置方向|即与圆柱两地面中心点连线平行的轴。共3种选项：X，Y，Z。|
+
+
+
+## 圆锥笔刷
+
+用于生成一个圆锥体，当圆锥体包围盒在X轴、Z轴上的边长不相等，生成一个椭圆锥体。可根据需要生成空心圆锥体、去除底面的空心圆锥体（可用于生成建筑尖顶等）。
+
+![](./images/new_docs/A16.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|笔刷尺寸|输入**默认状态下**圆锥体的包围盒在XYZ三轴上的边长。当X轴、Z轴上的数值不同时，生成椭圆锥体。<br/>对于圆锥体默认状态指的是以+Y轴为放置方向的状态。改变放置方向后会出现XYZ数值与实际游戏内笔刷包围盒在XYZ轴上的三边不一样的情况。|
+|结构选项|① 实心：生成实心圆锥体。<br/>② 中空：生成空心圆锥体，搭配“厚度”参数可指定侧面厚度。<br/>③ 去除底面：去除圆锥体的上下底面，仅剩侧面，支持配置“厚度”。|
+|厚度|用于指定中空、去除底面情况下的厚度。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置方向|即与圆柱两地面中心点连线平行的轴。共3种选项：X，Y，Z。|
+
+
+
+## 多棱柱笔刷
+
+用于生成一个多棱柱。与之前的笔刷类型不同的是，多棱柱笔刷仅能生成底面为正多边形的多棱柱，并且以底面外接圆半径和边数，来定义多棱柱底面的大小和形状。可根据需要生成空心多棱柱、去除上下底面的空心多棱柱（可用于生成围墙、柱子等）。
+
+![](./images/new_docs/A15.png)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|外接圆半径|底面外接圆圆心到任意顶点的距离，为1~999之间的整数。|
+|底面边数|底面多边形的边数，为1~100之间的整数。|
+|高度|多棱柱的高度，为1~300之间的整数。|
+|结构选项|① 实心：生成实心多棱柱。<br/>② 中空：生成空心多棱柱，搭配“厚度”参数可指定侧面厚度。<br/>③ 去除底面：去除多棱柱的上下底面，仅剩侧面，支持配置“厚度”。|
+|厚度|用于指定中空、去除底面情况下的厚度。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置方向|即与圆柱两地面中心点连线平行的轴。共3种选项：X，Y，Z。|
+|旋转角度|笔刷相对于0°的顺时针旋转度数，取值范围0-360°|
+
+
+
+## 素材笔刷
+
+素材笔刷用于直接将素材库中保存的自定义素材和编辑器内置素材直接作为笔刷形状，刷在地图中，从而大大减少我们的操作步骤，提升素材复用效率。
+
+![](./images/new_docs/B35.gif)
+
+**笔刷参数**
+|参数名|参数说明|
+|:---|:---|
+|素材|通过下拉框选择笔刷需要以哪个素材为形状。|
+|连续生成间距|在输入框中输入正整数，以指定当鼠标拖动多少格距离后生成一个笔刷形状。|
+|直线生成|勾选后，先单击一个坐标A，然后单击另一个坐标B，就会在以AB两点为端点的线段上生成笔刷形状。|
+|覆盖原方块|若勾选，则笔刷形状生成的方块会覆盖地图上位置重叠的已有方块。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置基点|① 停靠：笔刷形状会贴着鼠标选中的方块生成，比如鼠标选中方块的上表面，则笔刷形状生成在该方块上方，鼠标选中方块的下表面，则笔刷形状生成在方块下方。<br/>② 居中：会以选中的方块作为中心生成笔刷形状。<br/>③ 向上：会以选中的方块作为下顶点生成笔刷形状。<br/>④ 向下：会以选中的方块作为上顶点生成笔刷形状。|
+|放置方向|即与圆柱两地面中心点连线平行的轴。共3种选项：X，Y，Z。|
+|旋转角度|笔刷相对于0°的顺时针旋转度数，共有0°、90°、180°、-90°四种选项。|
+
+
+
+## 拼图方块笔刷
+
+拼图方块笔刷主要用于在地图中快捷放置自定义大型特征中的拼图方块（线锯方块），通过可视化的属性编辑和放置，减少我们在游戏模式手动设置拼图方块参数的繁琐操作，详情可以参考[自定义大型特征](../20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.md)。
+
+![图片](./images/jigsawblock.gif)
+
+|参数名|参数说明|
+|:---|:---|
+|类型|代表拼图方块的三种主要使用场景，类型1.目标方块：代表这个拼图方块所在的结构是放在目标池内的结构，被动等待其他【源】类型的拼图方块来拼接，这种类型的拼图方块会被省略掉【目标池】和【目标方块】属性；类型2.源方块，代表这个拼图方块会主动从目标池抽取结构，并且试图寻找对应的目标方块进行拼接，与目标方块相反，这个类型的拼图方块会被省略掉【名称】属性；类型3.自定义方块：实际上一个拼图方块既可以作为目标方块也可以作为源方块，即自定义方块可以是源方块和目标方块的并集，自定义拼图方块所有属性都可以自定义，但使用难度会比较高。|
+|名称|此拼图方块的名称，默认值为"minecraft:empty" 。|
+|目标池|此拼图方块用于选取结构的结构池,结构池的定义可查看[结构池配置](../20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.md#_1-4-2-结构池配置),默认值为"minecraft:empty",即为空。|
+|目标名称|当结构从目标池中生成时希望对接的拼图方块的名称，默认值为"minecraft:empty"。|
+|变为|指的是拼图方块在成功对接并且结构被放置后会转变的方块，默认值为"minecraft:air"，即空气。|
+|放置方向|即拼图方块箭头所指的方向，只有箭头相对才能被视作拼接成功。|
+|接点类型|只在拼图方块朝上或朝下时有效。1.可滚动：生成时，拼图方块会随机将目标结构置于与该拼图方块处于同一XZ轴的结构方块的边界内，即对接的结构会随机绕Y轴旋转。默认为此类型。2.固定：生成时，拼图方块会直接把目标结构或实体置于自身所朝的方向（上方或下方），即不会随机绕Y轴旋转，可用于连接结构。|
+
+
+
+## 下一步：地形工具
+
+现在您已经了解了笔刷工具，它可以在地图区域内进行精细的局部修改。而地形工具则适用于大范围的地形调整和造景。
+
+在下一节中，您将学习如何使用地形工具来修改地图的高度、坡度和地形形状等方面。

mcguide/14-地图制作/7-地形工具.md

@@ -0,0 +1,167 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/d8691720-1a4f-4d52-9fc4-8567f54fd553.png
+hard: 入门
+time: 10分钟
+selection: 50
+---
+
+# 地形工具
+
+地形工具用于对地图整体地形进行调整，例如让某块区域隆起、凹陷、平滑等等。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **地形工具** 。
+
+
+
+::: info 提示
+
+大部分地形工具的设置都会用到下列几种参数：
+
+| 参数名         | 参数说明                                                     |
+| :------------- | :----------------------------------------------------------- |
+| 操作区域       | 可以选择地形工具影响的范围，有球体范围和立方体范围两个选项。 |
+| 区域直径       | 正整数，用于指定操作区域的直径。                             |
+| 强度           | 正整数，取值范围1~10。指定每秒进行几次操作（数值越高越快）。 |
+| 不影响流体方块 | 指定地形操作是否会影响到已有的水或岩浆方块。                 |
+
+:::
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+- [材质工具](./5-材质选择.md)
+- [笔刷工具](./6-笔刷工具.md)
+
+
+
+## 隆起
+
+让指定区域内的方块向相机所在位置隆起1格。
+
+![](./images/new_docs/B22.gif)
+
+## 凹陷
+
+让指定区域内的方块向远离相机的方向凹陷1格。
+
+![](./images/new_docs/B23.gif)
+
+## 侵蚀
+
+去掉突出的方块。
+
+![](./images/new_docs/B24.gif)
+
+## 平滑
+
+去掉突出的方块，填充凹陷的区域，让选中区域变得更加平滑。
+
+![](./images/new_docs/B25.gif)
+
+## 填充
+
+填充凹陷的区域和空洞。
+
+![](./images/new_docs/B26.gif)
+
+## 顶层覆盖
+
+顶层覆盖功能是3个子效果的集合：
+
+- **顶层覆盖：** 在选中区域顶部覆盖若干层[材质预设](./5-材质选择.md#材质预设)窗口中选定的材质。层数可指定。
+  
+
+![](./images/new_docs/B27.gif)
+
+- **顶层替换：** 将选中区域顶部若干层方块替换为[材质预设](./5-材质选择.md#材质预设)窗口中选定的材质。层数可指定。
+
+![](./images/new_docs/B28.gif)
+
+- **表层替换：** 不限于顶层，可替换侧面方块，但仅可替换1层。
+
+![](./images/new_docs/B29.gif)
+
+## 植被工具
+
+植被工具用于在地图中放置植被特征（feature）。并且支持范围放置。
+
+![](./images/new_docs/A23.png)
+
+### 单点放置
+
+将 **模式** 选项切换到 **单点模式** 后，您可以通过一次点击尝试放置一个指定类型的植物特性。
+
+
+![](./images/new_docs/B36.gif)
+
+### 范围放置
+
+选择 **范围模式** 后，您可以通过一次点击在鼠标选定的区域内生成多个植物特性。可以通过调整`操作区域`和`区域直径`参数来设置所选区域的大小，通过`密度`参数来调整区域内植被的生成密度。
+
+`密度`参数与所选区域内生成点的期望个数 E(n) 的关系如下：
+
+<span style="color:#138ad0;">E(n) = [密度数值] × [选区内包含的格数] / 100</span>
+
+结果**四舍五入**取整。
+
+![](./images/new_docs/B37.gif)
+
+::: danger 注意
+
+1. 密度数值也会影响指定区域内植物feature的生成。在<span style="color:#E53333;">所选区域面积较小的情况下，密度数值过低将无法生成植物</span>。
+
+2. 您可以根据自身需求调整密度参数。通常情况下，对于较矮的树木（例如普通尺寸的橡树、白桦树等），密度设置为5已经相当茂密，过高的密度可能会影响玩家的正常游戏体验。
+
+3. 如果传入的`区域直径`和`密度`参数过小，导致无法生成有效的feature，预览窗口上方将弹出以下提示。
+
+   ![](./images/new_docs/A21.png)
+
+:::
+
+
+
+### 植被类型选择
+
+植被工具支持原生游戏中大部分植被feature的放置生成，开发者可以先选择 **类型** ，然后在 **子类型** 中选择详细的子类型。
+
+![](./images/new_docs/A22.png)
+
+::: danger 注意
+
+1. 植被工具能否如预期生成指定的植物类型，取决于<span style="color:#E53333;">原生游戏的特性生成逻辑</span>。如果引擎判定该植物feature无法在指定位置生成，则不会生成。
+
+2. 部分具有特殊生成方块要求的植被feature已添加提示。这些子类型选项后面会显示一个感叹号标志，您可以将鼠标悬停在上面查看提示文本。
+
+   ![](./images/new_docs/A18.png)
+
+3. 如果所选的植被类型无法在指定区域内生成，预览窗口上方将弹出以下提示。
+
+   ![](./images/new_docs/A20.png)
+
+4. 由于原生游戏引擎的限制，部分植被在放置后无法撤销。这些子类型已添加提示文本，请您谨慎使用这些植被特性。生成后，如需清除，需手动操作。
+
+   ![](./images/new_docs/A19.png)
+
+:::
+
+
+
+## 大型结构
+
+大型结构工具用于在地图中放置预配置的结构池，以生成相应的大型结构，便于在编辑器中快速验证结构池配置的正确性。有关结构池的定义，请参阅[结构池配置](../20-玩法开发/15-自定义游戏内容/4-自定义维度/6-自定义大型特征.md#_1-4-2-结构池配置)。
+
+![图片](./images/placelargefeature.gif)
+
+
+
+## 下一步：素材库、结构与剪贴板
+
+在下一节中，您将学习如何使用素材库、结构与剪贴板功能。这些工具可以帮助您便捷地批量复制和存储某一区域的方块，并在另一位置复用。掌握这些功能后，您将能够高效管理和重复使用各种地图元素，从而提升地图编辑效率和创作自由度。

mcguide/14-地图制作/8-素材库、结构与剪贴板.md

@@ -0,0 +1,224 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/8059bc9b-1eb0-410d-83aa-9d539ddc44f2.png
+hard: 入门
+time: 10分钟
+selection: 40
+---
+
+# 素材库、结构与剪贴板
+
+素材库、结构、剪贴板三个功能可以更便捷地对一个范围内的所有方块进行批量复制、存储，并在另一处位置复用。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **素材、结构保存与使用** 。
+- 如何使用 **剪贴板** 。
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+- [材质工具](./5-材质选择.md)
+
+
+
+## 素材库
+
+素材库是地图编辑器的一个重要功能，它可以保存方块为素材，并在同一作品内的其他位置，或同一设备上的不同作品进行重复利用，大大提升地图制作效率。
+
+
+
+### 素材的保存与使用
+
+使用选取工具选择好需要保存的方块后，可右键包围盒选择 **保存为素材** 按钮将选区内方块结构存入素材库长期使用。
+
+![image-20240808105420844](./images/new_docs/B40.png)
+
+保存时可以修改素材名称，同时也可以指定是否需要保存空气、流体方块。
+
+![image-20240808105501855](./images/new_docs/B41.png)
+
+::: info 素材文件存储位置
+
+素材数据保存在.mdl文件中，默认存储路径位于 `AppData\Roaming\Sunshine\Temp\Genesis\ModelPrefab\CustomModel`文件夹下。
+
+:::
+
+
+
+要将保存好的素材文件放置到地图中，只需要在 **素材库** 窗口单击需要放置的素材，即可在地图中通过左键单击放置，连续单击可以放置多个。
+
+![](./images/new_docs/B42.gif)
+
+
+
+#### 放置前的二次编辑
+
+在素材摆放到地图中但未确认生成时，可进行二次编辑，包括位移、旋转、缩放、翻转等操作。
+
+如下图所示，点击左键将`boxdata1`素材摆放进地图，此时移动鼠标时会发现素材形状仍在渲染。因为素材可连续摆放，您目前处于连续放置状态。
+
+![image-20240808142505697](./images/new_docs/B31.png)
+
+**<font color="#ee5a49">点击鼠标右键结束放置状态</font>**，此时移动鼠标不会显示素材形状渲染。**<font color="#ee5a49">左键单击刚放置的素材（此时有包围盒）表示选中，即可进行编辑操作。</font>**
+
+![image-20240808142851921](./images/new_docs/B32.png)
+
+此时可对选中的素材进行编辑操作，如位移、旋转、翻转、缩放等。调整完毕后，点击 **确定生成** 即可。
+
+![](./images/new_docs/B43.gif)
+
+对于已放置的多个素材，取消放置状态后，可左键点击不同素材分别进行调整，操作与上述一致。
+
+![](./images/new_docs/B44.gif)
+
+
+
+#### `.mdl`素材文件的导入与导出
+
+素材`.mdl`文件可以导出到电脑的指定位置，也可以从其他路径导入编辑器以供地图编辑使用。
+
+鼠标右键点击自定义素材库或素材库中的素材，选择 **导出** 即可将该素材`.mdl`文件导出到任意位置。
+
+![image-20240809113509562](./images/new_docs/A11.png)
+
+点击素材库窗口 **自定义素材** 分页的 **导入** 按钮，即可从本地选择`.mdl`文件导入编辑器作为素材使用。
+
+![image-20240809113837527](./images/new_docs/A12.png)
+
+
+
+#### 导入模型为素材
+
+素材库 **自定义素材** 分页的 **导入** 按钮还可以导入模型作为素材。
+
+<img src="./images/new_docs/B45.png" alt="image-20240809153950363" style="zoom:120%;" />
+
+当前地图编辑器支持的模型类型有：`.obj`、`.fbx`、`.3ds`、`.ply`、`.stl`。
+
+如果模型本身自带贴图，编辑器会读取其颜色，并做简单的颜色匹配，生成彩色素材。
+
+MC中可以与贴图颜色对应的方块有限，开发者可以在模型生成后按需要使用 **替换** 工具进行进一步的方块调整。
+
+![](./images/new_docs/A10.png)
+
+
+
+#### 应用素材到预设
+
+您可以将素材导入为预设素材，这样在预设编辑器就可以将素材挂接到预设上。
+
+![image-20240809140556305](./images/new_docs/A13.png)
+
+在预设编辑器打开一个空预设后，可以点击工具栏的 **添加素材** 按钮，将刚刚在地图编辑器中保存的素材导入到预设中。
+
+![image-20240809140745481](./images/new_docs/A14.png)
+
+
+
+## 结构
+
+### 结构的保存
+
+使用选取工具创建选区后，右键选区点击 **保存为结构**，即可将包围盒选择范围内的方块保存为结构`.mcstructure`文件。
+
+![](./images/new_docs/B34.gif)
+
+保存时有如下选项可以选择：
+
+- **包含实体：** 保存的结构数据文件中将包含实体(动态,可移动)对象信息。
+
+- **去除空气方块：** 生成的结构数据文件中将不包含空气方块信息。
+
+- **保存为网易版优化结构：** 在文件尺寸和性能上做出一定优化。
+
+- **切分结构：** 会按照选择的结构边长，将结构切分成多个结构数据文件，适用于大范围的方块信息保存。
+
+::: info 切分结构
+
+切分结构生成的结构文件在当前作品的 行为包的`structures/命名空间` 文件夹下 。
+
+:::
+
+
+
+
+### 结构的使用
+
+保存的结构可在素材库窗口的 **结构** 分页找到。可以直接像摆放素材一样，通过鼠标点击将结构摆放至场景中。
+
+::: danger 注意
+
+需注意的是，【结构】分页仅会显示当前作品中的结构文件，并不会像素材一样可以跨作品使用。
+
+结构同样也可以连续摆放，并且支持[在放置前进行二次编辑](#放置前的二次编辑)。
+
+:::
+
+
+
+另外，我们也可以使用结构方块，输入对应结构文件所在文件夹和文件名称来使用此结构。
+
+![](./images/1611577352671.png)
+
+如果选择了切分结构，将选择范围内的方块生成多个结构文件保存，则会同时生成对应的各个结构文件基础坐标的配置信息。
+
+![](./images/1611578367866.png)
+
+![](./images/1611578584871.png)
+
+解析此配置文件，通过`ModSDK`的<a href="../../mcdocs/1-ModAPI/接口/世界/地图.html#placestructure" rel="noopenner"> PlaceStructure </a>接口在脚本中设置对应的坐标和结构文件名称信息，即可在对应维度地图中生成还原出保存的地图数据。
+
+
+
+## 剪贴板
+
+剪贴板用于存放复制的选区方块。
+
+::: danger 素材库与剪贴板的区别
+
+- 素材库内容会长期储存，可以应用到同一个开发者账号、同一台设备上的全部地图作品中。
+- 剪贴板内容仅为临时储存，将在关闭编辑器后被清除。
+
+:::
+
+
+
+使用选取工具框选一个区域后，按下 **复制** 或 **剪切** 按钮，即可将选区方块保存到剪贴板。剪贴板可存储多个内容。新的内容会顶下旧的内容，显示在粘贴板的最上方。您可以左键点击选择需要的内容，再在地图中左键点击需要粘贴的位置，即可完成粘贴。
+
+
+
+![](./images/new_docs/B30.gif)
+
+::: info 剪贴板
+
+剪贴板内容同样也可以连续摆放，并且支持[在放置前进行二次编辑](#放置前的二次编辑)。内容可重新命名，方便辨识。
+
+:::
+
+
+
+剪贴板内容可以直接导入素材库使用。只需要在剪贴板中右键点击一个内容，选择 **添加到素材库** ，即可在素材库窗口中的 **自定义素材** 分页找到它。
+
+![image-20240809153824383](./images/new_docs/A9.png)
+
+
+
+## 记住上次配置
+
+保存结构时，可以记住上次的配置。例如：勾选**“去除空气”**并记住该配置后，下次保存结构时无需重复选择同类选项。减少重复勾选步骤，提升开发效率。
+
+![image-20240809153824383](./images/new_docs/B47.gif)
+
+
+
+## 下一步：方块状态值设置说明
+
+在下一节中，您将学习如何使用方块状态值设置功能来配置笔刷、填充和替换工具所用的方块材质状态值。
+
+这些状态值决定了方块的外观和行为，使得建筑更具多样性与美观性。

mcguide/14-地图制作/91-方块状态值设置说明.md

@@ -0,0 +1,81 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/a099e669-7013-4b97-b5b3-9d057613e070.png
+hard: 入门
+time: 10分钟
+selection: 30
+---
+
+# 方块状态值设置
+
+方块状态值进一步定义了方块的外观和行为。通过设置方块状态值，您可以在地图中快速生成指定形状的方块。
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 基础操作—— **方块状态值设置** 。
+
+
+
+下面来具体看下方块状态值设置功能是如何使用的吧！
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+- [材质工具](./5-材质选择.md)
+
+
+
+## 材质预设状态值设置
+
+首先，创建一个新的材质预设。在 **选择材质** 窗口中，选择一个带有多种状态值的方块，可以看到窗口右下角出现了 **状态值设置** Tab。
+
+展开Tab，我们可以看到当前所选方块的可配置状态值，直接通过下拉选框调整即可修改所选方块的状态值，并应用到材质预设中。
+
+![](./images/B1.gif)
+
+- 从上图的示例中可看出，混合材质中的每个材质都能进行单独的状态值编辑。
+- 方块贴图无法直接反映状态值变化。为方便判断混合材质中的每个材质，当鼠标悬停在混合材质面板的某个方块上时，提示框将展示该方块的具体状态值配置。
+
+配置好的材质预设可以应用到笔刷、填充等多个功能，并且能够保留其中的状态值设置。
+
+
+
+## 填充工具状态值设置
+
+填充工具的方块选择也可以使用状态值设置进行精确调整。
+
+您可以直接使用在材质预设中设置好的预设项进行填充，也可以直接选择需要使用的方块，在下方设置其状态值后直接应用。
+
+![](./images/B2.gif)
+
+
+
+## 替换工具状态值设置
+
+在引入了状态值之后，不同状态值的同种方块在替换窗口会分别显示，这样可以单独对其中一种状态值进行替换处理，而不影响其他状态值的该方块。
+
+您可以将鼠标悬停在左侧窗口的方块上，查看提示框上显示的状态值信息，判断是否是自己需要替换的状态值。
+
+![](./images/B3.gif)
+
+
+
+## 其他说明
+
+- 材质预设窗口的 **吸管** 、 **复制** 工具均会保留方块状态值信息。
+- 工具栏中的 **方块统计** 功能会将不同状态值的同种方块合并统计，而不会每种状态值单独统计。
+
+
+
+## 下一步：蒙版工具
+
+使用地形与笔刷工具，您可以调整地图的地形与方块区域。但是，有时您不希望对整个区域进行全局调整，而希望对特定区域进行校正。
+
+例如，您在使用地形工具时，只希望对地图里的草方块进行修改而不影响其他方块。要在地图编辑器里进行局部校正，就需要使用蒙版工具。
+
+您已经走得很远了，坚持下去！

mcguide/14-地图制作/92-蒙版工具说明.md

@@ -0,0 +1,173 @@
+---
+front: https://nie.res.netease.com/r/pic/20221221/d7f1b4f3-162d-4f21-a6f6-be2feeb563f0.png
+hard: 进阶
+time: 15分钟
+selection: 20
+---
+
+# 蒙版工具说明
+
+在本指南中，您将学会：
+
+- 如何使用 **地图编辑器** 进阶操作—— **蒙版工具** 。
+
+
+
+下面就一起来看看蒙版工具的使用方法吧！
+
+
+
+## 要求
+
+建议在开始本指南之前先了解以下内容。
+
+- [地图编辑器使用说明](./2-地图编辑器使用说明.md)
+- [选取工具](./3-选取工具.md)
+- [编辑工具](./4-编辑工具.md)
+- [材质工具](./5-材质选择.md)
+- [笔刷工具](./6-笔刷工具.md)
+- [地形工具](7-地形工具.md)
+
+
+
+## 什么是蒙版
+
+蒙版可以用来限制开发者地图编辑操作的生效对象。蒙版一共有2种：
+
+
+
+### 对以下方块生效
+
+地图编辑操作仅会修改蒙版成分中的方块。例如当您希望笔刷只会覆盖掉地图里的草方块而不影响其他的方块，就可以使用这种蒙版。
+
+![](./images/B7.gif)
+
+### 对以下方块不生效
+
+地图编辑操作仅会修改除蒙版成分中方块以外的其他方块。例如当你希望你的顶层覆盖操作不影响到你的石头小路，只覆盖旁边的其他方块时，就可以使用这种蒙版。
+
+![](./images/B8.gif)
+
+
+
+## 蒙版基础设置
+
+### 蒙版工具栏选项
+
+打开地图编辑器，在顶部工具栏即可找到【蒙版】按钮。点击【蒙版】按钮，会在次级工具栏显示蒙版选项。
+
+![](./images/A1.png)
+
+- **蒙版开关**：勾选框，用于启用或关闭蒙版功能。
+- **蒙版模式**：下拉选框，共有两个可选项，【对以下方块生效】和【对以下方块不生效】。
+- **蒙版成分**：当前蒙版中包括的方块。
+- **更多设置**：对蒙版的更详细配置，点击即会打开蒙版设置窗口。
+
+::: info 提示
+
+蒙版开启状态会在预览窗左上角显示。![](./images/A2.png)
+
+:::
+
+
+
+### 蒙版设置窗口
+
+蒙版设置窗口允许开发者对蒙版进行更详细的配置。除了工具栏中已有的【蒙版开关】和【蒙版模式】两项外，在设置窗口中还可以进行对蒙版成分方块的直接增删。
+
+
+
+#### 增加蒙版成分
+
+想要为蒙版成分中增加更多方块，只需要在下方搜索、选择到相应的方块，点击下方蓝色【添加】按钮即可。选择完毕后点击【关闭】按钮即可立即生效蒙版改动。
+
+::: info 提示
+
+蒙版工具支持对成分中方块的状态值进行详细设置。例如你可以选择进包含上下颠倒的橡木楼梯方块。
+**不同状态值 ** 的 **同种** 方块将在【当前蒙版包含的方块】一栏分别列为不同的成分方块。
+
+:::
+
+![](./images/B4.gif)
+
+
+
+#### 删除蒙版成分
+
+只需要在 **当前蒙版包含的方块** 一栏中再次点击想要删除的方块，即可将其从蒙版成分中删除。
+
+![](./images/B5.gif)
+
+
+
+### 材质预设应用至蒙版
+
+您可以直接将材质预设中选好的方块组合直接一键应用至蒙版成分设置。只需要点击吸管工具左侧的 **应用为蒙版** 按钮即可将当前蒙版的成分设置为所选方块预设里的全部方块。
+
+::: danger 注意
+
+方块预设里包含百分比信息，但是应用为蒙版成分后不会生效。即使在方块预设中某个方块的百分比为0%，它仍然会被应用至蒙版成分中。
+方块预设应用为蒙版会保留方块预设中每个方块的状态值设置。
+
+:::
+
+![](./images/B6.gif)
+
+
+
+## 蒙版与其他工具的配合使用
+
+蒙版是一个全局控制选项，当蒙版开启后，会对地图编辑器中所有能够产生方块修改的操作生效，所以您需要根据自己的需要，在合适的情况下使用蒙版工具。
+
+### 笔刷与地形
+
+我们在[前文](#什么是蒙版)中已通过动图的形式举例过蒙版在笔刷与地形操作中的应用。
+在进行笔刷或地形操作时，蒙版次级工具栏同样会显示出来，方便开发者直接对蒙版进行快捷配置，而不需要进行多余的切换步骤。
+
+![](./images/A3.png)
+
+
+
+### 填充
+
+蒙版开启后，会对开发者的【填充】操作生效。
+1. 当蒙版模式为【对以下方块生效】时，填充操作不会修改选区中非蒙版成分的方块。
+2. 当蒙版模式为【对以下方块不生效】时，填充操作不会修改选区中的蒙版成分方块。
+
+
+
+### 替换
+
+蒙版开启后，会对开发者的【替换】操作生效。被蒙版判定为不可修改的方块，在替换窗口中不可点击。
+
+![](./images/B9.gif)
+
+### 橡皮
+
+蒙版开启后，被蒙版判定为不可修改的方块，不会被橡皮工具擦除。
+
+
+
+### 编辑
+
+蒙版在编辑操作中的应用可能会有些反直觉，您需要了解其中的原理，从而确定是否要在编辑操作时开启蒙版。
+
+举个例子：尝试将下面这个选区中的桦木板方块向上移动。我们将蒙版设置为“仅对桦木板方块生效”，然后开始移动操作。
+
+![](./images/B10.gif)
+
+从上图中可发现，我们点击确定生成后，桦木板方块直接消失了，有悖于我们的直觉。
+
+主要的原因是：MC中无法直接对方块进行偏移、旋转等操作，而是需要把旧方块删除之后生成新方块，而这又分为2步：① 原方块的删除；② 新方块的生成。
+
+在第①步中，蒙版生效，仅会删除桦木板方块。在第②步中，蒙版生效，我们尝试在新的位置生成桦木板失败了，因为新的位置当前是空气，我们尝试用桦木板方块替换这里的空气方块时会被蒙版阻止，导致生成失败。所以最终的表现就是仅仅删除了旧的桦木板方块而没有在移动后的新位置生成新的桦木板方块。
+
+类似的情况还可能发生在进行旋转、伸缩、翻转等操作时。
+
+
+
+### 其他
+
+除了上述工具外，其他任何对方块产生修改的操作都会受到蒙版工具的影响，例如素材库的素材放置等。
+
+![](./images/B11.gif)