2.6

docs/mconline/10-addon教程/第18章：打包导出你的作品/课程01.包体的结构和导入.md

@@ -0,0 +1,404 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/1_1.dc5d5f44.jpg
+hard: 进阶
+time: 20分钟
+---
+
+# 包体的结构和导入
+
+
+
+#### 作者：境界
+
+
+
+包体也被称为Package，它是由开发者将本地的JAVA版资源内容和基岩版资源内容进行压缩打包后的档案。在中国版开发者平台拿到上传的包体后，通过机器审核和人工审核后，包体最终会被推送至公共下载服务器。最后再由玩家下载后压缩包后，经客户端解压才能玩到组件资源。
+
+在上传至平台前，开发者应确保在本地开发的内容达到了预期的运行效果。并遵照本章的打包方式进行压缩打包，降低机器审核的打回概率或审核时间。
+
+
+
+### 认识JAVA包体结构
+
+#### PC地图
+
+
+
+![](./images/1_1.jpg)
+
+
+
+1) 截图截选了我的世界JAVA版1.12.2游戏客户端生成的世界存档的内容。test文件夹下存放着名为test的世界信息。
+
+![](./images/1_2.jpg)
+
+
+
+2) 打开这个客户端可以看到test存档。
+
+![](./images/1_3.jpg)
+
+
+
+3) 返回到目录的上一级，saves文件夹下则会存放着这个客户端可以启动的所有存档文件夹，其中就有前面提到的test存档。
+
+![](./images/1_4.jpg)
+
+
+
+4) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择地图。【适用MC版本】选择对应存档本版。若支持多个版本可以选择多个相应版本。
+
+![](./images/1_5.jpg)
+
+
+
+5) 点击导入窗体内的+号按钮，直接选择test文件夹后点击选择文件夹。
+
+![](./images/1_6.jpg)
+
+
+
+6) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的存档文件夹。
+
+![](./images/1_7.jpg)
+
+
+
+7) 开发者不通过MCSTUDIO而选择自行打包时，请将存档文件夹使用7Z压缩工具打包成一个后缀为7z的压缩文档。再通过开发者平台进行上传操作。
+
+
+
+#### PC MOD
+
+![](./images/1_8.jpg)
+
+
+
+1) 上传平台的MOD文件必须以jar格式作为分发给玩家游玩的标准文件格式。
+
+![](./images/1_9.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择Mod。【适用MC版本】选择对应存档本版。若支持多个版本可以选择多个相应版本。
+
+![](./images/1_10.jpg)
+
+
+
+3）点击导入窗体内的+号按钮，直接双击或选择jar文件后选打开。
+
+![](./images/1_11.jpg)
+
+
+
+4) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的jar文件。
+
+![](./images/1_12.jpg)
+
+![](./images/1_13.jpg)
+
+
+
+5) 开发者不通过MCSTUDIO而选择自行打包时，请将jar文件放入一个文件夹内，将文件夹用7z压缩工具压缩成7z后缀格式的压缩包。再通过开发者平台上传组件资源源文档。
+
+
+
+#### PC 材质
+
+![](./images/1_14.jpg)
+
+
+
+1) 截图主要展示JAVA版材质的目录和文件结构。
+
+![](./images/1_15.jpg)
+
+
+
+2) 直接将材质文件夹内的内容全部选取后右键保存成zip压缩文档。
+
+![](./images/1_16.jpg)
+
+
+
+3) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择材质。【适用MC版本】选择对应存档本版。若支持多个版本可以选择多个相应版本。
+
+![](./images/1_17.jpg)
+
+
+
+4) 点击导入窗体内的+号按钮，直接双击或选择zip文档后选打开。
+
+![](./images/1_18.jpg)
+
+
+
+5) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的材质压缩档。
+
+![](./images/1_19.jpg)
+
+
+
+6) 开发者不通过MCSTUDIO而选择自行打包时，请将材质压缩文档放入一个文件夹内，将文件夹用7z压缩工具压缩成7z后缀格式的压缩包。再通过开发者平台上传组件资源源文档。
+
+
+
+#### PC 光影
+
+![](./images/1_20.jpg)
+
+
+
+1) 截图主要展示JAVA版光影的内容目录和文件结构。
+
+![](./images/1_21.jpg)
+
+
+
+2) 直接将文件夹内的所有文件全部选取后右键保存成zip压缩文档。
+
+![](./images/1_22.jpg)
+
+
+
+3) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择光影。【适用MC版本】选择对应存档本版。若支持多个版本可以选择多个相应版本。
+
+![](./images/1_23.jpg)
+
+
+
+4) 点击导入窗体内的+号按钮，直接双击或选择zip文档后选打开。
+
+![](./images/1_24.jpg)
+
+
+
+5) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的光影压缩档。
+
+6) 开发者不通过MCSTUDIO而选择自行打包时，请将光影压缩文档放入一个文件夹内，将文件夹用7z压缩工具压缩成7z后缀格式的压缩包。再通过开发者平台上传组件资源源文档。
+
+
+
+#### PC 皮肤
+
+![](./images/1_25.jpg)
+
+
+
+1) 截图主要展示PC皮肤资源支持的文件格式，为结尾png的图片文档。该格式的图片保存着一道透明通道。
+
+![](./images/1_26.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择皮肤。【适用MC版本】选择默认选择全版本即可。
+
+![](./images/1_27.jpg)
+
+
+
+3) 点击导入窗体内的+号按钮，直接双击或选择png文档后选打开。
+
+![](./images/1_28.jpg)
+
+
+
+4) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的图片文档。
+
+5) 开发者不通过MCSTUDIO而选择自行打包时，请直接通过开发者平台上传皮肤组件源图片文档。
+
+
+
+#### PC 玩法
+
+![](./images/1_29.jpg)
+
+
+
+1) 截图截选了我的世界JAVA版1.12.2游戏客户端生成的地图的内容。test文件夹下存放着名为test的世界信息。命令方块玩法、数据包等是用我的世界JAVA版地图作为承载。
+
+![](./images/1_30.jpg)
+
+
+
+2) 打开这个客户端可以看到test存档。
+
+![](./images/1_31.jpg)
+
+
+
+3) 返回到目录的上一级，saves文件夹下则会存放着这个客户端可以启动的所有存档文件夹，其中就有前面提到的test存档。
+
+![](./images/1_32.jpg)
+
+
+
+4) 打开MCSTUDIO，点击作品库后再点击Java版组件。在右上角点击本地导入，【作品分区】选择Java版作品。【作品分类】中选择玩法。【适用MC版本】选择对应存档本版。若支持多个版本可以选择多个相应版本。
+
+![](./images/1_33.jpg)
+
+
+
+5) 点击导入窗体内的+号按钮，直接选择test文件夹后点击选择文件夹。
+
+![](./images/1_34.jpg)
+
+
+
+6) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品，也不会影响到最原先的存档文件夹。
+
+![](./images/1_35.jpg)
+
+
+
+7) 开发者不通过MCSTUDIO而选择自行打包时，请将存档文件夹使用7Z压缩工具打包成一个后缀为7z的压缩文档。再通过开发者平台进行上传操作。
+
+
+
+### 认识基岩版包体结构
+
+#### PE地图
+
+![](./images/1_36.jpg)
+
+
+
+1) 截图截选了我的世界基岩版1.16.12游戏客户端生成的世界存档的内容。英文数字组合名称的文件夹下存放着该存档的世界信息。
+
+![](./images/1_38.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，分类选择【地图】。若勾选【复制文件到默认文件夹】，MCSTUDIO会将地图完整拷贝一份至C:/MCStudioDownload/work/开发者ID/Cpp/Map下。若不勾选，则不会做出此操作。
+
+![](./images/1_37.jpg)
+
+
+
+3) 勾选选项时，点击窗体内的+号。不勾选选项时，点击窗体内的选择按钮。双击存档文件夹或选择文件夹后点击【选择文件夹】按钮。
+
+![](./images/1_39.jpg)
+
+
+
+4) 最后点击导入按钮，即可由MCSTUDIO拷贝作品后导入进作品库内，进行后续的测试、发布、配置等操作。若开发者选择删除作品并且作品勾选【复制文件到默认文件夹】，则会系统会将C:/MCStudioDownload/work/开发者ID/Cpp/Map下相应的拷贝文件夹删除。
+
+![](./images/1_40.jpg)
+
+
+
+5) 开发者不通过MCSTUDIO而选择自行打包时，请将整个存档文件夹使用任意压缩工具打包成一个后缀为zip的压缩文档。再通过开发者平台进行上传操作。
+
+
+
+#### PE 联机地图
+
+![](./images/1_41.jpg)
+
+
+
+1) 截图截选了我的世界基岩版1.16.12游戏客户端生成的世界存档的内容。英文数字组合名称的文件夹下存放着该存档的世界信息。联机地图指代可以同时在本地、本地联机、联机大厅上使用的地图资源。
+
+![](./images/1_42.jpg)
+
+
+
+![](./images/1_43.jpg)
+
+
+
+2) 若世界存档携带附加包玩法，请确保存档文件夹目录下存有world_behavior_packs.json和world_resource_packs.json文件。其中pack_id对应材质包或行为包manifest内，header下的uuid。version对应manifest内header下的version。若只携带材质包或行为包，可以在world_behavior_packs.json内或world_resource_packs.json将第一个方括号内的内容全部清除。若不携带附加包，则则不需要在存档文件夹下携带此类文件。
+
+![](./images/1_44.jpg)
+
+
+
+3) 开发者可以在存档中放置一个server.properties，指定玩家的游戏模式。这样在联机大厅玩这个联机地图时，玩家每次进入都是server.properties文件中设置的游戏模式。更多基岩版多人联机地图的配置设定，请参考网址[https://zh.minecraft.wiki/w/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F](https://zh.minecraft.wiki/w/%E6%9C%8D%E5%8A%A1%E7%AB%AF%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F)
+
+4) 当前MCSTUDIO暂不支持导入联机大厅地图，请将整个存档文件夹使用任意压缩工具打包成一个后缀为zip的压缩文档。再通过开发者平台进行上传操作。
+
+
+
+#### PE Addon
+
+![](./images/1_45.jpg)
+
+
+
+1) 截图截选了我的世界基岩版Addon的内容。Addon又被称作附加包，它由材质包和行为包组成。因此开发者在上架完整的附加包内容（包含附加包和行为包），需依照接下来的规范进行打包上传即可。请注意：上架至中国版平台的附加包中，行为包内必须携带entities文件夹，材质包内必须携带textures文件夹。
+
+![](./images/1_46.jpg)
+
+
+
+![](./images/1_47.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击基岩版版组件。若勾选【复制文件到默认文件夹】，请将行为包、材质包全部选取后右键使用压缩工具压缩成zip文档，MCSTUDIO会在导入zip文档后，将一份完整拷贝放至C:/MCStudioDownload/work/开发者ID/Cpp/AddOn下。若不勾选，则直接选择带有行为包或材质包的文件夹即可。最后点击导入即可，之后开发者可以在MCSTUDIO进行后续的测试、发布、配置等操作。
+
+3) 若开发者不通过MCSTUDIO而选择自行打包时，请将行为包、材质包全部选取后右键使用压缩工具压缩成zip文档。再通过开发者平台进行上传操作。
+
+
+
+#### PE 材质
+
+![](./images/1_48.jpg)
+
+
+
+1) 附加包是行为包和材质包的统称，因此材质包被算入附加包的一种类型。因此开发者在上架完整的材质包内容前，需依照接下来的规范进行打包上传。请注意：上架至中国版平台的材质包内必须携带textures文件夹。
+
+![](./images/1_49.jpg)
+
+
+
+![](./images/1_50.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，在右上角点击本地导入，分区选择【基岩版作品】，分类选择【皮肤】。若勾选【复制文件到默认文件夹】，请将材质包文件夹右键使用压缩工具压缩成zip文档，MCSTUDIO会在导入zip文档后，将一份完整拷贝放至C:/MCStudioDownload/work/开发者ID/Cpp/Material下。若不勾选，则直接选择带有材质包的文件夹即可。最后点击导入即可，之后开发者可以在MCSTUDIO进行后续的测试、发布、配置等操作。
+
+3) 若开发者不通过MCSTUDIO而选择自行打包时，请将材质包文件夹右键使用压缩工具压缩成zip文档。再通过开发者平台进行上传操作。
+
+
+
+#### PE 光影
+
+![](./images/1_51.jpg)
+
+
+
+1) 光影的内容都被保存在材质包文件夹中，因此在运行机制与打包机制上与材质包类似。因此开发者在上架完整的光影内容前，需依照接下来的规范进行打包上传。请注意：上架至中国版平台的材质包内必须携带textures文件夹。
+
+![](./images/1_52.jpg)
+
+
+
+![](./images/1_53.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，在右上角点击本地导入，分区选择【基岩版作品】，分类选择【光影】。若勾选【复制文件到默认文件夹】，请将光影材质包文件夹右键使用压缩工具压缩成zip文档，MCSTUDIO会在导入zip文档后，将一份完整拷贝放至C:/MCStudioDownload/work/开发者ID/Cpp/Light下。若不勾选，则直接选择带有光影的材质包文件夹即可。最后点击导入即可，之后开发者可以在MCSTUDIO进行后续的测试、发布、配置等操作。
+
+3) 若开发者不通过MCSTUDIO而选择自行打包时，请将带有光影的材质包文件夹右键使用压缩工具压缩成zip文档。再通过开发者平台进行上传操作。
+
+
+
+#### PE 皮肤
+
+![](./images/1_54.jpg)
+
+
+
+1) 截图主要展示PE皮肤资源支持的文件格式，为结尾png的图片文档。该格式的图片保存着一道透明通道。
+
+![](./images/1_55.jpg)
+
+
+
+2) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，在右上角点击本地导入，分区选择【基岩版作品】，分类选择【皮肤】。直接点击+号选择png结尾的皮肤图片即可。
+
+3) 若开发者不通过MCSTUDIO而选择自行打包时，请将带有皮肤文件直接通过开发者平台进行上传操作。
+

