跳到主要内容

权限

适用版本:中国版 3.10。仅中国版可用。

本文主要记录权限相关的接口,共 12 个。

网易官方文档

GetPlayerAbilities​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

获取玩家具体权限。

GetPlayerAbilities() -> Dict[str, Any]

返回值:Dict[str, Any],具体权限,详见备注。

备注

  • 具体权限说明。
权限字段数据类型说明
buildbool放置方块
minebool采集方块
doorsandswitchesbool使用门和开关
opencontainersbool打开容器
attackplayersbool攻击玩家
attackmobsbool攻击生物
opbool操作员命令
teleportbool使用传送
  • 返回值示例。
{'teleport': True, 'opencontainers': True, 'mine': True, 'build': True, 'op': True, 'attackmobs': True, 'doorsandswitches': True, 'attackplayers': True}

GetPlayerOperation​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

获取玩家权限类型信息。

GetPlayerOperation() -> int

返回值:int,权限类型,Visitor 为 0,Member 为 1,Operator 为 2,Custom 为 3。


SetAttackMobsAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否攻击生物。

SetAttackMobsAbility(canAttack: bool) -> bool
  • canAttack: bool,能否攻击生物。

返回值:bool,是否设置成功。


SetAttackPlayersAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否攻击其他玩家。

SetAttackPlayersAbility(canAttack: bool) -> bool
  • canAttack: bool,能否攻击其他玩家。

返回值:bool,是否设置成功。


SetBuildAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否放置方块,该接口的设置会存档,且只影响生存模式。

SetBuildAbility(canBuild: bool) -> bool
  • canBuild: bool,能否放置方块。

返回值:bool,是否设置成功。


SetMineAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否摧毁方块,该接口的设置会存档,且只影响生存模式。

SetMineAbility(canMine: bool) -> bool
  • canMine: bool,能否摧毁方块。

返回值:bool,是否设置成功。


SetOpenContainersAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否打开容器。

SetOpenContainersAbility(canOpen: bool) -> bool
  • canOpen: bool,能否打开容器。

返回值:bool,是否设置成功。


SetOperateDoorsAndSwitchesAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否与门和开关交互。

SetOperateDoorsAndSwitchesAbility(canOperate: bool) -> bool
  • canOperate: bool,能否与门和开关交互。

返回值:bool,是否设置成功。


SetOperatorCommandAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家是否具有操作员命令权限。

SetOperatorCommandAbility(canOperate: bool) -> bool
  • canOperate: bool,是否能发送操作员命令。

返回值:bool,是否设置成功。


SetPermissionLevel​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家权限等级。

SetPermissionLevel(level: int) -> bool
  • level: int,权限等级,0 为访客、1 为成员、2 为操作员、3 为自定义。

返回值:bool,是否设置成功。


SetPlayerMute​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家是否禁言,该接口的设置不存档。

SetPlayerMute(isMute: bool) -> bool
  • isMute: bool,是否禁言。

返回值:bool,是否设置成功。


SetTeleportAbility​

服务端

该接口只能在服务端脚本(mod.server.extraServerApi)中调用。
PlayerCompServer

获取组件:serverApi.GetEngineCompFactory().CreatePlayer(playerId)

设置玩家能否使用 TP 指令。

SetTeleportAbility(canTeleport: bool) -> bool
  • canTeleport: bool,能否使用 TP 指令。

返回值:bool,是否设置成功。