2.6

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程01.MCSTUDIO功能简介.md

@@ -0,0 +1,13 @@
+---
+front: https://nie.res.netease.com/r/pic/20210730/4ce20d4e-a4af-4d1f-a28a-036b122f1802.png
+hard: 入门
+time: 5分钟
+---
+
+# MCSTUDIO功能简介
+
+#### 作者：境界
+
+
+
+MC Studio是集开发者启动器、地图编辑器、关卡编辑器、逻辑编辑器、特效编辑器、云端测试平台等功能于一体的开发工具，能够为《我的世界》开发者开发和发布作品提供极大的便利。其中对初级开发者而言，关卡编辑器和地图编辑器是容易上手且轻松就能制作出玩法的工具，我们将在这一章程教给大家如何使用这两种编辑器。

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程02.关卡编辑器.md

@@ -0,0 +1,41 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/2_1.f5da27b0.png
+hard: 入门
+time: 10分钟
+---
+
+# 关卡编辑器
+
+#### 作者：境界
+
+
+
+关卡编辑器是配置和管理附加包（Add-on）的中心，能够自定义维度、生物、物品、方块、配方等内容，通过组合这些游戏元素，形成自己独特的玩法。
+
+对于不同阶段的开发者来说，使用关卡编辑器的推荐方式也不一样。
+
+新手阶段：通过组件来搭建玩法，熟悉各种自定义游戏元素。
+
+熟手阶段：通过关卡编辑器的资源管理了解Addon的文件构成，研究组件的功能实现原理，在组件的基础上尝试做一些文件级别的修改。
+
+高手阶段：使用关卡编辑器快速搭建玩法原型，之后做深度的文件修改。
+
+
+
+#### 各个模块的简单介绍
+
+![](./images/2_1.png)
+
+菜单栏：“作品”中可设置Add-on的命名空间，“脚本”中可安装Mod SDK的脚本提示库，“窗口”中可设置不同分项窗口的可见性。左上角蓝色区域可以将MCStudio的关卡编辑器、地图编辑器、特效编辑器、界面编辑器它们来回切换。
+
+组件：配置自定义的游戏元素，比如物品、生物、方块等等；通过不同的组件搭配形成玩法，上方的“添加组件”可以视为一个快捷按钮。
+
+属性：当选择“组件”中的内容时，在属性面板中会显示相应的组件属性参数。
+
+游戏内容：游戏内容运行着《我的世界》模拟玩家游戏环境，可编辑生物、坐标等，结果会实时反馈回游戏内。
+
+舞台：显示当前游戏区域中的生物实体，也可以快捷定位到游戏内正存在的生物实体。
+
+资源窗口：管理作品内的文件，通过双击文件图标可以打开文件， 文件格式转换的入口也都在这里。
+
+快捷操作：包含“保存”、“备份”、“运行”等按钮，可快速保存、备份、测试玩法。

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程03.使用组件.md

