同步官网文档8m_25d

mconline/10-addon教程/第01章：用MCSTUDIO构建第一个玩法/课程01.认识主界面.md

@@ -0,0 +1,27 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/1_1.dc061f16.jpg
+hard: 入门
+time: 5分钟
+---
+
+# 认识主界面
+
+#### 作者：境界
+
+
+
+预期目标：熟悉MCSTUDIO的部分界面，以及开发一个自定义配方
+
+![](./images/1_1.jpg)
+
+
+
+在开发者官网：[https://mc.163.com/dev/index.html](https://mc.163.com/dev/index.html)，下载MCSTUDIO应用程序进行安装，然后双击MCSTUDIO图标，在登陆界面中输入开发者账号密码进行登录，开发者就可以看到MCSTUDIO的主界面了。
+
+
+
+MCSTUDIO主界面分为上方的信息区域，侧边的导航区域，以及中间的内容区域。你可以在导航区域选择你需要跳转到其他功能页面的按钮。
+
+
+
+作为新手开发者，本章节将引导你如何使用MCSTUDIO制作第一个玩法。

mconline/10-addon教程/第01章：用MCSTUDIO构建第一个玩法/课程02.新建玩法项目.md

@@ -0,0 +1,25 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/2_1.4e93e673.jpg
+hard: 入门
+time: 5分钟
+---
+
+# 新建玩法项目
+
+#### 作者：境界
+
+
+
+![](./images/2_1.jpg)
+
+
+
+进入MCSTUDIO后，系统默认停留在新建内容区域。当前工具只支持创建基岩版地图和基岩版Add-on。在基岩版组件-空白区域内，开发者可以选择创建地图模板或是Add-on模板。
+
+
+
+它们的区别在于，创建地图模板后，你在编辑器内做的玩法，会与地图导出变成一个完整的玩法地图。建立Add-on模板时，最终只会导出Add-on玩法。
+
+
+
+如果是一个新的Add-on玩法，开发者应当选择建立一个空白Add-on模板，点击启动编辑，就可以开始大展拳脚了。

mconline/10-addon教程/第01章：用MCSTUDIO构建第一个玩法/课程03.探索关卡编辑器.md

@@ -0,0 +1,46 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/3_1.32c9600e.jpg
+hard: 入门
+time: 10分钟
+---
+
+# 探索关卡编辑器
+
+#### 作者：境界
+
+
+
+![](./images/3_1.jpg)
+
+
+
+#### 什么是舞台？
+
+舞台是访问当前正出现在地图中的原有内容和新增内容的入口。当玩家出生在出生点附近时，世界会根据群系在玩家周围自然生成新的生物和方块。开发者可以通过舞台看到当前存在的生物种类，点击生物种类的折叠选项，还可以精确选择到某一个生物上，视角摄像机会自动定位到所选中的生物身上。
+
+原有内容是地图中，由游戏世界自然生成的生物。新增内容则是开发者进入编辑器后，用编辑器工具放置的生物。
+在编辑器的中央，是一套内嵌在MCSTUDIO窗口上的游戏界面。开发者可以轻按鼠标左键选择在视角范围内的生物，这与在右侧区域里选择单一生物是同样的效果。因此，游戏世界本身也是舞台。
+
+
+
+#### 移动与转移视角
+
+在MCSTUDIO控制游戏界面内人物的移动方式和在游戏客户端上的方法大致相同。开发者在键盘上按WASD的行走按键控制人物的前后左右移动。
+
+鼠标左键可以选择生物，鼠标右键可以旋转视角，鼠标中键滑轮可以拉伸视距。
+
+如果双击空格，视角则会像创造模式下的玩家一样上升，按住shift键则会下降。
+
+如果视角未移动，请将光标移向游戏界面区域即可。
+
+
+
+#### 调试、保存与备份
+
+当游戏界面处于编辑模式时，开发者是无法作为一个玩家与世界产生互动的。
+
+这时候若想调试，就需要点击运行按钮。它会带领你进入游戏模式，及时获得玩法的测试反馈。
+
+保存按钮提供保存功能，你也可以同时按住CRTL+S进行快捷的进度保存。
+
+备份按钮提供克隆功能，它会将正在制作的内容再克隆一份。开发者可以稍后在主页面的基岩版组件中找到。

mconline/10-addon教程/第01章：用MCSTUDIO构建第一个玩法/课程04.自定义一种新的配方.md

@@ -0,0 +1,91 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/4_4.347fdf50.jpg
+hard: 入门
+time: 10分钟
+---
+
+# 自定义一种新的配方
+
+#### 作者：境界
+
+
+
+#### 通过编辑器新建配方
+
+![](./images/4_1.jpg)
+
+移动鼠标点击添加组件，选择配方组件。
+
+
+
+![](./images/4_2.jpg)
+
+配方组件默认会自带一个新增配方，若开发者需要新增更多配方，点击配方组件右侧的“+”号按钮即可新增配方。
+
+
+
+#### 了解配方的各个属性
+
+配方名称只会在编辑器的组件区域显示。因此掌握良好的命名习惯可以帮助开发者在下次进入编辑器时快速回忆起配方的功能。
+
+![](./images/4_3.jpg)
+
+自定义ID是世界注册配方的唯一标识，若存在两个以上的配方标识一致，关联的配方会加载失败。因此命名可读性强的ID可以避免这一情况。注意：ID应以下划线/数字/英文为主，且对大小写不敏感，因此Aa和aa相同，开发者应以小写加下划线的格式为规范，例如：a_A，配方类型目前支持编辑有序合成、无序合成、熔炉配方。其中有序合成、无序合成适用在工作台中，熔炉配方适用于熔炉、高炉、篝火等中。
+
+有序配方代表玩家需要按照格子顺序放好材料，工作台才会合成出配方道具。
+
+无序配方代表玩家只需在格子上放好材料，工作台就会合成出配方道具。
+
+配方结果是配方合成成功后，合成出的道具类型。
+
+结果数量决定合成出的道具数量为几个。
+
+
+
+#### 新建配方：可合成的命名牌
+
+命名牌是游戏前期很难获得的道具，它只能在钓鱼、村民交易、和世界中的宝箱中找到。它可以给生物命名，防止生物被世界刷新掉。现在，通过MCSTUDIO的配方组件，开发者可以添加新配方来获得它。
+
+![](./images/4_4.jpg)
+
+
+
+新增一个配方组件，将默认的配方名称改为自定义配方：命名牌。
+
+这里将自定义ID改为crafting_custom_nametag，开发者也可以输入自己认为可读性强的ID命名。
+
+配方类型选择有序配方，适用方块选择工作台。
+
+![](./images/4_5.jpg)
+
+
+
+以上图例为配方构造示范，点击对应的网格，可以打开资源选择窗口。最快的方法是通过输入材料名称作为关键词搜素，选择好材料后，点击确认即可。
+
+![](./images/4_6.jpg)
+
+点击配方结果右侧的文件夹按钮，打开资源选择窗口再选择命名牌。
+
+
+
+#### 新建配方：可合成的生物蛋
+
+生物蛋是只有在创造模式下才能获得的道具。手持生物蛋点击方块可以生成一个对应的生物。现在，通过MCSTUDIO的配方组件，开发者可以添加新配方来获得它。
+
+新增一个配方组件，将默认的配方名称改为自定义配方：村民蛋。
+
+这里将自定义ID改为crafting_custom_villager，开发者也可以输入自己认为可读性强的ID命名。
+
+配方类型选择无序配方，适用方块选择工作台。
+
+![](./images/4_7.jpg)
+
+以图例为配方成分示范，点击对应的“+”号按钮，选择成分右侧的文件夹按钮，可以打开资源选择窗口。最快的方法是通过输入材料名称作为关键词搜素。选择好材料后，点击确认即可。
+
+
+
+![](./images/4_8.jpg)
+
+
+
+点击配方结果右侧的文件夹按钮，打开资源选择窗口选择生成村民。

mconline/10-addon教程/第01章：用MCSTUDIO构建第一个玩法/课程05.自测玩法，并在手机上运行它.md

@@ -0,0 +1,31 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/5_3.8964e499.jpg
+hard: 入门
+time: 10分钟
+---
+
+# 自测玩法，并在手机上运行它
+
+#### 作者：境界
+
+
+
+#### 自测玩法
+
+![](./images/5_1.jpg)
+
+点击运行，编辑器会弹出客户端窗口，开发者就可以测试本地玩法了。
+
+在玩法测试前，请记得随时保存当前的制作进度，避免遇到进度丢失的问题。
+
+
+
+#### 在手机上运行Add-on
+
+![](./images/5_2.jpg)
+
+点击最近选项，你会看到刚刚制作的组件。鼠标移动到组件上点击更多，再点击发布，选择新建项目。接着根据发布资源的流程依次填写好相关内容，点击保存，再点击自测或提交审核。
+
+![](./images/5_3.jpg)
+
+然后在MCSTUDIO-管理-测试版启动器下载手机版测试包，开发者就可以在手机测试版上体验到自己做的第一个玩法了。