feat:上传mcguide-开发指南部份
This commit is contained in:
Othniel su
509
mcguide/27-网络游戏/课程5：插件教学/第1节：官网插件规范.md
Normal file
509
mcguide/27-网络游戏/课程5：插件教学/第1节：官网插件规范.md
Normal file
@@ -0,0 +1,509 @@
|
||||
---
|
||||
front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/chajian_01.bad9625d.png
|
||||
hard: 进阶
|
||||
time: 20分钟
|
||||
---
|
||||
|
||||
# 官网插件规范
|
||||
这个文档描述了官网公开插件（即公开下载并许可任意服主使用的插件）的开发规范，自用插件也建议参照此规范。
|
||||
|
||||
## 规范主旨
|
||||
* 减少插件间的冲突问题（如界面重叠、目录或文件冲突、无法加载等）
|
||||
* 统一规范，增加可读性
|
||||
* 便于使用和二次开发
|
||||
|
||||
## 重要名词解释
|
||||
|
||||
### 团队名
|
||||
* 每个官网公开插件的开发团队，都需要一个全局唯一的团队名，比如官方的团队名为**netease**
|
||||
* 团队名仅能使用小写英文字符+数字，并且不能以数字开头，团队名限制最大字符数为10
|
||||
### 插件名
|
||||
* 每个插件都需要有一个与插件具体实现的功能相关的插件名，比如官方的公告插件的插件名为**announce**
|
||||
* 插件名仅能使用小写英文字符+数字，并且不能以数字开头，插件名限制最大字符数为20
|
||||
|
||||
|
||||
## 插件目录命名规范
|
||||
### 根目录命名
|
||||
插件【强制要求】按照运行的具体服务器类型（游戏服、功能服等）分目录，【强制要求】每种服务器都需要创建一个目录，目录【强制要求】使用驼峰法命名，【强制要求】以**团队名**开头，具体规范如下：
|
||||
|
||||
- 大厅服/游戏服 插件目录名规范：团队名（全小写）+ 插件名（首字母大写）
|
||||
- 控制服 插件目录名规范：团队名（全小写）+ 插件名（首字母大写） + Master
|
||||
- 功能服 插件目录名规范：团队名（全小写）+ 插件名（首字母大写） + Service
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，功能涉及到master、service和lobby，目录结构如下所示：
|
||||
|
||||
```
|
||||
|
||||
├─lovecraftGuildMaster
|
||||
├─lovecraftGuild
|
||||
├─lovecraftGuildService
|
||||
|
||||
```
|
||||
### 大厅服/游戏服目录命名
|
||||
【强制要求】大厅服/游戏服的目录结构类似。以**团队名**为**lovecraft**，**插件名**为**guild**为例介绍目录结构，其目录结构如下所示：
|
||||
```
|
||||
lovecraftGuild
|
||||
│ mod.sql
|
||||
│ readme.txt
|
||||
│ server.properties
|
||||
│
|
||||
├─behavior_packs
|
||||
├─developer_mods
|
||||
├─resource_packs
|
||||
├─worlds
|
||||
└─studio_res
|
||||
|
||||
```
|
||||
各个目录和文件的说明如下：
|
||||
名字|含义|是否必须
|
||||
---|:---|---:
|
||||
mod.sql|记录需要执行的sql语句，使用utf-8编码|否
|
||||
readme.txt|mod介绍，使用utf-8编码|是
|
||||
server.properties|mc server配置|否
|
||||
behavior_packs|存放行为包|否
|
||||
developer_mods|存放服务端mod|否
|
||||
resource_packs|存放资源包|否
|
||||
worlds|存放地图|否
|
||||
studio_res|存放美术资源工程|否
|
||||
#### behavior_packs目录
|
||||
* 行为包使用的根目录【强制要求】以**团队名**+**插件名**开头，并以**Behavior**（或**behavior**）结尾、中间可以添加任意英文字符+数字，【建议】以驼峰法区隔（首字符大写），【建议】在非必须的情况下，直接以**团队名**（全小写）+**插件名**（首字母大写）+**Behavior**命名。
|
||||
* 代码的根目录，【强制要求】以**团队名**+**插件名**开头，并以**Script**（或**script**）结尾、中间可以添加任意英文字符+数字，【建议】以驼峰法区隔（首字符大写），【建议】在非必须的情况下，直接以**团队名**（全小写）+**插件名**（首字母大写）+**Script**命名。
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，示例如下：
|
||||
```
|
||||
behavior_packs
|
||||
└─lovecraftGuildBehavior
|
||||
│ manifest.json
|
||||
│
|
||||
└─lovecraftGuildScript
|
||||
```
|
||||
各个目录和文件的说明如下：
|
||||
名字|含义
|
||||
---|:---
|
||||
lovecraftGuildBehavior|行为包的根目录。
|
||||
manifest.json|行为包manifest配置
|
||||
lovecraftGuildScript|代码文件的根目录，从此目录开始import模块。
|
||||
#### developer_mods目录
|
||||
* 根目录【强制要求】以**团队名**+**插件名**开头，并以**Dev**（或**dev**）结尾、中间可以添加任意英文字符+数字，【建议】以驼峰法区隔（首字符大写），【建议】在非必须的情况下，直接以**团队名**（全小写）+**插件名**（首字母大写）+**Dev**命名。
|
||||
* 代码的根目录，【强制要求】以**团队名**+**插件名**开头，并以**Script**（或**script**）结尾、中间可以添加任意英文字符+数字，【建议】以驼峰法区隔（首字符大写），【建议】在非必须的情况下，直接以**团队名**（全小写）+**插件名**（首字母大写）+**Script**命名。
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，示例如下：
|
||||
```
|
||||
developer_mods
|
||||
└─lovecraftGuildDev
|
||||
│ mod.json
|
||||
└─lovecraftGuildScript
|
||||
```
|
||||
名字|含义
|
||||
---|:---
|
||||
lovecraftGuildDev|服务端mod的根目录。
|
||||
lovecraftGuildScript|代码文件的根目录，从此目录开始import模块。
|
||||
mod.json|记录插件的全部配置，该配置能被开发者改动。
|
||||
#### resource_packs目录
|
||||
* 根目录【强制要求】以**团队名**+**插件名**开头，并以**Res**（或**res**）结尾、中间可以添加任意英文字符+数字，【建议】以驼峰法区隔（首字符大写），【建议】在非必须的情况下，直接以**团队名**（全小写）+**插件名**（首字母大写）+**Res**命名。
|
||||
```
|
||||
resource_packs
|
||||
└─lovecraftGuildRes
|
||||
| manifest.json
|
||||
└─ui
|
||||
└─textures
|
||||
```
|
||||
名字|含义
|
||||
---|:---
|
||||
lovecraftGuildRes|资源包的根目录。
|
||||
manifest.json|资源包manifest配置
|
||||
ui|UI的JSON文件的根目录。
|
||||
textures|各种贴图资源的根目录。
|
||||
#### worlds目录
|
||||
* 【强制要求】在**worlds**目录下创建命名为**level**的目录
|
||||
* 【强制要求】在level目录下，如果有行为包则必须有**worlds/level/world_behavior_packs.json**；如果有资源包则必须有**worlds/level/world_resource_packs.json**
|
||||
```
|
||||
worlds
|
||||
└─level
|
||||
| world_behavior_packs.json
|
||||
| world_resource_packs.json
|
||||
```
|
||||
* 【强制要求】world_behavior_packs.json 文件中定义必须与行为包中 manifest.json 的modules对应
|
||||
```
|
||||
[
|
||||
{
|
||||
"pack_id" : "d09c6ae2-e9b7-4640-b850-942678294b72",
|
||||
"version" : [ 0, 0, 1122]
|
||||
}
|
||||
]
|
||||
```
|
||||
* 【强制要求】world_resource_packs.json 文件中定义必须与资源包中 manifest.json 的modules对应
|
||||
```
|
||||
[
|
||||
{
|
||||
"pack_id" : "bab4cb59-b369-45b1-abbd-3ab43b6f86fa",
|
||||
"version" : [ 0, 0, 1122]
|
||||
}
|
||||
]
|
||||
```
|
||||
#### studio_res目录
|
||||
* 【强制要求】这个目录对服务器或客户端MOD运行没有任何影响，只是用于保存当前插件所使用到的资源工程导出文件
|
||||
* 【强制要求】其目录结构如下，直接放置对应的资源工程导出文件
|
||||
```
|
||||
studio_res
|
||||
├─主菜单插件.zip
|
||||
|
||||
```
|
||||
|
||||
### 控制服/功能服目录命名
|
||||
只会包含developer_mods，与大厅服/游戏服的developer_mods目录规范相同
|
||||
|
||||
### mod.sql文件编写规范
|
||||
* 【强制要求】若插件功能涉及多个服务器，则mod.sql只用放到一种类型服务器的下面，mod.sql存放优先级是：功能服>大厅服/游戏服>控制服。
|
||||
* 【强制要求】请使用Mysql数据库实现长时效信息存储
|
||||
* 【强制要求】使用InnoDB，编码为utf8mb4
|
||||
* 【建议】每个字段必须有注释。
|
||||
* 【强制要求】文件要求是utf-8编码。
|
||||
* 表名【强制要求】**团队名**+**插件名**开头，中间可以使用**下划线**连接，但【建议】以驼峰法区隔（首字符大写）；【建议】比如说**团队名**为**lovecraft**，**插件名**为**guild**的插件，数据库表名均应类似于**lovecraftGuildXx**
|
||||
* 【强制要求】所有版本sql语句都放到mod.sql中，用注释分割不同mod版本的使用到的sql。一个示例如下：
|
||||
```sql
|
||||
-- ###########################version1.0.0####################
|
||||
create table lovecraftGuild(
|
||||
id int unsigned not null COMMENT '唯一id'
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||||
-- ###########################version1.0.1####################
|
||||
create table lovecraftGuild2(
|
||||
id int unsigned not null COMMENT '唯一id'
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||||
```
|
||||
### mod.json文件编写规范
|
||||
通常需要包含下面配置：
|
||||
属性|含义
|
||||
---|:---
|
||||
netgame_mod_name|插件名字
|
||||
netgame_mod_version|插件版本，版本要求从“1.0.0”开始
|
||||
min_app_version|最低引擎版本
|
||||
max_app_version|最高版本引擎，没配置则表示不限
|
||||
support_server_type|列表，支持的服务器类型，包括game/lobby/master/service几种类型
|
||||
author|团队名
|
||||
group|可以不配置，表示插件隶属的功能。若一个功能涉及多个插件，则建议将多个插件group设置成一样的。
|
||||
module_names(service mod需要)|配置当前service mod的模块名，要求与插件名一样，并且能够在deploy.json中service下module_names配置中找到。用于Service的RPC调用，对应RegisterRpcMethodForMod和RequestToService中的参数module。
|
||||
|
||||
【强制要求】所有能被改动属性都配置到该文件，可以用"_comment"给字段加注释。
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，一个简单示例如下：
|
||||
|
||||
```json
|
||||
{
|
||||
"netgame_mod_name":"lovecraftGuild",
|
||||
"netgame_mod_version":"1.0.0",
|
||||
"min_app_version":"1.15.0",
|
||||
"support_server_type":["lobby"],
|
||||
"author":"lovecraft",
|
||||
"group":"lovecraftGuild",
|
||||
|
||||
"_comment":"公会名称最多支持多少个字符",
|
||||
"guild_name_limit":20,
|
||||
...
|
||||
}
|
||||
```
|
||||
### readme.txt文件编写规范
|
||||
【强制要求】"type"用法规范：它是python变量的类型名，统一使用下列类型名 bool、int、float、double、str、dict、tuple、list(str)、list(int)、object、function、User Defined Class Name。
|
||||
|
||||
【强制要求】文件格式：缩进用空格，不用tab；要求用utf-8格式。
|
||||
|
||||
【强制要求】文件构成如下：
|
||||
|
||||
- 插件介绍
|
||||
- 插件构成
|
||||
- 使用步骤
|
||||
- 插件api
|
||||
```
|
||||
（1）api功能描述
|
||||
适用范围：客户端/大厅服/游戏服/控制服/功能服
|
||||
函数：funcname(arg1,args2...)
|
||||
参数：
|
||||
（如果没有参数，也写 无 ）
|
||||
arg1: type，描述
|
||||
arg2: type，描述
|
||||
返回:
|
||||
（如果没有返回，也写 无 ）
|
||||
int, test的返回值
|
||||
示例：
|
||||
a = funcname(1,2)
|
||||
```
|
||||
- 插件event
|
||||
```
|
||||
（1）event名字
|
||||
适用范围：客户端/大厅服/游戏服/控制服/功能服
|
||||
命名空间：namespace = 'xxx', systemname = 'xxx'
|
||||
描述：event的描述
|
||||
参数：
|
||||
（如果没有参数，也写 无 ）
|
||||
arg1: type, arg1描述
|
||||
```
|
||||
- 运营指令
|
||||
```
|
||||
运营指令功能介绍
|
||||
post url: http:masterip:masterport/baseurl
|
||||
post body:{
|
||||
"key" : value#注释
|
||||
}
|
||||
response:
|
||||
{
|
||||
"code": 1, #code=1表示成功，其他表示失败
|
||||
"entity": {
|
||||
"key": value #注释
|
||||
},
|
||||
"message": ""
|
||||
}
|
||||
```
|
||||
- 更新记录
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，一个示例如下：
|
||||
```
|
||||
插件介绍：这是个公会插件
|
||||
|
||||
插件构成：
|
||||
（1）lovecraftGuild: 部署于大厅服或游戏服。
|
||||
（2）lovecraftGuildMaster: 部署于控制服。
|
||||
（3）lovecraftGuildService: 部署于功能服。
|
||||
|
||||
使用步骤：
|
||||
1、请在mysql中执行mod.sql
|
||||
2、配置mod.json，请按照文件mod.json中"_comment"注释配置对应内容。
|
||||
3、MCStudio把lovecraftGuild添加到大厅服或游戏服。
|
||||
4、MCStudio把lovecraftGuildMaster添加到控制服。
|
||||
5、MCStudio把lovecraftGuildService添加到功能服。
|
||||
|
||||
插件api：
|
||||
（1）获取玩家昵称api
|
||||
适用范围：大厅服/游戏服
|
||||
函数：GetNickname(uid)
|
||||
参数：
|
||||
uid: int，玩家id
|
||||
返回：
|
||||
string，玩家的昵称
|
||||
示例：
|
||||
import server.extraServerApi as serverApi
|
||||
system = serverApi.GetSystem("lovecraftGuild", "lovecraftGuildDev")
|
||||
system.GetNickname(123)#获取玩家的昵称
|
||||
|
||||
插件event：
|
||||
（1）GuildEvent
|
||||
适用范围：大厅服/游戏服
|
||||
命名空间：namespace = 'lovecraftGuild', systemname = 'lovecraftGuildDev'
|
||||
描述：测试的event
|
||||
参数：
|
||||
uid: int,玩家id
|
||||
nickname: str,玩家昵称
|
||||
示例：
|
||||
def __init__(self, namespace, systemName):
|
||||
self.ListenForEvent('lovecraftGuild', 'lovecraftGuildDev', 'GuildEvent', self, self.OnGuildEvent)
|
||||
|
||||
def OnGuildEvent(self, data):
|
||||
uid = data['uid']
|
||||
nickname = data['nickname']
|
||||
|
||||
运营指令：
|
||||
（1）test指令
|
||||
post url: http:masterip:masterport/test
|
||||
post body:{
|
||||
"uid" : 123#玩家id
|
||||
}
|
||||
response:
|
||||
{
|
||||
"code": 1,
|
||||
"entity": {
|
||||
"name": "player_name" #玩家昵称
|
||||
},
|
||||
"message": ""
|
||||
}
|
||||
|
||||
更新列表：
|
||||
1.0.1版本：
|
||||
新增指令/test
|
||||
```
|
||||
|
||||
### server.properties文件编写规范
|
||||
|
||||
原版minecraft server中含有一个同名的设置文件，里面可配置的字段可参考[wiki文档](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)
|
||||
|
||||
可以在插件中放置一个server.properties，在部署时会自动拼接到服务器的server.properties中，这意味着您可以只写一部分所需的属性
|
||||
|
||||
需要注意在文件的**末尾需要有一个空行**
|
||||
|
||||
需要特别提一下client-side-chunk-generation-enabled这个属性：这是2.5版本后新增的字段，用来控制是否开启客户端本地的地图生成。如果您的服务器地图大部分都不是自然生成的（除了生存服应该都是这种情况），请把这个属性配置为false
|
||||
|
||||
以下是一个server.properties示例（注意最后有一个空行）：
|
||||
|
||||
```yml
|
||||
client-side-chunk-generation-enabled=false
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 美术资源命名规范
|
||||
|
||||
由于Windows的操作系统，文件名与路径名是无视大小写的，但是手机的操作系统，文件名和路径名都是区分大小写的，考虑到studio的开发环境和最终手机环境的一致性，所以在美术资源的命名中，在目录和文件名命名规则中不使用驼峰法，【强制要求】使用**小写英文字符**并以**下划线**连接。
|
||||
### UI界面
|
||||
#### JSON文件
|
||||
* 【强制要求】务必使用studio自带的界面编辑器生成UI的JSON文件，并保留UI的工程文件
|
||||
* 【强制要求】所有的UI的JSON文件，均需要以**团队名**（全小写）+**下划线**+**插件名**（全小写）+**下环线**开头
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，示例如下：
|
||||
```
|
||||
resource_packs
|
||||
└─lovecraftGuildRes
|
||||
| manifest.json
|
||||
└─ ui
|
||||
| _ui_defs.json
|
||||
| lovecraft_guild_create.json
|
||||
| lovecraft_guild_info.json
|
||||
└─ ui
|
||||
└─ textures
|
||||
```
|
||||
名字|含义
|
||||
---|:---
|
||||
_ui_defs.json|记录了一共有哪些json文件，由studio的界面编辑器自动生成。
|
||||
lovecraft_guild_create.json|界面的json描述文件，对应编辑器中的【lovecraft_guild_create】界面。
|
||||
lovecraft_guild_info.json|界面的json描述文件，对应编辑器中的【lovecraft_guild_info】界面。
|
||||
#### 界面贴图资源
|
||||
【强制要求】所有UI使用到的贴图资源，均需要放置在以**团队名**（全小写）+**下划线**+**插件名**（全小写）命名的子目录下
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，示例如下：
|
||||
```
|
||||
resource_packs
|
||||
└─lovecraftGuildRes
|
||||
| manifest.json
|
||||
└─ ui
|
||||
└─ textures
|
||||
└─ ui
|
||||
└─ lovecraft_guild
|
||||
| btn01@3x.png
|
||||
| ...
|
||||
└─ ...
|
||||
```
|
||||
名字|含义
|
||||
---|:---
|
||||
lovecraft_guild|插件UI贴图的根目录。
|
||||
btn01@3x.png|某个按钮用到的图片。
|
||||
|
||||
### 模型与特效资源
|
||||
* 【强制要求】模型资源经过编辑器导出之后，会分解到多个目录且各个文件中有一定的相关性，命名依旧要求以**团队名**（全小写）+**下划线**+**插件名**（全小写）+**下环线**开头。
|
||||
* 【强制要求】特效资源同样要经过编辑器导出，命名依旧要求以**团队名**（全小写）+**下划线**+**插件名**（全小写）+**下环线**开头。
|
||||
|
||||
假设**团队名**为**lovecraft**，**插件名**为**guild**，那么要求的前缀为**lovecraft_guild_**，示例如下：
|
||||
```
|
||||
resource_packs
|
||||
└─lovecraftGuildRes
|
||||
| manifest.json
|
||||
└─ ui
|
||||
└─ textures
|
||||
└─ effects
|
||||
| lovecraft_guild_guanghuan_01.json
|
||||
└─ ...
|
||||
└─ models
|
||||
└─ animation
|
||||
| lovecraft_guild_chibang_animation_idle.json
|
||||
└─ ...
|
||||
└─ mesh
|
||||
| lovecraft_guild_chibang_mesh.json
|
||||
└─ ...
|
||||
└─ skeleton
|
||||
| lovecraft_guild_chibang_skeleton.json
|
||||
└─ ...
|
||||
netease_models.json
|
||||
```
|
||||
名字|含义
|
||||
---|:---
|
||||
lovecraftGuildRes/effects|放置序列帧特效与粒子特效文件的根目录
|
||||
lovecraft_guild_guanghuan_01.json|描述一个序列帧特效的json文件
|
||||
lovecraftGuildRes/effects/models/animation| 放置模型动作文件的根目录
|
||||
lovecraft_guild_chibang_animation_idle.json|描述一个翅膀模型的idle动作的json文件
|
||||
lovecraftGuildRes/effects/models/mesh|放置模型mesh文件的根目录
|
||||
lovecraft_guild_chibang_mesh.json|描述一个翅膀模型的mesh的json文件
|
||||
lovecraftGuildRes/effects/models/skeleton|放置模型骨骼文件的根目录
|
||||
lovecraft_guild_chibang_skeleton.json|描述一个翅膀模型的骨骼的json文件
|
||||
netease_models.json|模型信息统合文件，由studio编辑器生成和维护
|
||||
|
||||
## 自定义物品与实体命名规范
|
||||
* 自定义物品/实体的namespace，【强制要求】使用**团队名**+**插件名**的方式命名，中间可以使用**下划线**连接，但【建议】以驼峰法区隔（首字符大写）；【建议】假设**团队名**为**lovecraft**，**插件名**为**guild**，那么此插件的自定义物品/实体的**identifier**必须类似于**lovecraftGuild:xx**
|
||||
* 自定义物品/实体的各种json配置文件，【强制要求】以**团队名**（全小写）+**下划线**+**插件名**（全小写）+**下环线**开头；【强制要求】假设**团队名**为**lovecraft**，**插件名**为**guild**，那么描述此插件的自定义物品/实体的json文件，必须类似于**lovecraft_guild_xx.json**
|
||||
|
||||
## 界面开发注意事项
|
||||
### 注意隐藏/显示界面的方式
|
||||
【强制要求】需要使用``uiNode.SetScreenVisible(True/False)``的方式，显示/隐藏整个json界面，而不是使用SetVisible界面中的全部控件的方式
|
||||
### 注意界面分层
|
||||
* 【强制要求】插件的所有**弹出**界面（即会阻挡游戏默认的摇杆、攻击操作的界面）都需要根据所处的位置和用途，分类到不同界面层中，并在初始化后使用``uiNode.SetLayer("", int)``设置自身的所在的层次
|
||||
* 界面层次的宏定义位于minecraftEnum.py中
|
||||
```python
|
||||
class UiBaseLayer(object):
|
||||
"""
|
||||
@description 自定义UI界面的层次宏定义，用于在多个插件之间协调UI界面的遮挡关系
|
||||
@author xltang
|
||||
@version 1.21
|
||||
@state 1.21 新增 xltang 自定义UI界面的层次宏定义
|
||||
"""
|
||||
Desk = 0 # 主界面常驻，无需SetLayer
|
||||
DeskFloat = 15000 # 主界面浮动提示（浮动提示信息），无需SetLayer，使用编辑器设置layer的方式调整层次
|
||||
PopUpLv1 = 25000 # 一级弹出界面，必须SetLayer
|
||||
PopUpLv2 = 45000 # 二级弹出界面，必须SetLayer
|
||||
PopUpModal = 60000 # 模态弹出界面（弹出提示），必须SetLayer
|
||||
PopUpFloat = 75000 # 模态弹出之上的浮动提示（大喇叭），无需SetLayer，使用编辑器设置layer的方式调整层次
|
||||
```
|
||||
* 界面创建的示例代码
|
||||
```python
|
||||
import client.extraClientApi as clientApi
|
||||
clientApi.RegisterUI("neteaseAppear","shop","neteaseAppearScript.appearShopUi.ShopScreen","netease_appear_shopUI.main")
|
||||
clientApi.CreateUI("neteaseAppear", "shop", {"isHud" : 1})
|
||||
shopUI = clientApi.GetUI("neteaseAppear", "shop")
|
||||
shopUI.SetLayer("", clientApi.GetMinecraftEnum().UiBaseLayer.PopUpLv1)
|
||||
shopUI.SetScreenVisible(False)
|
||||
```
|
||||
#### 界面所属层次示例
|
||||
* 界面到底应该属于哪一个层和具体的需求、界面交互逻辑相关，并没有唯一的标准。
|
||||
* 二级弹出界面与模态弹出界面，并没有明确的区分标准，一般来说只在某个特定一级弹出界面上出现的是二级弹出界面，而在多种情况下都可能显示的通用提示确认界面是模态弹出界面
|
||||
* 二级弹出界面可以与对应的一级弹出界面位于同一个JSON上，而不是独立的一个JSON，具体是否要分离，需要考虑具体界面的复杂度与易用性。
|
||||
* 以下是一些常见界面的所属界面层次示例
|
||||
##### 主界面常驻
|
||||
主菜单插件中的按钮面板
|
||||
|
||||
|
||||
##### 主界面浮动提示
|
||||
默认聊天提示信息
|
||||
|
||||
##### 一级弹出界面
|
||||
公会插件的创建公会界面
|
||||
|
||||
##### 二级弹出界面
|
||||
公会插件的创建公会输入公会名、确认的子界面
|
||||
|
||||
##### 模态弹出界面
|
||||
组队插件的离开队伍确认界面
|
||||
|
||||
##### 浮动提示界面
|
||||
物品属性提示tips
|
||||
|
||||
|
||||
## 建议规范
|
||||
以下规范为建议采用，不强制要求
|
||||
### 编码规范
|
||||
【建议】名字命名尽量用驼峰法命名。具体如下：
|
||||
* mod中所有目录和文件都是用驼峰法命名，首字母小写，比如目录modClient。
|
||||
* 所有类名都是用驼峰法命名，首字母大写，比如类 GameObjectType。
|
||||
* 常量都使用驼峰法命名，首字母大写，比如 ModVersion = "0.0.1"
|
||||
* 类非静态成员函数使用驼峰法命名，以“m”开头，例如 mLevel。
|
||||
* 类非静态成员函数使用驼峰法命名，首字母大写，例如 Init()。
|
||||
* event使用驼峰法命名，首字母大写，例如“PlayerTransactionFromClientEvent”
|
||||
* 统一用tab而不是四个空格缩进。
|
||||
* system中namespace+systemName要求是唯一，namespace要求与插件名一样，systemName根据自己要求定义。
|
||||
* service使用到的module name要求与插件名一样。
|
||||
示例：
|
||||
```python
|
||||
# 公告插件service system定义
|
||||
class AnnounceServiceSystem(ServiceSystem):
|
||||
def __init__(self, namespace, systemName):
|
||||
for moduleName in serviceConf.get_module_names():
|
||||
# ModNameSpace = "neteaseAnnounce"
|
||||
if moduleName.startswith(announceConsts.ModNameSpace):
|
||||
mgr = self.CreateAnnounceMgr(moduleName)
|
||||
else:
|
||||
continue
|
||||
self.mActionMgrs[moduleName] = mgr
|
||||
```
|
||||
Reference in New Issue
Block a user