@@ -0,0 +1,181 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/3_1.3aa1459a.png
+hard: 进阶
+time: 40分钟
+---
+
+# 使用组件
+
+#### 作者：境界
+
+
+
+<img src="./images/3_1.png" style="zoom:150%;" />
+
+① 通过点击“添加组件”按钮，或是在组件区域内点击鼠标右键，就会弹出组件选项来添加组件。
+
+
+
+![](./images/3_2.png)
+
+② 对单个组件点击右键，可以看到组件的简介内容。
+
+
+
+![](./images/3_3.png)
+
+③添加完组件后，右下角的属性面板将会出现被添加组件的属性参数。
+
+
+
+### 各类组件介绍
+
+#### 世界类目：
+
+世界类目：包括相机和地形改变相关的组件，详细组件说明如下：
+
+①基础组件：该组件可以设置世界选项、作弊选项等，与在游戏客户端中的设置-选项里的内容无差。许多地图玩法中，可能会需要一个总是白天的地图，或者不刷怪的地图，这时就可以在这里进行设置了。
+
+②相机组件：该组件可以设置玩家的视角，游戏中带有三种视角，第一人称视角、第三人称后视角、第三人称前视角，即组件选项中的原版视角。而改为俯视角时，玩家视角会被改成第三人称视角，并且视角角度可以自由定义，例如MOBA游戏中的俯视角，2D平面跑酷的侧视角，都可以实现。默认情况下，切换为自定义视角时，应不允许玩家切换视角。
+
+③资源点：该组件可以设置世界中的某个位置不断生成资源道具，风靡全球的MC小游戏起床战争就用到了资源点的理念。
+
+④地图复原：该组件可以设置在创建游戏时或开始游戏时保存一片区域的方块，在结束游戏时进行场景复原。当场景内会由玩家因素造成场地破坏时，就可以用到这个组件。
+
+⑤安全区：该组件可以将一个随时间向内聚拢的方形区域外的方块设置成其他方块，适合需要引导玩家向内移动的诱因玩法。如，在出生点周围100格外，不断向内涌入岩浆，直到比赛分出胜负时停止。
+
+
+
+#### 维度类目：
+
+维度类目：包括生物群系、自定义特征、生物生成规则等维度相关的功能，详细组件说明如下：
+
+①自定义维度：该组件可以创建一个除主世界、下界、末地以外的新维度。由于群系设定下，新的维度的群系与主世界的群系呈对应关系，因此在没有自定义新维度群系的情况下，主世界与新维度的地貌相差无几。
+
+②自定义群系：该组件可以创建一个在新维度中的群系。在网易版自定义群系中，群系必须继承原版群系，无法添加自定义新群系，且只能作用于新维度中。地形高度栏目下，可以设置群系的高度，在一般情况下使用原版的预设种类即可。若对于地形生成算法小有研究的开发者，亦可以尝试使用随机参数来自定义群系高度。地表栏目下，可以设置一个群系从下层到上层的方块种类。生成规则会控制群系在不同温度下的生成概率，在我的世界中，每个地图种子会被划分为海洋和陆地，并决定不同地区的温度，就好像地球上的温带一样，不同温带下的群系会呈现出不同的地形及气候等特征。不仅如此，当群系遇到高度变化时，可以设置要被转化的群系。如平原遇到山地变化时，会生成森林和森林丘陵。海洋遇到岸滨变化时，会生成沙滩和平原。最后，群系标签可以将指定的自定义名称标签加入到自定义群系中，用来作为新生物出现的群系条件，这个会在生成规则组件中做额外说明。
+
+③自定义生物生成规则：该组件可以创建一个新的生物生成规则。顾名思义，新的规则是用来划分生物可以出现的条件。其中，生物必须来自生物组件所创建的自定义生物，若开发者想要使用该组件来设置手动写的自定义生物的生成规则，可以简单生成一个模板生物后，引用该自定义生物，并在附加包文件内将identifier字段指向的生物ID改为手动写的生物ID。
+
+④自定义特征：该组件可以创建一个新的自定义特征，特征可以用来自定义地下矿簇、地表植物树木等，原版世界里稀有的化石堆、苔石堆，都用到了特征功能。当前编辑器只支持将地图编辑器导出的方块结构转化成特征，如需了解更多自定义特征功能，请参考minecraft wiki或游戏客户端目录/data/definitions/features文件夹。
+
+⑤自定义特征规则：该组件可以创建一个新的特征规则，用来划分编辑器所创建的自定义特征的生成规则。生成时机用来决定特征出现的时机，原版世界中，花草树木一般在表层时机出现，矿物在地下时机出现。指定群系标签可以让特征出现在带有对应群系标签的群系内，该标签适用自定义群系内的标签。分布状态有均匀分布和所有区块分布，所有区块分布下，特征会在满足群系条件的情况下，尝试在每个区块都生成一次。均匀分布下，特征会在满足群系条件的情况下，尝试在多个区块间隔下生成。
+
+⑥自定义传送门：该组件可以设置一个通向另一个维度的传送门。当前编辑器只允许设置立式传送门，即类似下界传送门。一般可容纳玩家穿过的传送门高度在4格宽，5格高。传送门方块需要使用自定义方块进行额外定义，才会从下拉选项内弹出选项。
+
+
+
+#### 玩家类目：
+
+玩家类目：包括技能、排行榜等和玩家相关的功能，详细组件说明如下：
+
+①基础属性：该组件可以快速设置玩家的基础属性，并将最后结果生效于进入世界的全部玩家身上。
+
+②初始物品：该组件可以在玩家进入游戏时给予指定出生道具。
+
+③初始装备：该组件可以在玩家进入游戏时自动穿戴指定装备。
+
+④有限复活：该组件可以设置玩家能够复活的次数，当超过复活次数时，会被传送到游戏区域外，非常适合用来制作带有有限复活条件的地图玩法。
+
+⑤技能：该组件可以简单地自定义一些基础型的技能，目前可以定义给予状态效果技能，和发射弹射物技能。
+
+⑥个人排行榜：该组件可以追踪一些玩家数据并对其进行排行，显示在游戏地图内。
+
+⑦旧版初始物品：该组件可以通过填写对应的原版物品ID，让玩家进入游戏时得到指定的出生道具，若希望给予自定义物品，请使用初始物品功能。
+
+⑧旧版初始装备：该组件可以通过填写对应的原版物品ID，让玩家进入游戏时得到穿戴指定的原版装备，若希望给予自定义装备，请使用初始装备功能。
+
+
+
+#### 生物类目：
+
+生物类目：用于添加自定义生物，详细组件说明如下：
+
+①生物：该组件可以添加自定义生物，创建自定义生物时，会在资源包和行为包上生成几个文件，而生物行为最终会放置在行为包/entites文件夹内。目前生物功能不支持添加自定义的生物模型、动画，以及更复杂的生物行为组合，但使用该功能可以快速生成生物模板，方便熟练的开发者在之后进行文本级的深度自定义。除此之外，当开发者需要放置自定义生物到地图内时，需要先点击左侧组件中的坐标符号将放置功能解锁，方可放置生物至指定位置。
+
+
+
+#### 物品类目：
+
+物品类目：用于添加食物、工具、装备、武器等自定义物品，详细组件说明如下：
+
+①普通物品：该组件可以添加自定义的普通道具、生物蛋道具、消耗性道具等。
+
+②武器和工具：该组件可以添加自定义的剑武器和基于四种原版工具的新工具。
+
+③盔甲：该组件可以添加对应玩家四个装备槽的自定义装备。同时，若开发者越来越熟练后，可以使用文本级的编辑将装备换成自定义3D模型版本的装备。
+
+
+
+#### 方块类目：
+
+方块类目：用于添加自定义方块，详细组件说明如下：
+
+①自定义方块：该组件可以添加自定义的基础方块、刷怪笼方块和传送门方块。除此之外，当开发者需要放置自定义方块到地图内时，需要先点击左侧组件中的坐标符号将放置功能解锁，方可放置方块至指定位置。
+
+
+
+#### 配方类目：
+
+配方类目：用于添加自定义配方，详细组件说明如下：
+
+①自定义配方：该组件可以添加自定义的熔炉配方和工作台配方。支持将配方的合成材料或结果产出设置为由物品组件和方块组件添加的自定义物品或者方块。
+
+
+
+#### 队伍类目：
+
+队伍类目：用于添加队伍配置，详细组件说明如下：
+
+①队伍：该组件可以添加队伍并对队伍内的成员进行分数跟踪。
+
+
+
+#### 经济类目：
+
+经济类目：可配置掉落、交易、商店等物品流通相关的功能，详细组件说明如下：
+
+①货币：该组件可以为地图玩法上的玩家新增流通的货币单位。
+
+②掉落：该组件可以为自定义生物添加上自定义的掉落物。掉落物内可以包含多个物品的随机组合，支持自定义物品、装备、方块等。
+
+③交易：该组件可以为自定义生物添加上类似村民的交易列表。
+
+④出售商店：该组件可以为地图上正在被加载的实体添加上出售商店的功能。
+
+⑤购买商店：该组件可以为地图上正在被加载的实体添加上购买商店的功能。
+
+
+
+#### 剧情类目：
+
+剧情类目：可配置对话和任务，详细组件说明如下：
+
+①对话：该组件可以为地图上的实体添加对话选项，基于多个条件下，出现对话的时机也都可以不同。
+
+②任务：该组件可以为地图上的实体添加可被玩家领取的任务。领取任务时，会对开发者提供多种领取条件的自定义属性，和任务完成时的道具奖励。
+
+
+
+#### 流程类目：
+
+流程类目：包括开始游戏、结束游戏等控制游戏流程的组件，详细组件说明如下：
+
+①开始游戏：该组件可以为地图玩法添加开始游戏的条件。满足组件属性内自定义的多个条件后，游戏才会开始。
+
+②结束游戏：该组件可以为地图玩法添加结束游戏的条件。满足组件属性内自定义的多个条件后，游戏才会结束。
+
+
+
+#### 玩法元素类目：
+
+玩法元素类目：包括塔防、起床战争等特定玩法所需的组件，详细组件说明如下：
+
+①床：该组件可以为一个队伍内的成员设置一个公共出生点的坐标，当床被破坏时，可以自定义成员被淘汰后所在的位置，主要对应起床战争的内容。
+
+②塔防大本营：该组件可以设置玩家需要保护的大本营，主要对应塔防玩法。
+
+③攻击手：该组件可以设置自定义的塔防单位为玩家保护大本营，主要对应塔防玩法。
+
+④生物点：该组件可以设置自定义的生物点坐标，利用地形的设计加上巡逻路径组件，可以设置一条塔防玩法中敌对生物的移动路径。
+
+⑤巡逻路径：该组件可以为生物点的生物设置一条行径路径，主要对应塔防玩法。

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程04.资源管理：转化方块模型.md

