xiaokun/netease-bedrock-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

同步官网文档8m_25d

Browse Source
This commit is contained in:
kwiilh
2025-08-25 18:36:29 +08:00
parent 4dc0ecf18d
commit 9e8855eeb4
5089 changed files with 8798 additions and 4799 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
mcguide/50-常见问题答疑/10-我的世界开发工作台常见问题.md
View File

@@ -45,7 +45,7 @@ selection: true
如果你开发的是玩法模组，并且使用模组SDK，可以参考<a href="../../mcdocs/0-概述/0-概述.html" rel="noopenner"> 技术文档 </a>
此外，我们还有一些关于Add On，玩法地图，美术制作的<a href="../../mconline/100-历史归档教程/15-玩法组件教程【新版】/0-使用我的世界开发工作台制作第一个玩法/0-摘要.html" rel="noopenner"> 示例课程 </a>。
此外，我们还有一些关于Add On，玩法地图，美术制作的<a href="../../mconline/15-玩法组件教程/0-使用我的世界开发工作台制作第一个玩法/0-摘要.html" rel="noopenner"> 示例课程 </a>。
如果你想开发网络游戏，可以参考[网络游戏开服工具文档](../27-网络游戏/课程1：成为Apollo服主及相关准备/第1节：Apollo介绍.md)。

2
mcguide/50-常见问题答疑/15-新版编辑器相关问题.md
View File

@@ -77,4 +77,4 @@ time: 25分钟
10、新版编辑器的地图编辑器出现白屏如何解决？
将这个路径下的options文件删掉：%appdata%\MinecraftPE_Netease_Editor\minecraftpe
将这个路径下的options文件删掉：%appdata%\MinecraftPE_Netease_Editor\minecraftpe

2
mcguide/50-常见问题答疑/20-网络游戏开服工具常见问题答疑.md
View File

