同步官网文档8m_25d
This commit is contained in:
@@ -68,10 +68,10 @@ selection: true
|
||||
```json
|
||||
// world_behavior_packs.json
|
||||
[
|
||||
|
||||
|
||||
{
|
||||
"pack_id" : "93c89241-3ecb-478f-a16c-c5eb99ceb580",
|
||||
"type": "Addon",
|
||||
"type": "Addon",
|
||||
"version" : [ 0, 0, 1 ]
|
||||
}
|
||||
]
|
||||
@@ -82,7 +82,7 @@ selection: true
|
||||
[
|
||||
{
|
||||
"pack_id": "614ba977-6b46-42da-afb6-50fa5a568ab6",
|
||||
"type": "Addon",
|
||||
"type": "Addon",
|
||||
"version" : [ 0, 0, 1 ]
|
||||
}
|
||||
]
|
||||
|
||||
@@ -230,7 +230,7 @@ def callback(data):
|
||||
# 数据冲突,直接用返回的数据更新mPoint
|
||||
newData = {i["key"]: i["value"] for i in data["entity"]["data"]}
|
||||
self.mPoint[playerId] = newData.get('point', DEFAULT_POINT)
|
||||
|
||||
|
||||
def getter():
|
||||
return [
|
||||
{
|
||||
@@ -238,7 +238,7 @@ def getter():
|
||||
'value': self.mPoint[playerId] + self.mDeltaPoint[playerId]
|
||||
}
|
||||
]
|
||||
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
@@ -12,71 +12,71 @@ time: 15分钟
|
||||
|
||||
### API
|
||||
- SetArenaGamePlayerReady
|
||||
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
设置当前玩家准备完毕时调用
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
无参数
|
||||
|
||||
|
||||
- 示例
|
||||
|
||||
|
||||
```python
|
||||
import mod.client.extraClientApi as clientApi
|
||||
clientApi.SetArenaGamePlayerReady()
|
||||
```
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
MOD开发者必须调用此函数
|
||||
|
||||
|
||||
- CancelArenaGamePlayerReady
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
设置玩家取消准备时调用
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
无参数
|
||||
|
||||
|
||||
- 示例
|
||||
|
||||
|
||||
```python
|
||||
import mod.client.extraClientApi as clientApi
|
||||
clientApi.CancelArenaGamePlayerReady()
|
||||
```
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
此接口为可选调用
|
||||
|
||||
### 事件
|
||||
- ClientArenaGameAllPlayerReadyEvent
|
||||
|
||||
|
||||
- 说明
|
||||
当前游戏所有玩家准备完毕后,竞技组件向客户端发出的事件
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
无参数
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
MOD开发者可选择监听此事件切换游戏状态,也可以忽略由自定义的MOD服务端逻辑控制游戏状态切换
|
||||
|
||||
|
||||
- ClientArenaGameFinishEvent
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
MOD开发者调用结束API后,竞技组件向客户端发出的结束事件
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
游戏结果
|
||||
|
||||
|
||||
```python
|
||||
[
|
||||
{
|
||||
@@ -97,7 +97,7 @@ time: 15分钟
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
|
||||
| 关键字 | 数据类型 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| camp_id | int | 阵营,不区分默认选0,区分最多三个阵营1,2,3 |
|
||||
@@ -106,7 +106,7 @@ time: 15分钟
|
||||
| uid | list string array | 玩家id列表 |
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
MOD开发者可选择监听此事件获取游戏结果,也可以由自定义事件从MOD服务端获取结果。在收到此事件后,5秒后竞技组件服务端会自动远程调用关闭当前游戏。
|
||||
|
||||
## MOD服务端接入
|
||||
@@ -116,20 +116,20 @@ time: 15分钟
|
||||
- SetArenaGameResult
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
当前游戏结束时调用,由开发者传入最后结果
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
| 关键字 | 数据类型 | 说明 |
|
||||
| --- | --- | ---|
|
||||
| camp_id | int | 阵营,不区分默认选0,区分最多三个阵营1,2,3 |
|
||||
| result | int | 比赛胜负:0:平局,1:胜利,2:失败 |
|
||||
| score | int | 分数,不需要时传null |
|
||||
| uid | list string array | 玩家id列表 |
|
||||
|
||||
|
||||
- 示例
|
||||
|
||||
|
||||
```python
|
||||
resList = [
|
||||
{
|
||||
@@ -151,11 +151,11 @@ time: 15分钟
|
||||
]
|
||||
serverApi.SetArenaGameResult(resList)
|
||||
```
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
- 分数设置相关:
|
||||
|
||||
|
||||
- 如果指定自定义的分数,则每项都需要设置`score`的分数。
|
||||
- 如果使用排行系统默认设置的分数,则每项`score`的值需要设置为None。
|
||||
- 如果设置`result`为2时,即设置为输时,分时需要传递扣去分数`score`正数而不是负数
|
||||
@@ -166,49 +166,49 @@ time: 15分钟
|
||||
- ServerArenaGameAllPlayerReadyEvent
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
当前游戏所有玩家准备完毕后,竞技组件向服务端发出的事件
|
||||
- 参数
|
||||
|
||||
|
||||
无参数
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
MOD开发者可选择监听此事件切换游戏状态,也可以忽略由自定义的MOD服务端逻辑控制游戏状态切换
|
||||
|
||||
- ServerArenaGamePlayerReconnectSuccessEvent
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
玩家掉线后再次连入时,如果没有超时则触发该事件
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
| 关键字 | 数据类型 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| playerId | str | player的entityId |
|
||||
| uid | str | 玩家的uid |
|
||||
|
||||
|
||||
- 备注
|
||||
MOD开发者可选择监听此事件决定玩家重连状态。
|
||||
|
||||
- ServerArenaGamePlayerReconnectFailedEvent
|
||||
|
||||
- 说明
|
||||
|
||||
|
||||
玩家掉线后再次连入时,超时则触发该事件
|
||||
|
||||
|
||||
- 参数
|
||||
|
||||
|
||||
| 关键字 | 数据类型 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| playerId | str | player的entityId |
|
||||
| uid | str | 玩家的uid |
|
||||
|
||||
|
||||
- 备注
|
||||
|
||||
|
||||
MOD开发者可选择监听此事件,玩家超时重连会被竞技组件发送消息强制退出该局游戏。
|
||||
|
||||
|
||||
- ServerSetGameResultFailed
|
||||
|
||||
- 说明
|
||||
@@ -226,7 +226,7 @@ time: 15分钟
|
||||
- 备注
|
||||
|
||||
错误码含义和对应的详细信息如下:
|
||||
|
||||
|
||||
> **4**:参数为空,缺少某个参数
|
||||
>
|
||||
> **12**:参数错误,具体见details
|
||||
|
||||
Reference in New Issue
Block a user