@@ -0,0 +1,26 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/4_1.f0b4b002.png
+hard: 进阶
+time: 10分钟
+---
+
+# 资源管理：转化方块模型
+
+#### 作者：境界
+
+
+
+在下方的资源管理列表里，会存在一个常用目录的折叠选项，对models选项进行右键，可以看到有转化Blockbench Java方块模型的选项。点击进去选择提前存好的bbmodel工程文件即可。
+为了让开发者能够少踩一些坑，这里收集了一些常见的无法导入的报错信息，方便开发者自己检查。
+
+
+
+<img src="./images/4_1.png" style="zoom:150%;" />
+
+①该模型不是一个有效的自由模型项目：虽然选项上写的是Blockbench Java方块模型，但开发者需要在创建模型时将工程文件选择为自由模型工程，才能满足导入的要求。并且Java版方块模型的旋转角度是有限制的，使用自由模型时则没有旋转角度的限制。
+
+
+
+![](./images/4_2.png)
+
+②该模型的贴图不是16x16大小，由于16*16的方块贴图对于游戏资源占用最小，官方建议开发者对方块模型的贴图尺寸进行更好的优化，从而将贴图限制在16x16。但有一些小技巧可以让超过16x16分辨率的模型被转化成功，即打开blockbench的工程文件，点击文件->项目，将贴图高度和宽度设置为16x16即可。但为了避免给低配终端玩家带来不好的游戏体验，这里还是建议开发者对方块贴图进行尺寸修改。

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程05.地图编辑器.md