docs/mconline/10-addon教程/第18章：打包导出你的作品/课程02.包体的导出.md

@@ -0,0 +1,97 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/2_1.9097d2e2.jpg
+hard: 进阶
+time: 15分钟
+---
+
+# 包体的导出
+
+
+
+#### 作者：境界
+
+
+
+在进行作品编辑、测试、上架等操作时，开发者可能需要将包体进行备份等操作。现在使用MCSTUDIO平台将包体导入后，可以导出包体到本地电脑上的任何一个地方。
+
+
+
+### JAVA包体的导出
+
+![](./images/2_1.jpg)
+
+
+
+![](./images/2_2.jpg)
+
+
+
+1) 打开MCSTUDIO，点击作品库后再点击Java版组件。鼠标放在单个组件窗体上后直到出现【更多】按钮。接着点击【更多】，再点击【导出】。
+
+![](./images/2_3.jpg)
+
+
+
+2) 进入【文件另存为】界面，选择想要的路径导出即可。
+
+
+
+### 基岩版包体的导出
+
+#### 地图资源
+
+![](./images/2_4.jpg)
+
+
+
+![](./images/2_5.jpg)
+
+
+
+1) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，组件标签分类选择【游戏地图】。鼠标放在单个组件窗体上后直到出现【更多】按钮。接着点击【更多】，再点击【导出】。
+
+![](./images/2_6.jpg)
+
+
+
+2) 进入【文件另存为】界面，选择想要的路径导出即可。
+
+
+
+#### Addon资源
+
+![](./images/2_7.jpg)
+
+
+
+![](./images/2_8.jpg)
+
+
+
+1) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，组件标签分类选择【AddOn】。鼠标放在单个组件窗体上后直到出现【更多】按钮。接着点击【更多】，再点击【导出】。
+
+![](./images/2_9.jpg)
+
+
+
+2) 进入【文件另存为】界面，选择想要的路径导出即可。
+
+
+
+#### PE 光影/材质/皮肤
+
+![](./images/2_10.jpg)
+
+
+
+![](./images/2_11.jpg)
+
+
+
+1) 打开MCSTUDIO，点击作品库后再点击基岩版版组件，组件标签分类选择【其他作品】。鼠标放在单个组件窗体上后直到出现【更多】按钮。接着点击【更多】，再点击【导出】。
+
+![](./images/2_12.jpg)
+
+
+
+2) 进入【文件另存为】界面，选择想要的路径导出即可。

