同步官网文档8m_25d

mconline/15-玩法组件教程/0-使用我的世界开发工作台制作第一个玩法/0-摘要.md

@@ -0,0 +1,15 @@
+---
+front: https://nie.res.netease.com/r/pic/20211104/69055361-2e7a-452f-8b1a-f23e1262a03a.jpg
+hard: 入门
+time: 5分钟
+---
+
+# 摘要
+
+在本章的学习中，你将学到如何使用**我的世界开发工作台**（**MC Studio**）创建一个自定义合成**配方**（**Recipe**）的玩法组件。
+
+- 在第一节（*新建第一个空白基岩版组件作品*）中，你将接触到何为我的世界开发工作台，并学习开发工作台的界面。通过对开发工作台的简单操作，你将成功创建你的第一个空白基岩版组件作品。这意味着你已经成功迈出了我的世界玩法创作的第一步！
+- 在第二节（*使用配方配置自定义新的合成配方*）中，通过开发工作台中的简单可视化界面，你将学习如何通过**配置**（**Configuration**）功能新建一个自定义合成配方。通过一系列易于上手的操作，合成配方的自定义将不在话下。
+- 在最后一节（*保存并运行玩法*）中，你将学习到如何运行和自测一个玩法组件。这将有助于你在今后的日子里更加有力地编写和调试自己的模组！
+
+本章关键词：我的世界开发工作台 玩法组件 自定义配方 命名空间 配置 编辑器 自测

mconline/15-玩法组件教程/0-使用我的世界开发工作台制作第一个玩法/1-新建第一个空白基岩版组件作品.md