@@ -0,0 +1,22 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/5_1.1b182f91.png
+hard: 入门
+time: 15分钟
+---
+
+# 地图编辑器
+
+#### 作者：境界
+
+
+
+地图编辑器是针对基岩版（C++版）的地图编辑工具，界面分为提供基础功能的菜单栏、集成各种工具及属性的工具栏、进行地图绘制修改的操作区三个部分。
+
+目前地图编辑器提供了笔刷工具、地形工具、橡皮工具、选取工具等等常用的便捷工具，开发者可以通过这些工具在操作区像使用绘图软件一样，对地图存档进行修改与绘制。本章节会简单地为组件开发者提供如何导出特征结构的方法，方便将其应用到自定义特征当中。
+
+
+
+![](./images/5_1.png)
+
+进入地图编辑器时，默认工具会选择选取工具，若当前工具不是选取工具，可以点击便捷工具栏改变工具类型，接着选取完区域范围后，点击保存为结构，为其命名一个名称即可。
+

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程06.简易教学①：制作新颜色的玻璃方块.md

@@ -0,0 +1,23 @@
+---
+front: https://nie.res.netease.com/r/pic/20210730/4ce20d4e-a4af-4d1f-a28a-036b122f1802.png
+hard: 入门
+time: 15分钟
+---
+
+# 简易教学①：制作新颜色的玻璃方块
+
+#### 作者：境界
+
+
+
+①把当前编辑器切换至关卡编辑器，若界面已在关卡编辑器可以不执行此操作。
+
+②在组件面板右键添加方块组件，将渲染材质设置为半透明。
+
+③将新颜色的玻璃贴图通过“资源管理”下的常用目录下textures\blocks，右键点击导入文件，把贴图导入进blocks文件夹即可。
+
+④将玻璃贴图从“资源管理”中拖至“属性栏”模型与贴图的上面方块贴图、下面方块贴图、和侧面方块贴图，其他属性使用默认属性值。
+
+⑤点击自定义方块组件右侧的放置按钮，解锁放置操作，若遇到弹出窗口提示需要重新刷新游戏，点击重新加载即可。
+
+⑥最后点击编辑器右上角的“运行”按钮，在游戏的创造模式建筑分类里面可以找到刚刚添加的自定义方块。