docs/mconline/10-addon教程/第18章：打包导出你的作品/课程03.在手机和电脑上测试你的作品.md

@@ -0,0 +1,107 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/3_2.0bf61735.jpg
+hard: 入门
+time: 10分钟
+selection: true
+---
+# 在手机和电脑上测试你的作品
+
+
+
+#### 作者：包子
+
+
+
+在进行作品测试操作时，开发者可能需要使用手机环境对作品进行测试。现在使用MCSTUDIO一键发布资源并将资源上传到自测平台后，就可以使用自测手机开发客户端进行测试。
+
+
+
+## MCSTUDIO下载我的世界测试版
+
+
+
+1. 打开MCSTUDIO，点击右上角的【工具箱】。选择【手机测试版启动器】。
+
+   ![](./images/3_1.jpg)
+
+2. MCSTUDIO会打开浏览器并自动跳转到【开发者内容管理工具】的二维码链接上。开发者通过手机扫描二维码的功能就能下载到手机测试客户端。
+
+   ![](./images/3_2.jpg)
+
+
+
+## 使用MCSTUDIO和手机设备进行作品测试
+
+通过本大章的第一节【包体的结构与导入】教程，开发者对于MCSTUDIO的作品导入功能应该具有初步的掌握。不仅如此，开发者还可以通过MCSTUDIO进行测试组件，上传组件资源至开发者平台进行审核上架。基岩版组件还支持自测功能，自测组件不需要经过人工审核，只需组件通过机器审核的打包流程后，开发者可以通过手机测试客户端进行下载测试资源。我们来看看该如何达到这些想要的目的。
+
+![](./images/3_3.jpg)
+
+![](./images/3_4.jpg)
+
+1. 打开MCSTUDIO，点击【作品库】，再点击【基岩版组件】。将鼠标悬浮在资源窗体上直至【更多】按钮出现，点击【更多】按钮。再次点击【发布】按钮。
+
+   ![](./images/3_5.jpg)
+
+2. MCSTUDIO会自动打开浏览器的【开发者内容管理工具】的【发布资源】窗口，并自动预备上传好资源，开发者只需填写基本信息、收费模式、宣传素材等即可。最后记得点击【保存】按钮。
+
+   ![](./images/3_6.jpg)
+
+3.  建立好的基岩版资源处于【待提交审核】状态。在这个状态下，开发者可以点击组件对应条目行尾的【...】并在展开菜单中选择【机审自测】或【免机审自测】，机审自测会帮助您额外检测一些违规模块的使用。自测的组件最后会上架至开发者自测手机客户端。
+
+   ![](./images/3_7.jpg)
+
+4. 自测手机客户端登陆时需要创建一个新的账号，并且您只能在资源中心看到自己的提交自助测试的组件。
+
+
+
+## 单人测试环境
+
+![img](./images/3_8.jpg)
+
+![img](./images/3_9.jpg)
+
+1. JAVA版资源只能使用PC进行测试。在MCSTUDIO主界面上点击【作品库】，再点击【本地作品】分类。鼠标悬浮在资源窗体上方直至显示出【测试】按钮后，点击【测试】按钮即可。
+
+   ![img](./images/3_10.jpg)
+
+   ![img](./images/3_11.jpg)
+
+2. 基岩版资源可以使用手机自测客户端或MODPC客户端进行测试。在MCSTUDIO主界面上点击【作品库】，再点击资源所在的标签分类。鼠标悬浮在资源窗体上方直至显示出【开发测试】按钮后，点击【开发测试】按钮即可。
+
+
+3. 电脑启动资源前，系统可能需要下载资源所依赖的JAVA版客户端或基岩版MODPC客户端，请耐心等待。
+
+
+
+## 多人联机测试方案
+
+目前MCSTUDIO支持**本地ModPC局域网联机**和**使用开发者子母账号在手机测试端联机**。
+
+### 本地ModPC局域网联机
+
+![img](./images/3_12.jpg)
+
+1. 点击左上角的【工具箱】选中【Mod PC开发包】启动MODPC客户端或点击相应的资源进行【开发测试】。
+
+   ![img](./images/3_14.jpg)
+
+2. 可以在局域网游戏内看到其他人创建的存档房间。点击进入即可联机测试组件。
+
+### 使用开发者子母账号在手机测试端上联机
+
+1. 在使用手机测试端与其他成员测试玩法前，需要您先将成员设置为开发者子账号。有关添加开发者子账号的相关信息，<a href="../../../mcguide/32-开发者账号与团队/课程15-使用成员管理模块实现多账号协作.html">请单击本链接查询</a>。
+2. 再确认加入成员子账号后，请您进入手机测试端。在主页下进入 **【联机大厅】** ，选择 **【本地联机】** ，再次选择 **【自定义联机】** 。待您创建完房间后，其他成员即可在 **【自定义联机】** 区域找到您的房间。
+
+![3_18](./images/3_18.gif)
+
+## 查找你的问题
+
+模组玩法开发上遇到Bug可在开发者官网查询相关问题的解决方法，<a href="../../../mcguide/20-玩法开发/13-模组SDK编程/9-Mod开发BUG解决方案.html">请单击本链接查询</a>。
+
+## 开发者常见问题答疑
+
+![img](./images/3_16.jpg)
+
+在上传组件或是结算收益时，遇到一些比较常见的问题，可以在《我的世界》开发者平台-【开发者常见问题答疑】中找到对应方法。若是无法找到相关问题的解决办法，可以打开[【开发者常见问题答疑】-【反馈其他问题】表单](https://mcdev.webapp.163.com/#/feedbackModal?target=browser)，提交对应问题，官方将通过站内邮件与短信告知处理进度或结果。
+
+![img](./images/3_17.jpg)