同步官网文档8m_25d
This commit is contained in:
kwiilh
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
@@ -106,7 +106,7 @@ Client-Server结构分为服务器与客户端。服务器负责数据的管理
|
||||
| ------------- | ------------------------------------------------------------ |
|
||||
| entities | 生物的定义。<br><font color="red">在我的世界中国版中，行为包中必须有这个文件夹</font> |
|
||||
| ... | |
|
||||
| manifest.json | 资源包的描述文件，包含了该资源包的标识符，作者信息等。<br>更多可以参考[官方wiki](https://minecraft-zh.gamepedia.com/基岩版附加包文档#manifest.json)，以及下方的“制作规范” |
|
||||
| manifest.json | 资源包的描述文件，包含了该资源包的标识符，作者信息等。<br>更多可以参考[官方wiki](https://zh.minecraft.wiki/w/基岩版附加包文档#manifest.json)，以及下方的“制作规范” |
|
||||
|
||||
### 资源包
|
||||
|
||||
@@ -117,12 +117,12 @@ Client-Server结构分为服务器与客户端。服务器负责数据的管理
|
||||
| entity | 生物的定义 |
|
||||
| textures | 贴图资源<br><font color="red">在我的世界中国版中，资源包中必须有这个文件夹</font> |
|
||||
| ... | |
|
||||
| manifest.json | 资源包的描述文件，包含了该资源包的标识符，作者信息等。<br>更多可以参考[官方wiki](https://minecraft-zh.gamepedia.com/基岩版附加包文档#manifest.json)，以及下方的“制作规范” |
|
||||
| manifest.json | 资源包的描述文件，包含了该资源包的标识符，作者信息等。<br>更多可以参考[官方wiki](https://zh.minecraft.wiki/w/基岩版附加包文档#manifest.json)，以及下方的“制作规范” |
|
||||
|
||||
|
||||
## 开始动手吧
|
||||
|
||||
如果想更深入了解如何手动配置addon，可以阅读[制作资源附加包](https://minecraft-zh.gamepedia.com/教程/制作资源附加包)与[制作行为包](https://minecraft-zh.gamepedia.com/%E6%95%99%E7%A8%8B/%E5%88%B6%E4%BD%9C%E8%A1%8C%E4%B8%BA%E5%8C%85)。
|
||||
如果想更深入了解如何手动配置addon，可以阅读[制作资源附加包](https://zh.minecraft.wiki/w/教程/制作资源附加包)与[制作行为包](https://zh.minecraft.wiki/w/%E6%95%99%E7%A8%8B/%E5%88%B6%E4%BD%9C%E8%A1%8C%E4%B8%BA%E5%8C%85)。
|
||||
|
||||
如果想了解更多的自定义游戏内容，可以查阅“自定义游戏内容“里的文档
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
@@ -29,9 +29,9 @@ time: 分钟
|
||||
|
||||
每个作品最多可配置10条魔法指令，每条由提示语和事件名组成
|
||||
|
||||
提示语：仅中文，字数不超过20字，不可与本资源其余提示语重名
|
||||
提示语：仅中文，字数不超过20字，不可与本资源其余提示语重名
|
||||
|
||||
事件名：仅可输入字母和数字，限制长度在20位以内，不可与本资源其余事件名重名
|
||||
事件名：仅可输入字母和数字，限制长度在20位以内，不可与本资源其余事件名重名
|
||||
|
||||
> 事件名最好保证在中国版的所有组件注册的魔法指令中保持唯一，所以请增加一些特定的前缀或者后缀（作用类似组件的命名空间），并且不要出现特别短的事件名
|
||||
|
||||
@@ -53,12 +53,12 @@ class MySystem(ServerSystem):
|
||||
def __init__(self, namespace, systemName):
|
||||
# 省略一些初始化
|
||||
self.ListenForEvent('Minecraft', 'aiCommand', 'neteasemcgood', self, self.neteasemcgood)
|
||||
|
||||
|
||||
def neteasemcgood(self, args):
|
||||
print args['playerId'], "说：我的世界越来越好"
|
||||
```
|
||||
|
||||
测试时就会发现，使用魔法指令输入“我的世界越来越好”时，系统会打印出相关日志
|
||||
测试时就会发现，使用魔法指令输入“我的世界越来越好”时，系统会打印出相关日志
|
||||
|
||||
## 如何测试
|
||||
|
||||
@@ -66,9 +66,9 @@ class MySystem(ServerSystem):
|
||||
目前只能在手机测试版中使用。
|
||||
|
||||
> 注意：
|
||||
>
|
||||
>
|
||||
> 1.测试自定义的魔法指令之前需要在内容管理平台中配置魔法指令的提示语和事件名。
|
||||
>
|
||||
>
|
||||
> 2.在手机测试版中，需先在游戏内开启作弊，才能看到魔法指令的界面并进行测试。
|
||||
|
||||
手机测试版的魔法指令，不会消耗次数，即使提示语不能命中内容管理。平台中配置的魔法指令，也不会尝试使用AI生成指令。即此版本仅用于测试开发者配置的魔法指令。
|
||||
|
||||
@@ -107,7 +107,7 @@ selection: true
|
||||
python -m pip install mc-netease-sdk==要安装的版本号
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## Python入门
|
||||
|
||||
@@ -165,9 +165,9 @@ python是一门很容易入门的编程语言，没有接触过python的开发
|
||||
# 监听引擎的事件ServerBlockUseEvent，回调函数为ServerBlockUseEvent
|
||||
self.ListenForEvent(serverApi.GetEngineNamespace(), serverApi.GetEngineSystemName(), "ServerBlockUseEvent",
|
||||
self, self.OnServerBlockUseEvent)
|
||||
|
||||
|
||||
...
|
||||
|
||||
|
||||
# 监听ServerBlockUseEvent的回调函数
|
||||
def OnServerBlockUseEvent(self, args):
|
||||
# 这里的sdkteam_test:block1替换成你自己的自定义方块的命名空间与方块名
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
newItemName及newAuxValue返回新版名称与附加值。
|
||||
|
||||
原字段itemName及auxValue返回旧版名称与附加值。
|
||||
|
||||
|
||||
2. 对于接受物品信息字典的接口与事件：
|
||||
|
||||
当字典存在newItemName及newAuxValue时，使用这两个字段。
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
@@ -56,9 +56,9 @@ time: 分钟
|
||||
|
||||
## manifest.json
|
||||
|
||||
studio创建的AddOn里又叫pack_manifest.json，其实是一样的东西。
|
||||
在旧版的MCStudio创建的AddOn里又叫pack_manifest.json，其实是一样的东西。
|
||||
|
||||
这个文件包含了mod的标识符（uuid），版本号（version）等关键信息。通过studio来创建的AddOn都会自动生成这个文件，如果开发者想要手动创建这个文件可以参考[官方wiki](https://minecraft-zh.gamepedia.com/教程/制作资源附加包#.E5.88.9B.E5.BB.BA.E4.B8.80.E4.B8.AA.E8.B5.84.E6.BA.90.E9.99.84.E5.8A.A0.E5.8C.85)。
|
||||
这个文件包含了mod的标识符（uuid），版本号（version）等关键信息。通过studio来创建的AddOn都会自动生成这个文件，如果开发者想要手动创建这个文件可以参考[官方wiki](https://zh.minecraft.wiki/w/教程/制作资源附加包#.E5.88.9B.E5.BB.BA.E4.B8.80.E4.B8.AA.E8.B5.84.E6.BA.90.E9.99.84.E5.8A.A0.E5.8C.85)。
|
||||
|
||||
这个文件里一般有两个uuid字段。这两个字段一旦生成，后续请勿修改。
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
@@ -10,7 +10,7 @@ time: 分钟
|
||||
|
||||
## 示例下载
|
||||
|
||||
下载地址：[示例Demo](https://g79.gdl.netease.com/3.2Demo.zip)。
|
||||
下载地址：[示例Demo](https://g79.gdl.netease.com/3.3Demo.zip)。
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
---
|
||||
front:
|
||||
front:
|
||||
hard: 入门
|
||||
time: 分钟
|
||||
---
|
||||
@@ -70,11 +70,11 @@ time: 分钟
|
||||
|
||||
### 更新了mod资源，下载到的mod还是旧版本
|
||||
|
||||
每次更新了mod资源之后，要在mod的behavior和resource文件夹下面，更改 *pack_manifest.json* 的版本号，比如上个mod的version是[0, 0, 1]，那么这次mod的version就要是[0, 0, 2]。地图mod和组件mod如果有更新，都要改version才会触发更新
|
||||
每次更新了mod资源之后，要在mod的behavior和resource文件夹下面，更改 *manifest.json* 的版本号，比如上个mod的version是[0, 0, 1]，那么这次mod的version就要是[0, 0, 2]。地图mod和组件mod如果有更新，都要改version才会触发更新
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 上传MOD，提示打包失败
|
||||
|
||||
@@ -84,13 +84,13 @@ time: 分钟
|
||||
- mod的python文件里面有语法错误
|
||||
- mod里面没有modMain.py
|
||||
|
||||
|
||||
|
||||
|
||||
### **mod在联机大厅\网络游戏服上运行的时候，手机客户端的部分逻辑无法正常运行**
|
||||
|
||||
如果开发的mod运行在联机大厅\网络游戏服上面的时候，客户端有一部分逻辑失效了，很有可能是是客户端线程里面import了包含服务端线程内容的模块，导致客户端线程不能正常工作
|
||||
|
||||
|
||||
|
||||
|
||||
## 开发打包设置建议
|
||||
|
||||
@@ -130,8 +130,8 @@ mod里面不要有中文或乱码字符命名的文件（behavior文件夹和res
|
||||
| [1003](#1003) | UI | UI控件controls内缺少特定子控件 | [按钮控件](../../18-界面与交互/30-UI说明文档.md#按钮) |
|
||||
| [2001](#2001) | 自定义远程武器 | 自定义远程武器序列帧未找到对应texture | [自定义远程武器](../15-自定义游戏内容/6-自定义远程武器.md) |
|
||||
| [2002](#2002) | 自定义远程武器 | 自定义远程武器序列帧配置错误 | [自定义远程武器](../15-自定义游戏内容/6-自定义远程武器.md) |
|
||||
| [3001](#3001) | JSON | JSON文件格式错误 | 1.[JSON语法](https://minecraft-zh.gamepedia.com/JSON) 2.[使用vscode检查JSON格式](#使用vscode检查json文件格式) |
|
||||
| [3002](#3002) | JSON | JSON文件内容错误 | [MC官方WIKI](https://minecraft-zh.gamepedia.com/基岩版实体组件文档)
|
||||
| [3001](#3001) | JSON | JSON文件格式错误 | 1.[JSON语法](https://zh.minecraft.wiki/w/JSON) 2.[使用vscode检查JSON格式](#使用vscode检查json文件格式) |
|
||||
| [3002](#3002) | JSON | JSON文件内容错误 | [MC官方WIKI](https://zh.minecraft.wiki/w/基岩版实体组件文档)
|
||||
| [4001](#4001) | 自定义配方 | 配置的物品加载失败 | [自定义物品](../15-自定义游戏内容/1-自定义物品/1-自定义基础物品.md) |
|
||||
| [5001](#5001) | 自定义物品 | 自定义物品ID错误 | [自定义物品](../15-自定义游戏内容/1-自定义物品/1-自定义基础物品.md) |
|
||||
| | | | |
|
||||
@@ -322,7 +322,7 @@ Function: CustomRangedWeaponItem::initClient in c:\editor\handheld\src-plugins\c
|
||||
"category": "Equipment"
|
||||
},
|
||||
"components": {
|
||||
"minecraft:icon": "customrangedweapon:bow",
|
||||
"minecraft:icon": "customrangedweapon:bow",
|
||||
"netease:frame_animation": {
|
||||
"frame_count": 4,
|
||||
"texture_name": "customrangedweapon:bow_frame", # 对应item_texture.json中的命名
|
||||
@@ -395,7 +395,7 @@ Assertion failed: The frame_count (***4***) of custom item (***customrangedweapo
|
||||
"category": "Equipment"
|
||||
},
|
||||
"components": {
|
||||
"minecraft:icon": "customrangedweapon:bow",
|
||||
"minecraft:icon": "customrangedweapon:bow",
|
||||
"netease:frame_animation": {
|
||||
"frame_count": 4, # 自定义远程武器的frame_count配置值
|
||||
"texture_name": "customrangedweapon:bow_frame", # 对应item_texture.json中的命名
|
||||
@@ -468,7 +468,7 @@ Assertion failed: node parse failed: ***minecraft:map_color*** Condition is fals
|
||||
|
||||
##### 解决方案
|
||||
|
||||
在自己的mod目录下搜索上述存在错误内容的字段，检查是否与原生内容中对应字段内容相符。如上述 ***minecraft:map_color***。建议在[MC官方WIKI](https://minecraft-zh.gamepedia.com/基岩版实体组件文档)上搜索此关键字获得对应的描述信息。
|
||||
在自己的mod目录下搜索上述存在错误内容的字段，检查是否与原生内容中对应字段内容相符。如上述 ***minecraft:map_color***。建议在[MC官方WIKI](https://zh.minecraft.wiki/w/基岩版实体组件文档)上搜索此关键字获得对应的描述信息。
|
||||
|
||||
<span id="使用vscode检查json文件格式"></span>附：参考MC中的原生内容
|
||||
|
||||
@@ -478,7 +478,7 @@ Assertion failed: node parse failed: ***minecraft:map_color*** Condition is fals
|
||||
C:\MCStudioDownload\game\MinecraftPE_Netease\1.21.0.119233
|
||||
```
|
||||
|
||||
其中“1.21.0.119233”为版本号，可能发生变化。因此我们需要使用vscode（或其他支持全局搜索的工具）打开“C:\MCStudioDownload\game\MinecraftPE_Netease\1.21.0.119233\data”目录，全局搜索希望参考的字段，**注意**：部分字段在这里是找不到的，但实际也能使用，一般以[MC官方WIKI](https://minecraft-zh.gamepedia.com/基岩版实体组件文档)为准。
|
||||
其中“1.21.0.119233”为版本号，可能发生变化。因此我们需要使用vscode（或其他支持全局搜索的工具）打开“C:\MCStudioDownload\game\MinecraftPE_Netease\1.21.0.119233\data”目录，全局搜索希望参考的字段，**注意**：部分字段在这里是找不到的，但实际也能使用，一般以[MC官方WIKI](https://zh.minecraft.wiki/w/基岩版实体组件文档)为准。
|
||||
|
||||
### <span id="4001"></span>4001
|
||||
|
||||
@@ -524,8 +524,7 @@ Assertion failed: [custom define item]JSON: ***netease_items_beh/caomei.json***
|
||||
"minecraft:item": {
|
||||
"description": {
|
||||
"category": "Construction",
|
||||
"identifier": "caomei", # 错误位置，缺少命名空间，应该改为mymod:caomei
|
||||
"register_to_create_menu": true
|
||||
"identifier": "caomei" //错误位置，缺少命名空间，应该改为mymod:caomei
|
||||
},
|
||||
"components": {
|
||||
"minecraft:max_stack_size": 64
|
||||
|
||||
Reference in New Issue
Block a user