@@ -190,7 +190,7 @@ post body:{
curl -X POST http://127.0.0.1:8001/cloud/query-user-cloud-items ‘{"uid" :1357471387, "apply_tag" : "tag0"}’
```
- 若传输的http消息正确，则会返回以下数据信息：

148
mcguide/50-常见问题答疑/60-我的世界中国版打包错误信息汇整.md
View File

@@ -9,130 +9,86 @@ selection: true
有关手动打包作品资源的方法，请点击查看 [我的世界中国版资源上传规则](../35-上架与入驻/课程11-我的世界中国版资源上传规则.html)。
有关我的世界开发工作台一键打包作品资源的方法，请点击查看 <a href="../../mconline/100-历史归档教程/10-addon教程/第18章：打包导出你的作品/课程01.包体的结构和导入.html" rel="noopenner">[我的世界开发工作台包体导入] </a>和 <a href="../../mconline/100-历史归档教程/10-addon教程/第18章：打包导出你的作品/课程02.包体的导出.html" rel="noopenner">[我的世界开发工作台包体导出]</a>
有关我的世界开发工作台一键打包作品资源的方法，请点击查看 <a href="../../mconline/10-addon教程/第18章：打包导出你的作品/课程01.包体的结构和导入.html" rel="noopenner">[我的世界开发工作台包体导入] </a>和 <a href="../../mconline/10-addon教程/第18章：打包导出你的作品/课程02.包体的导出.html" rel="noopenner">[我的世界开发工作台包体导出]</a>
## 机审打包错误代码汇总
### 打包错误代码1【UnDefine】
表示未定义的返回值，打包脚本内部报错。
### 打包错误代码2【NoMod】
表示不包含 python 的 Mod，该返回值暂时未使用。
表示不包含 python 的 Mod，该返回值暂时未使用。
### 打包错误代码3【PackTypeError】
表示调用了未给定的 PackType 打包类型。
表示调用了未给定的 PackType 打包类型。
### 打包错误代码4【PackTypeError】
表示调用了未给定的 PackType 端口类型。
表示调用了未给定的 PackType 端口类型。
### 打包错误代码5【McpPackPathError】
表示调用的 McpPack.out 文件路径有问题，不存在或错误。
表示调用的 McpPack.out 文件路径有问题，不存在或错误。
### 打包错误代码6【DirError】
表示目录错误，组件未按目录组织的要求，导致打包系统不可解析。已知信息中，会触发以上错误的原因有：
> 地图组件：
>
> - 未携带level.dat_old，levelname.txt等。可以尝试使用我的世界开发工作台（MC Studio）导入地图，它会自动帮地图重新生成这两个文件。
> - addon组件中structures文件夹下相对路径超过2层，会进行拦截，如下图所示：![](./images/17.png)
### 打包错误代码7【UnZipError】
表示解压 zip 文件错误，属于 zip 文件本身有问题不可解压。
### 打包错误代码8【PackMcpError】
表示对 python 脚本进行打包的过程中出现问题，很大可能是脚本语法存在问题。
### 打包错误代码9【GetAllError】
表示在程序中获取解压后的文件目录出问题，打包脚本内部报错。
### 打包错误代码10【NoManifestError】
已知信息中，会触发以上错误的原因有：
> - 表示在打包的过程中发现 behavior_packs 中没有 manifest.json文件。
> - 表示在资源包中存在entities文件夹，目前机审需要使用entities文件夹来判断行为包，文件夹重名将导致导致机审错误。
>
> - 表示对地图组件多嵌套了一层以上的文件夹。
### 打包错误代码11【ComputerSystemError】
表示打包脚本内部报错，使用了 Windows 和 Linux 之外的系统进行打包。
### 打包错误代码12【NoLevelError】
表示在打包 NetGame 和 Lobby 的时候发现没有 Level 地图数据。
### 打包错误代码13【HasLevelError】
表示在打包商品 Mod 的时候发现存在 Level 地图数据，属于包含了不应该有的文件内容。
### 打包错误代码14【CopyDevelopError】
表示将 python 脚本拷贝到 developer_mods 的过程中出现问题，打包脚本内部报错。
### 打包错误代码15【 ZipToDirError】
表示将处理后的包压缩成新的 zip 包的时候出问题，打包脚本内部报错。
表示将处理后的包压缩成新的 zip 包的时候出问题，打包脚本内部报错。
### 打包错误代码16【FileOrPathNameError】
表示打包系统在解压上传的 zip 文件时发现文件名称存在无法解析的字符，可能是中文或无法解析的符号。
### 打包错误代码17【 MoveToDirError】
表示将打包后的 zip 文件移动到指定目录出问题，打包脚本内部报错。
### 打包错误代码18【CodeReviewError】
已知信息中，会触发以上错误代码可能存在下列情形：
@@ -149,46 +105,30 @@ selection: true
>
> ![](./images/15.png)
​
### 打包错误代码19【 IncreDownloadError】
表示增量打包manifest文件时出问题，打包脚本内部错误。
### 打包错误代码20【FindBehaviorAndResourceError】
表示在搜索资源包或行为包时发生错误。如果无行为包，请检查manifest.json同级下是否有文件夹命名为resource_pack，如果有请改名。
### 打包错误代码21【EncryptError】
表示平台对组件进行加密处理时出现问题。请勿将中国版已上架发布的组件源文件进行二次投稿。现在平台对上传的组件都做了加密处理，请勿将已加密过的组件资源进行投稿上传。
### 打包错误代码22【 CreateContentsFileError】
表示创建content.json文件时出问题，打包脚本内部错误。
表示创建content.json文件时出问题，打包脚本内部错误。
### 打包错误代码23【WriteLevelDatError】
操作组件中level.dat或level.dat_old文件时出现异常，请检查对应文件内容是否有异常。
### 打包错误代码24【ResourcePackUnvalid】
文件夹结构错误，请确保资源包文件夹中有textures或shader文件夹，在行为包文件夹中有entities文件夹，且根目录中没有其他无关文件。
### 打包错误代码25【TexturesListLoadError】
表示读取json文件失败，可能是对应的json文件存在问题。已知信息中，会触发以上错误的原因有：
@@ -196,26 +136,17 @@ selection: true
> - 表示json文件的编码有误，应为utf-8。
> - 表示json文件的格式有误，可使用json格式化工具进行检查。
### 打包错误代码26【TexturesSizeError】
表示贴图文件大小导致的报错，可以检查是否存在过大的贴图文件。
### 打包错误代码27【NameOverSizeError】
表示 zip 文件内存在文件名过长的文件，请检查对应的文件名是否过长。
### 打包错误代码29【PlayerEntityJsonReviewError】
表示resource_packs/entity/ 路径下自定义的player.entity.json中的render_controllers定义不符合规范，请确认至少同时保留以下4个render_controller:
表示resource_packs/entity/ 路径下自定义的player.entity.json中的render_controllers定义不符合规范，请确认至少同时保留以下4个render_controller:
```json
{
@@ -237,47 +168,36 @@ selection: true
}
```
### 打包错误代码30【ReadLevelDataError】
表示读取level.dat文件失败，请检查资源包中该文件是否损坏、缺少字段或不存在。
### 打包错误代码31【MapItemVersionError】
表示地图组件的游戏版本大于当前《我的世界》中国版支持的最高游戏版本。
### 打包错误代码33【AudioReviewError】
表示组件内携带的音效格式非.ogg格式，或.ogg格式的音效码率大于128。开发者平台站内邮件会告知相应音效的所在路径，请将音效格式转为.ogg格式并设置码率不大于128。
### 打包错误代码34【GlyphReviewError】
表示自定义的位图字体（Bitmap Font）未满足中国版2.2（基岩版1.18）以上的要求，位图字体需要满足以下条件：
- 贴图大小为256*256。
- 每个字体的长宽均为16个像素。
- 透明像素的RGBA通道需要全部为0，否则将导致字体显示异常，如图所示。
![image](./images/30.png)
### 打包错误代码35【CodeExceptionError】
表示已检测到的文件中，变量命名、文件名、函数名存在超过5个连续相同字符。为了脚本安全性考虑，请对存在超过5个连续相同的字符进行修改。
### 打包错误代码36【McpFileError】
表示上传的原始包体中存在已编译的模组SDK编译文件（.MCP文件），开发者平台针对过去携带MCP文件的原始包体不会再进行 **重复打包** 或 **重复处理** ，请在原始包体内删除此类文件后重新投稿上传。
### 打包错误代码37【ManifestJsonError】
表示附加包内的资源包与行为包`manifest.json`（清单文件）没有添加`min_engine_version`（最低版本信息）或`min_engine_version`的版本低于1.18.0，可参考以下json格式进行修改：
@@ -287,18 +207,16 @@ selection: true
```json
{
"format_version": 1,
"header":{
"description":"pack.description",
"name":"pack.name",
"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version":[ 1, 0, 0 ],
"min_engine_version":[ 1, 18, 0 ]
"header": {
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version": [1, 0, 0],
"min_engine_version": [1, 18, 0]
},
"modules":[
"modules": [
{
"type":"resources",
"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version":[ 1, 0, 0 ]
"type": "resources",
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version": [1, 0, 0]
}
]
}
@@ -309,25 +227,21 @@ selection: true
```json
{
"format_version": 1,
"header":{
"description":"pack.description",
"name":"pack.name",
"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version":[ 1, 0, 0 ],
"min_engine_version":[ 1, 18, 0 ]
"header": {
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version": [1, 0, 0],
"min_engine_version": [1, 18, 0]
},
"modules":[
"modules": [
{
"type":"data",
"uuid":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version":[ 1, 0, 0 ]
"type": "data",
"uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // UUID需唯一，此处仅作演示
"version": [1, 0, 0]
}
]
}
```
### 打包错误代码38【MakeBehaviourPackJsonError】
表示机审在读取附加包内的`manifest.json`（清单文件）时出现异常，已知信息中，会触发以上错误的原因有：
@@ -335,8 +249,6 @@ selection: true
- 表示`json`文件的编码有误，应为`utf-8`。
- 表示`json`文件内存在不相关的内容，如使用`\* *\`进行注释。
### 打包错误代码40【InvalidJsonDataError】
表示机审在读取所有的`json`文件时出现异常，已知信息中，会触发以上错误的原因有：
@@ -344,24 +256,16 @@ selection: true
- 表示`json`文件的编码有误，应为`utf-8`。
- 表示在`json`文件中，如果使用如`xx:数字`的键值命名，由于微软底层代码更改，这种格式现被解释为查询图集的指定图片，容易导致图片显示异常。如果数字序号超出`Int32`范围，还会引发`out of range`错误并导致游戏崩溃。
## 其他打包错误信息汇总
### 打包错误之皮肤图片必须包含Alpha通道
表示皮肤图片缺少Alpha通道。请把皮肤源图片文件导入Photoshop等图片处理软件里，检查颜色通道，并导出成png图片。或使用MCSkin3D或Skinseed将皮肤源文件导入后再次导出，最后再进行上传。
### 打包错误之上架接口调用失败
请检查打包文件夹内的命名是否有中文或特殊符号，以及开发者平台作者简介和作品介绍是否有部分无法解析的特殊符号（**如Emoji**）。若存在以上情况，需重新调整后再提审。若问题依然存在，在 **【开发者平台】** 的 **【开发者常见问题答疑】** 下，点击 **【反馈其他问题】** 提交问题，反馈结果将通过开发者邮件发送至开发者平台邮箱。
### 打包错误之UUID冲突，请重新生成
表示上传作品中，行为包或资源包的清单文件（manifest.json）里的UUID与平台现有作品的UUID重复。请查看[组件打包发布](../30-测试/3-组件打包发布.html#组件配置)文档中的组件配置功能说明，使用 **《我的世界》开发工作台** 导入作品，可一键替换组件或地图内组件的UUID与版本号。

12
mcguide/50-常见问题答疑/86-开发者常见问题汇总.md
View File

@@ -4,7 +4,7 @@
## 一、审核相关：
## 一、审核相关：
@@ -42,7 +42,7 @@
**Q：组件审核需要多久时间？**
**A:** 一般情况下，普通组件的审核周期为3个工作日左右，网络游戏则需要大约10个工作日。如果您对审核进程或速度有疑问，请通过开发者平台进行提单反馈：[开发者平台问题与反馈中心](https://mcdev.webapp.163.com/#/feedbackModal?target=browser)
**A:** 一般情况下，普通组件的审核周期为3个工作日左右，网络游戏则需要大约10个工作日。如果您对审核进程或速度有疑问，请通过开发者平台进行提单反馈：[开发者平台问题与反馈中心](https://mcdev.webapp.163.com/#/feedbackModal?target=browser)
@@ -76,9 +76,9 @@
**A:** 有关于内容审核标准和审核意见的疑问和歧义。为了提高审核的透明度和效率，我们建议您阅读：
【组件上架的规范及过审攻略】详细了解如何成功上架您的组件，请访问 [组件上架的规范及过审攻略](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/35-%E4%B8%8A%E6%9E%B6%E4%B8%8E%E5%85%A5%E9%A9%BB/%E8%AF%BE%E7%A8%8B03-%E7%BB%84%E4%BB%B6%E4%B8%8A%E6%9E%B6%E7%9A%84%E8%A7%84%E8%8C%83%E5%8F%8A%E8%BF%87%E5%AE%A1%E6%94%BB%E7%95%A5.html?catalog=1)
【组件上架的规范及过审攻略】详细了解如何成功上架您的组件，请访问 [组件上架的规范及过审攻略](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/35-%E4%B8%8A%E6%9E%B6%E4%B8%8E%E5%85%A5%E9%A9%BB/%E8%AF%BE%E7%A8%8B03-%E7%BB%84%E4%BB%B6%E4%B8%8A%E6%9E%B6%E7%9A%84%E8%A7%84%E8%8C%83%E5%8F%8A%E8%BF%87%E5%AE%A1%E6%94%BB%E7%95%A5.html?catalog=1)
【开发者内容审核制度介绍】了解审核制度的详细信息，请访问 [开发者内容审核制度介绍](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/36-%E5%AE%A1%E6%A0%B8%E4%B8%8E%E4%B8%8B%E6%9E%B6/%E8%AF%BE%E7%A8%8B02-%E5%BC%80%E5%8F%91%E8%80%85%E5%86%85%E5%AE%B9%E5%AE%A1%E6%A0%B8%E5%88%B6%E5%BA%A6%E4%BB%8B%E7%BB%8D.html)
【开发者内容审核制度介绍】了解审核制度的详细信息，请访问 [开发者内容审核制度介绍](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/36-%E5%AE%A1%E6%A0%B8%E4%B8%8E%E4%B8%8B%E6%9E%B6/%E8%AF%BE%E7%A8%8B02-%E5%BC%80%E5%8F%91%E8%80%85%E5%86%85%E5%AE%B9%E5%AE%A1%E6%A0%B8%E5%88%B6%E5%BA%A6%E4%BB%8B%E7%BB%8D.html)
我们鼓励所有开发者在创建和提交内容之前仔细阅读这些指南，以确保您的作品顺利通过审核。
@@ -347,7 +347,7 @@ API文档：详细介绍了可用的API接口及其用法。查看[API文档](ht
**Q：开发者平台缴纳押金的规则是什么呢？**
**A:** 当前平台押金缴纳上限为1000元。押金收取规则是根据钻石定价决定的，定价100钻石的组件，就会被收取100元的押金。
**A:** 当前平台押金缴纳上限为600元。押金收取规则是根据钻石定价决定的，定价100钻石的组件，就会被收取50元的押金。
@@ -530,7 +530,7 @@ API文档：详细介绍了可用的API接口及其用法。查看[API文档](ht
**Q：如何打包上传自己的基岩版/JAVA版组件作品呢？**
**A:** 使用我的世界开发工作台一键上传功能请 [参考教程](https://mc.163.com/dev/mcmanual/mc-dev/mconline/100-历史归档教程/10-addon%E6%95%99%E7%A8%8B/%E7%AC%AC18%E7%AB%A0%EF%BC%9A%E6%89%93%E5%8C%85%E5%AF%BC%E5%87%BA%E4%BD%A0%E7%9A%84%E4%BD%9C%E5%93%81/%E8%AF%BE%E7%A8%8B03.%E5%9C%A8%E6%89%8B%E6%9C%BA%E5%92%8C%E7%94%B5%E8%84%91%E4%B8%8A%E6%B5%8B%E8%AF%95%E4%BD%A0%E7%9A%84%E4%BD%9C%E5%93%81.html?catalog=1)。手动打包组件资源并上传开发者平台网页请参考 [我的世界中国版资源上传规则](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/35-%E4%B8%8A%E6%9E%B6%E4%B8%8E%E5%85%A5%E9%A9%BB/%E8%AF%BE%E7%A8%8B11-%E6%88%91%E7%9A%84%E4%B8%96%E7%95%8C%E4%B8%AD%E5%9B%BD%E7%89%88%E8%B5%84%E6%BA%90%E4%B8%8A%E4%BC%A0%E8%A7%84%E5%88%99.html?catalog=1)。
**A:** 使用我的世界开发工作台一键上传功能请 [参考教程](https://mc.163.com/dev/mcmanual/mc-dev/mconline/10-addon%E6%95%99%E7%A8%8B/%E7%AC%AC18%E7%AB%A0%EF%BC%9A%E6%89%93%E5%8C%85%E5%AF%BC%E5%87%BA%E4%BD%A0%E7%9A%84%E4%BD%9C%E5%93%81/%E8%AF%BE%E7%A8%8B03.%E5%9C%A8%E6%89%8B%E6%9C%BA%E5%92%8C%E7%94%B5%E8%84%91%E4%B8%8A%E6%B5%8B%E8%AF%95%E4%BD%A0%E7%9A%84%E4%BD%9C%E5%93%81.html?catalog=1)。手动打包组件资源并上传开发者平台网页请参考 [我的世界中国版资源上传规则](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/35-%E4%B8%8A%E6%9E%B6%E4%B8%8E%E5%85%A5%E9%A9%BB/%E8%AF%BE%E7%A8%8B11-%E6%88%91%E7%9A%84%E4%B8%96%E7%95%8C%E4%B8%AD%E5%9B%BD%E7%89%88%E8%B5%84%E6%BA%90%E4%B8%8A%E4%BC%A0%E8%A7%84%E5%88%99.html?catalog=1)。

2
mcguide/50-常见问题答疑/90-其他问题反馈途径.md
View File

@@ -25,7 +25,7 @@ selection: true
频道主要用于开发者之间的交流及官⽅活动发布，频道申请时需要备注开发者昵称及开发者邮箱。
#### 我的世界开发者B站号