配置介绍
常规状态类型配置
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| StateKey | str | 该状态唯一Key |
| EmptyIconPath | str | 该状态UI显示的空图片路径 |
| FilledIconPath | str | 该状态UI显示的满图片路径 |
| MaxValue | int | 该状态最大值 |
| ProgressLimit | list[min, max] | 该状态进度条内容物区间 注意！！！这里是通过MCStudio中看的值，实际上是[1-min, 1-max] |
| NormalValue | int | 该状态默认值 |
Buff/Debuff状态类型配置
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| StateKey | str | 该状态唯一Key |
| EmptyIconPath | str | 该状态UI显示的空图片路径 |
| FilledIconPath | str | 该状态UI显示的满图片路径 |
| MaxValue | int | 固定为1 |
| ProgressLimit | list[min, max] | 固定为[0, 0] |
| NormalValue | int | 固定为1 |
玩家状态存储数据样式
玩家状态存储数据是一个Key为StateKey、Value如下样式的dict类型
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| Value | int | 该状态当前值 |
| Speed | int | 该状态当前增幅 |
| Level | int | 该状态当前等级 |
接口
GetPlayerStateData
服务端
-
描述
获取玩家状态数据 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
-
返回值
该玩家的状态数据字典，不存在则返回空字典 (dict) -
备注
无 -
示例
StateSystem = serverApi.GetSystem('State', 'StateServerSystem')
PlayerData = StateSystem.GetPlayerStateData(PlayerId)
print PlayerData
AddPlayerBuffState
服务端
-
描述
添加玩家BUFF状态类型，例如骨折等 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| StateLevel | int | 该状态的等级，状态等级为0时则删除该玩家的Buff |
-
返回值
无 -
备注
无
SetPlayerStateValue
服务端
-
描述
设置玩家状态值，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| NewValue | int | 该状态新的值 |
-
返回值
无 -
备注
无
SetPlayerStateSpeed
服务端
-
描述
设置玩家状态值流速，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| Speed | int | 该状态新的流速 |
-
返回值
无 -
备注
无
SetPlayerStateLevel
服务端
-
描述
设置玩家状态值等级，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| Level | int | 该状态新的等级 |
-
返回值
无 -
备注
无
AddPlayerStateLevel
服务端
-
描述
添加/减少玩家状态值等级，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| DeltaValue | int | 该状态添加/减少的等级 |
-
返回值
无 -
备注
无
AddPlayerStateSpeed
服务端
-
描述
添加/减少玩家状态值流速，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| DeltaSpeed | int | 该状态添加/减少的流速 |
-
返回值
无 -
备注
无
AddPlayerStateValue
服务端
-
描述
添加/减少玩家状态值，仅用于标记和控制显示，不包含实际流速逻辑 -
参数
| 参数名 | 数据类型 | 说明 |
|---|---|---|
| PlayerId | str | 玩家Id |
| StateKey | str | 状态类型Key |
| DeltaValue | int | 该状态添加/减少的值 |
-
返回值
无 -
备注
无
