Files
netease-modsdk-wiki/docs/mcguide/50-常见问题答疑/60-我的世界中国版打包错误信息汇整.md
2025-03-17 13:24:39 +08:00

238 lines
8.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
front: https://nie.res.netease.com/r/pic/20210730/ee109f39-8987-46e0-9fe7-40ebb23060fa.png
hard: 入门
time: 15分钟
selection: true
---
# 我的世界中国版打包错误信息汇整
有关手动打包作品资源的方法,请点击查看 [我的世界中国版资源上传规则](../35-上架与入驻/课程11-我的世界中国版资源上传规则.html)。
有关我的世界开发工作台一键打包作品资源的方法,请点击查看 <a href="../../mconline/10-addon教程/第18章打包导出你的作品/课程01.包体的结构和导入.html" rel="noopenner">[我的世界开发工作台包体导入] </a>和 <a href="../../mconline/10-addon教程/第18章打包导出你的作品/课程02.包体的导出.html" rel="noopenner">[我的世界开发工作台包体导出]</a>
## 机审打包错误代码汇总
### 打包错误代码6【DirError】
表示目录错误,组件未按目录组织的要求,导致打包系统不可解析。已知信息中,会触发以上错误的原因有:
> 地图组件:
>
> - 未携带level.dat_oldlevelname.txt等。可以尝试使用我的世界开发工作台MC Studio导入地图它会自动帮地图重新生成这两个文件。
### 打包错误代码7【UnZipError】
表示解压 zip 文件错误,属于 zip 文件本身有问题不可解压。
### 打包错误代码8【PackMcpError】
表示对 python 脚本进行打包的过程中出现问题,很大可能是脚本语法存在问题。
### 打包错误代码10【NoManifestError】
已知信息中,会触发以上错误的原因有:
> - 表示在打包的过程中发现 behavior_packs 中没有 manifest.json文件。
> - 表示在资源包中存在entities文件夹目前机审需要使用entities文件夹来判断行为包文件夹重名将导致导致机审错误。
>
> - 表示对地图组件多嵌套了一层以上的文件夹。
### 打包错误代码12【NoLevelError】
表示在打包 NetGame 和 Lobby 的时候发现没有 Level 地图数据。
### 打包错误代码13【HasLevelError】
表示在打包商品 Mod 的时候发现存在 Level 地图数据,属于包含了不应该有的文件内容。
### 打包错误代码16【FileOrPathNameError】
表示打包系统在解压上传的 zip 文件时发现文件名称存在无法解析的字符,可能是中文或无法解析的符号。
### 打包错误代码18【CodeReviewError】
表示对整个包进行代码检查时发现有使用未开放 API 或语法错误或禁止使用的方法
### 打包错误代码20【FindBehaviorAndResourceError】
表示在搜索资源包或行为包时发生错误。如果无行为包请检查manifest.json同级下是否有文件夹命名为resource_pack如果有请改名。
### 打包错误代码21【EncryptError】
表示平台对组件进行加密处理时出现问题。请勿将中国版已上架发布的组件源文件进行二次投稿。现在平台对上传的组件都做了加密处理,请勿将已加密过的组件资源进行投稿上传。
### 打包错误代码24【ResourcePackUnvalid】
文件夹结构错误请确保资源包文件夹中有textures或shader文件夹在行为包文件夹中有entities文件夹且根目录中没有其他无关文件。
### 打包错误代码25【TexturesListLoadError】
表示读取json文件失败可能是对应的json文件存在问题。已知信息中会触发以上错误的原因有
> - 表示json文件的编码有误应为utf-8。
> - 表示json文件的格式有误可使用json格式化工具进行检查。
### 打包错误代码26【TexturesSizeError】
表示贴图文件大小导致的报错,可以检查是否存在过大的贴图文件。
### 打包错误代码27【NameOverSizeError】
表示 zip 文件内存在文件名过长的文件,请检查对应的文件名是否过长。
### 打包错误代码29【PlayerEntityJsonReviewError】
表示resource_packs/entity/ 路径下自定义的player.entity.json中的render_controllers定义不符合规范请确认至少同时保留以下4个render_controller:
```json
{
// player.entity.json
"render_controllers":[
{
"controller.render.player.first_person":"variable.is_first_person"
},
{
"controller.render.player.third_person":"!variable.is_first_person && !variable.map_face_icon"
},
{
"controller.render.player.first_person_bloom":"variable.is_first_person"
},
{
"controller.render.player.third_person_bloom":"!variable.is_first_person && !variable.map_face_icon"
}
]
}
```
### 打包错误代码30【ReadLevelDataError】
表示读取level.dat文件失败请检查资源包中该文件是否损坏、缺少字段或不存在。
### 打包错误代码31【MapItemVersionError】
表示地图组件的游戏版本大于当前《我的世界》中国版支持的最高游戏版本。
### 打包错误代码33【AudioReviewError】
表示组件内携带的音效格式非.ogg格式或.ogg格式的音效码率大于128。开发者平台站内邮件会告知相应音效的所在路径请将音效格式转为.ogg格式并设置码率不大于128。
### 打包错误代码34【GlyphReviewError】
表示自定义的位图字体Bitmap Font未满足中国版2.2基岩版1.18)以上的要求,位图字体需要满足以下条件:
- 贴图大小为256*256。
- 每个字体的长宽均为16个像素。
### 打包错误代码35【CodeExceptionError】
表示已检测到的文件中变量命名、文件名、函数名存在超过5个连续相同字符。为了脚本安全性考虑请对存在超过5个连续相同的字符进行修改。
## 其他打包错误信息汇总
### 打包错误之皮肤图片必须包含Alpha通道
表示皮肤图片缺少Alpha通道。请把皮肤源图片文件导入Photoshop等图片处理软件里检查颜色通道并导出成png图片。或使用MCSkin3D或Skinseed将皮肤源文件导入后再次导出最后再进行上传。
### 打包错误之上架接口调用失败
请检查打包文件夹内的命名是否有中文或特殊符号,以及开发者平台作者简介和作品介绍是否有部分无法解析的特殊符号(**如Emoji**)。若存在以上情况,需重新调整后再提审。若问题依然存在,在 **【开发者平台】** 的 **【开发者常见问题答疑】** 下,点击 **【反馈其他问题】** 提交问题,反馈结果将通过开发者邮件发送至开发者平台邮箱。
### 打包错误之UUID【UUID冲突请重新生成】
![](./images/1_1.jpg)
![](./images/1_2.jpg)
1. 表示资源附加包的行为包或资源包manifest下的uuid与平台已有资源的UUID重复。如果报错资源是手游版资源且是Add-on请在行为包(behavior_packs)和资源包(resource_packs)文件夹中打开manifest文件用网络在线工具重新再生成uuid后替换文件内的uuid的值即可。若报错资源是携带Add-on的手游版玩法地图组件请将地图根目录下的netease_world_behavior_packs和netease_world_resource_packs文件重命名为world_behavior_packs和world_resource_packs **(若存在请覆盖)** ,并修改相关信息,示例如下:
```json
[// world_resource_packs.json
{
"pack_id" : "c04c0b42-fed4-4b7d-a34d-9ea5280a0e05", //请使用UUID生成工具替换该值
"type": "Addon",
"version" : [ 0, 0, 1 ] //请确保数组数值对应携带相关UUID的资源包内的版本信息
}
]
```
```json
[// world_behavior_packs.json
{
"pack_id" : "c04c0b42-fed4-4b7d-a34d-9ea5280a0e05", //请使用UUID生成工具替换该值
"type": "Addon",
"version" : [ 0, 0, 1 ] //请确保数组数值对应携带相关UUID的行为包内的版本信息
}
]
```
生成工具[可以点击此链接](https://www.uuidgenerator.net/)查看。
2. 如果报错的是不带Add-on资源的玩法地图或地图大观请直接清空行为包(behavior_packs)和资源包(resource_packs)文件夹内的文件并删除netease_world_behavior_packs、netease_world_resource_packs、world_behavior_packs和world_resource_packs等文件。