@@ -0,0 +1,34 @@
+---
+front: https://nie.res.netease.com/r/pic/20211104/69055361-2e7a-452f-8b1a-f23e1262a03a.jpg
+hard: 入门
+time: 10分钟
+---
+
+# 新建第一个空白基岩版组件作品
+
+**我的世界开发工作台**（**MC Studio**）是一个集成了开发者启动器、地图编辑器、关卡编辑器、逻辑编辑器、特效编辑器、云端测试平台等功能的一体化开发工具。它极易上手的操作和简单易懂的可视化界面能够为我们的开发工作提供极大的便利。
+
+接下来，我们通过我的世界开发工作台，为我的世界基岩版制作第一个玩法组件作品！
+
+## 下载我的世界开发工作台
+
+我的世界开发工作台可以在我的世界开发者官网（[https://mc.163.com/dev/](https://mc.163.com/dev/)）下载。进入官网，点击“下载我的世界开发工作台”即可开始下载。下载完成后点击安装包开始安装并等待安装完成。
+
+![我的世界开发者官网](./images/1.1_official_dev_website.png)
+
+安装完成后桌面即会出现“**我的世界开发者启动器**”的快捷方式。双击打开，在登陆界面中输入开发者账号密码进行登录，便可以查看到我的世界开发工作台的主界面了。
+
+![我的世界开发工作台新闻页面](./images/1.1_mc_studio_main_screen.png)
+
+## 新建组件
+
+在上图中我们可以看到，窗口左侧有一个竖排导航栏，这里是我的世界开发工作台的诸多功能的选项卡。我们点击“+新建”按钮，跳转到新建组件页面。
+
+![我的世界开发工作台新建页面](./images/1.1_mc_studio_new_screen.png)
+
+此处的**组件**（**Component**）指代的便是可以作为一个作品而独立存在的模组和地图文件的集合。我们只需要点击“**空白地图**”或“**空白AddOn**”便可以新建一个基岩版空白组件。当然，等你熟悉了组件的结构之后，你也可以通过下方的各种**模板**来快速生成一些具备一定初始功能的组件。此处我们只希望建立一个空白的不包含地图的组件，即空白的**附加包**（**Add-on**）组件，所以我们点击上方的“空白AddOn”按钮。此时我们看到了一个弹出窗口：
+
+![新建空白附加包](./images/1.1_new_component_configurating.png)
+
+根据你的需要进行配置之后，点击“启动编辑”，即可打开我的世界开发工作台的**编辑器**（**Editor**）。此时，我们便已经成功新建了一个空白的附加包组件啦！之后，你便可以在这个空白的组件上大展拳脚，充分发挥你的想象力和技术力，开始你的我的世界开发之旅！
+

mconline/15-玩法组件教程/0-使用我的世界开发工作台制作第一个玩法/2-使用配方配置自定义新的合成配方.md

@@ -0,0 +1,109 @@
+---
+front: https://nie.res.netease.com/r/pic/20211104/69055361-2e7a-452f-8b1a-f23e1262a03a.jpg
+hard: 入门
+time: 15分钟
+---
+
+# 使用配方配置自定义新的合成配方
+
+接下来我们使用关卡编辑器来添加一个自定义配方。不过在在此之前，我们首先需要熟悉一下编辑器的界面和编辑器的新旧之别。
+
+## 新旧编辑器
+
+长久以来，我的世界开发工作台都使用的编辑器都是现在被称作旧版编辑器的一款软件。在最新的版本中，我们引入了新版编辑器，该编辑器是旧版编辑器的一个重构，引入了旧版编辑器的大部分功能，同时优化了很多功能，使得模组的开发更加便捷与高效。
+
+旧编编辑器的初始化页面：
+
+![旧编编辑器的初始化页面](./images/1.2_level_editor_init_screen.png)
+
+新编编辑器的初始化页面：
+
+![新编编辑器的初始化页面](./images/1.2_new_level_editor_init_screen.png)
+
+### 将组件作品升级为新版编辑器作品
+
+在上一节的末尾，我们的操作将默认打开旧版编辑器。而为了使我们的作品开发更加有效，在接下来的教程中我们将使用新版编辑器进行讲解。所以我们需要把我们的作品升级为新版编辑器作品。我们首先切换到“**最近**”标签页，如图所示，这里有我们刚刚创建的组件作品。
+
+![我的世界开发工作台最近页面](./images/1.2_mc_studio_recent_screen.png)
+
+点击“**编辑**”按钮，点击“**升级作品**”，并在弹出的对话框中点击“**确定**”。之后开发工作台会自动创建一个同名的新版作品，并打开该作品。之后，你便可以使用新版编辑器进行作品编辑了！
+
+![作品编辑对话框](./images/1.2_recent_screen_component_edit.png)
+
+![升级警告对话框](./images/1.2_upgrade_warning.png)
+
+在返回到“最近”标签页时，你可以看到新版作品的周围带有绿色边框，并标注有“新版”字样。
+
+![新版作品](./images/1.2_mc_studio_recent_screen_with_new_editor.png)
+
+## 命名空间
+
+接下来我们希望添加一个自定义配方。但是在添加配方之前，我们有一个不得不需要理解的概念，那就是**命名空间**（**Namespace**）。每个模组都具有且必须具有至少一个命名空间。命名空间就像一个身份证号一样，他保证了模组与模组之间就算有重名的项目出现，也可以互不干扰，互相可以分辨得开。
+
+你也可以把命名空间比作文件夹。不同的文件夹中就算出现同名的文件，他们依旧可以共存。但是如果没有了文件夹，那么相同命名的文件之间就会出现冲突，出现要么只能保留一个，要么就要有一个文件妥协而改名的尴尬处境。因此，给自己的模组一个合适的命名空间是非常必要的。
+
+### 更改命名空间
+
+我的世界开发工作台的编辑器提供了一个快速更改命名空间的功能。打开新版编辑器，在编辑器顶部的导航栏点击：作品 -> 命名空间，即可打开更改命名空间的对话框。
+
+![作品 -> 命名空间](./images/1.2_navigation_namespace.png)
+
+命名空间实质上是一个标记你所创作的内容所有权的标识符，所以在给你的命名空间起名字时，我们建议使用英语单词配合下划线的方式进行命名。在本教程中，为了行文统一，我们使用`tutorial_demo`作为命名空间。如果你正在跟随本教程进行实践操作，不必拘泥，请尽情地使用你自己想用的命名空间。只需记住一点，命名空间要尽可能的独特和唯一，只有这样才能把你的作品和其他人的作品更好地区分开来。
+
+![输入命名空间](./images/1.2_modify_namespace.png)
+
+## 配置
+
+在新版编辑器中，我们引入了**配置**（**Configuration**）功能。它默认在关卡编辑器窗口的左下角。
+
+![配置子窗口](./images/1.2_configuration_subwindow.png)
+
+但此时配置是空的，因为我们还没有创建过任何配置。因此我们需要在“**资源管理**”窗口内通过“**新建**”功能来创建新的配置。
+
+![资源管理 - 新建](./images/1.2_resource_management_new.png)
+
+一个配置是一系列有关某个功能的文件的集合。通过对配置的修改，可以实现相关文件的自动修改和自动匹配。这使得复杂的文件变得可视化和有序化。我们在“新建文件向导”对话框中选中“**配置**”选项卡。然后选择一个你想要创建的配置，即可通过向导完成一个配置的创建。
+
+![配置选项卡](./images/1.2_new_file_wizard_config.png)
+
+### 创建新的合成配方
+
+我们回归到本节的正题，通过配置功能创建一个自定义合成**配方**（**Recipe**）。我们只需要在上图窗口中选择“配方”配置，即可进入新建自定义配方的向导。我们可以看到，这里有两个功能，第一个是选择**数据模板**（**Data Template**）。数据模板是编辑器内置的已经有一些初始数据的配置，如果选择数据模板，即意味着你可以在一个已经设置了一些属性的配置的基础上继续进行操作。我们选择“**空**”，即创建一个完全空白的配方配置。第二个功能是给配方**命名**（**Naming**）。如同刚才所述的命名空间代表着模组的唯一标识，这里的名字代表着该配方的唯一标识。给它起一个好名字有助于之后再次看到它时能够迅速回忆起其内容，也有助于避免配方之间的冲突。谨记，命名只能使用英文、数字和下划线，且对大小写不敏感，因此`Aa`和`aa`本质上是相同的名字，所以建议所有的字母都采用小写。这里我们使用`recipe_demo`来代表这个演示用的配方。你可以根据自己的喜好与习惯对其赋予任意的命名。
+
+![新建自定义配方](./images/1.2_recipe_config_wizard.png)
+
+我们可以看到，配置会为我们自动创建一个叫做`<命名空间>_<配方名>.json`的文件，这是该配置所对应的数据文件。命名空间的存在使其有效避免了与其他模组的同名配方的冲突。
+
+在创建配方配置后，我们便可以在“配置”窗口和“属性”窗口下看到我们刚创建的配方了。如果你成功地看到了如下界面，那么恭喜你，你已经成功创建了一个空白的自定义配方！现在我们只需要把该配方稍加完善即可得到我们想要的结果！
+
+![完成配方配置的创建](./images/1.2_post-creation_of_recipe.png)
+
+### 给配方添加属性
+
+目光转移到屏幕右侧，我们看到了配方的属性栏。在此我们可以更改我们刚才新创建的配方的属性。
+
+![配方属性栏](./images/1.2_recipe_property.png)
+
+**配方类型**代表着配方的适用情况。
+
+- **有序合成**是类工作台配方的一种。对于这种类型的配方，玩家必须摆出和配方的形状一模一样的物品组合时，才会合成出对应物品。在原版中只适用于工作台。
+- **无序合成**也是类工作台配方的一种，但是只要合成网格中对应的物品及其数目满足要求即可合成出对应的结果，无需形状如何。在原版中，除了工作台，这种配方还适用于制图台和切石机等方块。
+- **熔炉配方**代表着类熔炉配方，熔炉、高炉、营火、烟熏炉等都适用于此类配方。
+
+**配方构造**中的网格代表配方的输入物品和形状，点击网格中的槽位，即可弹出一个可视化物品选择器。通过浏览和搜索，你可以选择任意的原版方块和在我的世界开发工作台中自定义的方块作为槽位物品。这对开发者非常有帮助。
+
+![资源选择器](./images/1.2_resource_pickup_dialog.png)
+
+**配方结果**代表着配方的输出物品。你依旧可以通过点击其右侧文件夹形状的图标来进入物品选择器，从而选取对应的配方结果。**结果数量**即对配方进行一次合成产出的物品数目。
+
+### 示例：可合成的命名牌
+
+我们将配方属性调整至如下所示：
+
+![可合成的命名牌](./images/1.2_craftable_nametag.png)
+
+即可在游戏中获得一个可合成的命名牌。
+
+![可合成的命名牌配方](./images/1.2_craftable_nametag_recipe.png)
+
+恭喜你！你已经熟练掌握了自定义合成配方的制作！但是，这还不代表着万无一失。你还没有保存和在游戏内进行测试。下一节我们将一起学习如何保存并自测玩法组件。

mconline/15-玩法组件教程/0-使用我的世界开发工作台制作第一个玩法/3-保存并运行玩法.md

@@ -0,0 +1,63 @@
+---
+front: https://nie.res.netease.com/r/pic/20211104/69055361-2e7a-452f-8b1a-f23e1262a03a.jpg
+hard: 入门
+time: 15分钟
+---
+
+# 保存并运行玩法
+
+及时保存玩法是开发过程中非常重要的一环。只有养成及时保存的习惯才能避免自己的心血成果因各种不确定因素而丢失的情形发生。而在保存之后，我们也需要通过实机测试来确保自己的玩法真正有效地加入了游戏。
+
+## 保存玩法
+
+我们在编辑器的右上角，可以看到有几个全局按钮。我们只需点击“**保存**”按钮，便可以启动组件的保存程序。
+
+![编辑器右上角](./images/1.3_editor_top-right_save.png)
+
+如果见到如下提示弹窗，说明你已经保存成功了。你可以安心地继续你的创作，或者稍微暂停离开椅子休息一下了。
+
+![保存成功](./images/1.3_save_successfully.png)
+
+## 运行和自测
+
+只在编辑器中进行操作，终归不是真实的游戏体验。在你的作品分发到千千万万玩家手中之前，确保玩法不会出现纰漏最好的办法就是打开游戏进行实测。我的世界开发工作台便提供了这一功能。
+
+### 电脑开发版自测
+
+在我的世界开发工作台中，最简单的运行和自测方式便是使用**我的世界基岩版电脑开发版**（即**Mod PC开发包**）进行自测。你有两种进入电脑开发版的方式。
+
+#### 编辑器内直接进入
+
+不要退出编辑器，目光定位到右上角。我们可以看到一个“**运行**”按钮。点击运行按钮，你的玩法组件将自动保存，同时系统开启我的世界基岩版电脑开发版，自动进入一个加载着你的玩法组件的存档进行测试。
+
+![运行按钮](./images/1.3_editor_top-right_run.png)
+
+#### 从主界面进入
+
+在我的世界开发工作台中找到“**最近**”或“**作品库**”标签页，找到你的作品。将鼠标移至“**开发测试**”按钮。
+
+![开发测试按钮](./images/1.3_mc_studio_lib_screen_dev_test.png)
+
+点击开发测试按钮将会弹出一个开发测试对话框。进行一定配置后点击“**开始**”按钮，即可达到和从编辑器内进入相同的效果——成功进入我的世界基岩版电脑开发版进行测试。
+
+![开发测试对话框](./images/1.3_dev_test_dialog.png)
+
+### 手机开发版自测
+
+**我的世界基岩版手机开发版**自测需要我们先将组件发布至云端。之后我们便可以从手机开发版下载进行测试。我们将鼠标移动至地图或组件作品上，点击“**更多**”按钮。
+
+![更多按钮](./images/1.3_mc_studio_lib_screen_more.png)
+
+之后点击“**发布**”按钮。根据发布资源的流程依次填写好相关内容，点击保存，再点击提交审核。当作品处于“审核中”的状态时，便可以在手机开发版中访问到该作品。
+
+![发布按钮](./images/1.3_release.png)
+
+#### 下载和进入手机开发版启动器
+
+在我的世界开发工作台上找到“**管理**”标签页。找到顶部“**开发者内容管理工具**”一栏中的“**测试版启动器下载**”。点击该按钮，在弹出的对话框中会出现两个二维码，分别是iOS版本和Android版本的手机开发版启动器下载链接。使用对应的手机扫码下载、安装，即可得到手机开发版启动器应用程序。
+
+![管理标签页](./images/1.3_mc_studio_management_screen_test_launcher_download.png)
+
+![下载开发版的对话框](./images/1.3_test_launcher_download.png)
+
+在我的世界基岩版手机开发版中打开你发布的组件，即可进入地图测试啦！