docs/mconline/10-addon教程/第05章：MCSTUDIO功能简介/课程07.简易教学②：制作一条跑酷赛道.md

@@ -0,0 +1,49 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/7_1.6371e1df.png
+hard: 进阶
+time: 30分钟
+---
+
+# 简易教学②：制作一条跑酷赛道
+
+#### 作者：境界
+
+
+
+跑酷赛道示例包下载：下载[示例包](https://g79.gdl.netease.com/guidedemo-case5.zip)。
+
+
+
+<img src="./images/7_1.png" style="zoom:150%;" />
+
+一条跑酷赛道需要至少一个起点和终点，根据赛道的长度，可能还需要添加标记进度点，避免因为跑酷容错率小而浇灭玩家对地图玩法的热情。当玩家从跑酷地图上跌落下去时，应在一定下落高度前将玩家传送回上一个进度点。因此，本小节的简易教学将会使用多种颜色的羊毛作为建筑材料，攻击手为陷阱元素来教开发者如何制作一个不寻常的跑酷赛道。
+
+
+
+![](./images/7_2.png)
+
+①使用粉色羊毛为玩家搭建一个出生点，使用紫色、深蓝色、蓝色、青色、绿色、黄色、橙色羊毛铺起赛道，用红色羊毛作为终点。
+
+
+
+![](./images/7_3.png)
+
+②以搭建高度开始，往下十格以后的高度是会将玩家拉回复活点的高度，该功能需要使用命令方块配合。在粉色区域下方放置一个循环型命令方块。条件设置为无条件，红石选择保持始终开启。将指令内容设置为/tp @a[x=-13,dx=26,y=0,dy=40,z=0,dz=100,m=!c] 0 47 8。这会将筛选出所有玩家中，在x坐标从-13到13，y坐标从40到0，z坐标从0到100且不是创造模式的玩家，传送到起始点。因此在这个范围内的玩家若从跑酷位置掉落后，则会马上被传送到安全位置。传送时会在聊天信息里出现指令结果信息，若希望提示信息消失，可以使用gamerule指令的commandblockoutput、sendcommandfeedback选项设置为false。
+
+③在终点位置的羊毛下方，放置一个循环型命令方块。条件设置为无条件，红石选择保持始终开启。将指令内容设置为/title @a[x=5,dx=-12,y=47,dy=10,z=74,dz=14,m=!c,tag=!success] title 恭喜你完成比赛。这会筛选出在进入红色羊毛区域内的玩家，并对他们发送比赛完成的信息。接着，在该命令方块指向的方向上，放置一个紧贴着该命令方块的连锁型命令方块。条件设置为无条件，红石选择保持始终开启。将指令内容设置为/tag @a[x=5,dx=-12,y=47,dy=10,z=74,dz=14,m=!c] add "success"。根据之前的教程可以知道，当循环型命令方块执行一次比赛完成的title指令后，紧接着会执行连锁型命令方块内的指令，并添加success这个标签，这样循环型命令方块的指令内容只会对该名通关玩家执行一次。
+
+④在拉回玩家的循环型命令方块指向的方向上，放置一个紧贴着该命令方块的连锁型命令方块。条件设置为无条件，红石选择保持始终开启。将指令内容设置为/tag @a[x=-13,dx=26,y=0,dy=40,z=0,dz=100,m=!c] remove "success"。因此，当玩家从赛道跌落后被拉回来时，会尝试清除success标签，达到重复游玩的目的。
+
+⑤在靠近终点位置设立两个橙色羊毛塔，这里将会作为攻击手所在的位置，会对靠近该区域的玩家进行骚扰攻击。
+
+⑥将地图导入至MCSTUDIO，使用组件功能-玩家-基础属性，将玩家复活点设置在粉色羊毛的中心点。
+
+⑦新增生物组件，将生物继承流浪者，资源设置为流浪者，并放大流浪者大小体型，将两种速度皆设置为0，因为我们希望它是站桩输出的远程射手。新增一个名为player标签的攻击类型，这样流浪者会对玩家进行攻击，其他属性由开发者自行决定。
+
+
+
+![](./images/7_4.png)
+
+⑧点击组件-生物-攻击手右侧的位置符号按钮，解锁放置攻击手新生物的功能。将攻击手生物放在两个橙色柱子上，对临近终点的玩家进行骚扰性攻击。
+
+⑨在运行前必须保存当前的制作进度，点击右上角快捷按钮的“保存”按钮后，就可以点击运行进入游戏测试啦！