权限
适用版本:中国版 3.10。仅中国版可用。
本文主要记录权限相关的接口,共 12 个。
网易官方文档GetPlayerAbilities
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
获取玩家具体权限。
- 说明
- 示例
GetPlayerAbilities() -> Dict[str, Any]
返回值:Dict[str, Any],具体权限,详见备注。
备注
- 具体权限说明。
| 权限字段 | 数据类型 | 说明 |
|---|---|---|
| build | bool | 放置方块 |
| mine | bool | 采集方块 |
| doorsandswitches | bool | 使用门和开关 |
| opencontainers | bool | 打开容器 |
| attackplayers | bool | 攻击玩家 |
| attackmobs | bool | 攻击生物 |
| op | bool | 操作员命令 |
| teleport | bool | 使用传送 |
- 返回值示例。
{'teleport': True, 'opencontainers': True, 'mine': True, 'build': True, 'op': True, 'attackmobs': True, 'doorsandswitches': True, 'attackplayers': True}
{'teleport': True, 'opencontainers': True, 'mine': True, 'build': True, 'op': True, 'attackmobs': True, 'doorsandswitches': True, 'attackplayers': True}
GetPlayerOperation
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
获取玩家权限类型信息。
- 说明
- 示例
GetPlayerOperation() -> int
返回值:int,权限类型,Visitor 为 0,Member 为 1,Operator 为 2,Custom 为 3。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
operation = comp.GetPlayerOperation()
SetAttackMobsAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否攻击生物。
- 说明
- 示例
SetAttackMobsAbility(canAttack: bool) -> bool
- canAttack: bool,能否攻击生物。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetAttackMobsAbility(False)
SetAttackPlayersAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否攻击其他玩家。
- 说明
- 示例
SetAttackPlayersAbility(canAttack: bool) -> bool
- canAttack: bool,能否攻击其他玩家。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetAttackPlayersAbility(False)
SetBuildAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否放置方块,该接口的设置会存档,且只影响生存模式。
- 说明
- 示例
SetBuildAbility(canBuild: bool) -> bool
- canBuild: bool,能否放置方块。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetBuildAbility(False)
SetMineAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否摧毁方块,该接口的设置会存档,且只影响生存模式。
- 说明
- 示例
SetMineAbility(canMine: bool) -> bool
- canMine: bool,能否摧毁方块。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetMineAbility(False)
SetOpenContainersAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否打开容器。
- 说明
- 示例
SetOpenContainersAbility(canOpen: bool) -> bool
- canOpen: bool,能否打开容器。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetOpenContainersAbility(False)
SetOperateDoorsAndSwitchesAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否与门和开关交互。
- 说明
- 示例
SetOperateDoorsAndSwitchesAbility(canOperate: bool) -> bool
- canOperate: bool,能否与门和开关交互。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetOperateDoorsAndSwitchesAbility(False)
SetOperatorCommandAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家是否具有操作员命令权限。
- 说明
- 示例
SetOperatorCommandAbility(canOperate: bool) -> bool
- canOperate: bool,是否能发送操作员命令。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetOperatorCommandAbility(False)
SetPermissionLevel
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家权限等级。
- 说明
- 示例
SetPermissionLevel(level: int) -> bool
- level: int,权限等级,0 为访客、1 为成员、2 为操作员、3 为自定义。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetPermissionLevel(3)
SetPlayerMute
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家是否禁言,该接口的设置不存档。
- 说明
- 示例
SetPlayerMute(isMute: bool) -> bool
- isMute: bool,是否禁言。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetPlayerMute(True)
SetTeleportAbility
服务端
获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)
设置玩家能否使用 TP 指令。
- 说明
- 示例
SetTeleportAbility(canTeleport: bool) -> bool
- canTeleport: bool,能否使用 TP 指令。
返回值:bool,是否设置成功。
import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreatePlayer(playerId)
comp.SetTeleportAbility(False)