同步官网文档8m_25d

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

View File

@@ -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 ]
}
]

View File

@@ -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]
}
]
```

View File

@@ -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区分最多三个阵营123 |
@@ -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区分最多三个阵营123 |
| 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